ThunderPhone v3 এখন লাইভ।নিজেই ব্যবহার শুরু করুন, 2¢/মিনিট থেকে।ঘোষণাটি পড়ুন

Contact centers

Twilio থেকে সংযোগ করুন

CallSid ব্যবহার করে SIP-এর মাধ্যমে Twilio কল একটি ThunderPhone এজেন্টে পাঠান এবং ট্রান্সফার ঠিকানায় হ্যান্ড-অফসহ আপনার referUrl-এর মাধ্যমে সেগুলো ফিরিয়ে নিন।

আপনার TwiML একটি হেডারে কলের CallSid সহ এজেন্টের SIP ঠিকানায় ডায়াল করে। কলারের কোনো ব্যক্তির প্রয়োজন হলে, এজেন্ট একটি SIP REFER পাঠায়, Twilio হ্যান্ড-অফসহ ট্রান্সফার ঠিকানাটি আপনার referUrl হ্যান্ডলারে পাঠায়, এবং আপনার হ্যান্ডলার যে TwiML ফিরিয়ে দেয় তা নির্ধারণ করে কলার কোথায় যাবে, যেমন একটি Flex কিউতে।

শুরু করার আগে

  • একটি ThunderPhone এজেন্ট এবং একটি প্রতিষ্ঠান API কী।
  • Twilio Programmable Voice, এবং TwiML ও একটি referUrl হ্যান্ডলার পরিবেশন করার জায়গা: আপনার নিজস্ব সার্ভার, অথবা একটি TwiML Bin ও একটি Twilio Function। Flex ঐচ্ছিক।

1. SIP এন্ডপয়েন্ট তৈরি করুন

Twilio-এর <Sip> একটি ব্যবহারকারীর নাম ও পাসওয়ার্ড গ্রহণ করে, তাই একটি স্ট্যান্ডার্ড এন্ডপয়েন্ট ব্যবহার করুন:

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Twilio"}'

উত্তর থেকে পাওয়া password সঙ্গে সঙ্গে সংরক্ষণ করুন; এটি একবারই দেখানো হয়। শুধু Twilio থেকে কল গ্রহণ করতে চাইলে, দেখুন উৎস IP সীমিত করুন।

2. প্রসঙ্গসহ কল পাঠান

এজেন্টের কাছে যে কলটি পাঠাতে চান, তার জন্য এই TwiML ফেরত দিন:

<Response>
  <Dial answerOnBridge="true" referUrl="https://YOUR_SERVER/thunderphone-refer">
    <Sip username="tp409667538f83" password="YOUR_ENDPOINT_PASSWORD">sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls?X-Call-ID={{CallSid}}</Sip>
  </Dial>
</Response>
  • ;transport=tls গুরুত্বপূর্ণ: অন্যথায় নির্দেশ না দিলে Twilio UDP ব্যবহার করে।
  • X-Call-ID CallSid বহন করে। Twilio নিজস্ব কোনো call-id হেডার নথিভুক্ত করে না, তাই এটি যোগ করুন: ThunderPhone এটিকে কলের external_call_id হিসেবে সংরক্ষণ করে। {{CallSid}} একটি TwiML Bin-এ কাজ করে; আপনার নিজস্ব সার্ভার থেকে হলে, ইনকামিং অনুরোধের CallSid লিখুন।
  • একইভাবে আরও প্রসঙ্গ যোগ করুন, যেমন &amp;X-Account-Id=12345। TwiML-এর মধ্যে &-কে &amp; হিসেবে লিখুন, কারণ সাধারণ & বৈধ XML নয়। প্রতিটি prompt-এ একটি ভেরিয়েবল হিসেবে পৌঁছায়, এখানে {{sip_x_account_id}}। Twilio x- হেডার এবং User-to-User অনুমতি দেয়, যা শতাংশ-এনকোডেড থাকে; সম্পূর্ণ URI 255 অক্ষরের নিচে এবং হেডারগুলো 1,024-এর নিচে হতে হবে।
  • referUrl Twilio-কে এজেন্টের REFER গ্রহণ করতে দেয়; এটি ছাড়া ট্রান্সফার ত্রুটি 13802-সহ ব্যর্থ হয়। answerOnBridge="true" নতুন গন্তব্য উত্তর না দেওয়া পর্যন্ত কলারকে সংযুক্ত রাখে, ফলে ব্যর্থ ট্রান্সফারে ফলব্যাক করা যায়।

Studio-এর কল এতে সংযুক্ত করুন উইজেট কাস্টম হেডার বা referUrl নথিভুক্ত করে না, তাই Studio থেকে কলটি এই TwiML-এ পাঠান, উদাহরণস্বরূপ একটি TwiML পুনর্নির্দেশ উইজেট দিয়ে।

3. কলটি ফিরে পান

এজেন্ট একটি REFER দিয়ে ট্রান্সফার করে, যার ট্রান্সফার ঠিকানায় হ্যান্ড-অফ id এবং intent থাকে। এই ট্রান্সফার নম্বরটি যোগ করুন (দেখুন ট্রান্সফার নম্বর যোগ করুন এবং ট্রান্সফার ঠিকানার ভেতরের হেডার):

{
  "name": "Twilio support",
  "number": "sip:support@acme.sip.twilio.com",
  "headers": {"X-Handoff-Id": "{{handoff_id}}", "X-Handoff-Intent": "{{handoff_intent}}"},
  "headers_in_uri": true
}

Twilio সম্পূর্ণ ঠিকানাটি ReferTransferTarget হিসেবে আপনার referUrl-এ পাঠায়, উদাহরণস্বরূপ <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>। আপনার হ্যান্ডলার এটি থেকে হেডারগুলো পড়ে এবং কলার পরবর্তী কোথায় যাবে তার জন্য TwiML ফেরত দেয়। ঠিকানার user অংশটি (support) আপনি পছন্দমতো নির্ধারণ করতে পারেন, তাই প্রতিটি গন্তব্যের জন্য একটি করে ট্রান্সফার নম্বর যোগ করে সেটির ভিত্তিতে রাউট করতে পারেন।

এই Twilio Function হ্যান্ড-অফটিকে task attributes হিসেবে রেখে কলারকে Flex-এ কিউতে যোগ করে এবং হ্যান্ড-অফ id দিয়ে সারাংশ খুঁজে বের করে। এই লুকআপটি একটি Function-এ চলে, কারণ Studio-এর HTTP Request widget Authorization হেডার পাঠাতে পারে না:

exports.handler = async (context, event, callback) => {
  const target = (event.ReferTransferTarget || "").replace(/^<|>$/g, "");
  const params = new URLSearchParams(target.split("?")[1] || "");
  const handoffId = params.get("X-Handoff-Id") || "";
  const attributes = { handoff_id: handoffId, intent: params.get("X-Handoff-Intent") || "" };
 
  if (handoffId) {
    const response = await fetch(
      "https://api.thunderphone.com/v1/calls/handoff?handoff_id=" + encodeURIComponent(handoffId),
      { headers: { Authorization: "Bearer " + context.THUNDERPHONE_API_KEY } }
    );
    if (response.ok) {
      const call = await response.json();
      attributes.summary = (call.handoff && call.handoff.summary) || "";
    }
  }
 
  const twiml = new Twilio.twiml.VoiceResponse();
  twiml.enqueue({ workflowSid: context.FLEX_WORKFLOW_SID }).task({}, JSON.stringify(attributes));
  callback(null, twiml);
};

Function-এর environment variables-এ API key রাখুন। অন্যান্য ফিল্ডের জন্য হ্যান্ড-অফ করা কল খুঁজে দেখুন দেখুন।

এটি পরীক্ষা করুন

উপরের TwiML ফেরত দেয় এমন একটি Twilio নম্বরে কল করুন, এজেন্টের কাছে একজন ব্যক্তির জন্য অনুরোধ করুন, এবং নিশ্চিত করুন যে আপনার referUrl হ্যান্ডলার উভয় হেডারসহ ReferTransferTarget পাচ্ছে ও কলার কিউতে পৌঁছাচ্ছে। তারপর GET /v1/calls/{call_id} দিয়ে কলটি খুলুন: external_call_id-এ CallSid থাকা উচিত।

সীমাবদ্ধতা

  • Twilio Refer-To-কে 256 অক্ষরে সীমাবদ্ধ রাখে। ThunderPhone ঠিকানাটি 254 অক্ষরের মধ্যে রাখে এবং না-ধরা কোনো হেডার বাদ দেয়, তাই হেডারের নাম ও মান ছোট রাখুন।
  • Twilio একটি BYE-এ হেডার পড়ার বিষয়টি নথিভুক্ত করেনি, তাই রিটার্নের মাধ্যমে হ্যান্ড-অফ আবার Twilio-তে ফেরত নেওয়া যায় না। উপরের মতো REFER ব্যবহার করুন।
  • <Conference> বা <Queue>-এর মাধ্যমে সংযুক্ত কলে Twilio একটি REFER গ্রহণ করে না, তাই উপরের মতো <Dial><Sip> দিয়ে এজেন্টকে ডায়াল করুন।