ThunderPhone v3 اب لائیو ہے۔سیلف سرو، قیمت 2¢ فی منٹ سے شروع۔اعلان پڑھیں

Contact centers

Twilio سے کنیکٹ کریں

CallSid کے ساتھ Twilio کالز کو SIP کے ذریعے 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 سے کالز قبول کرنے کے لیے بھی، ماخذ IPs محدود کریں دیکھیں۔

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 پورا ایڈریس آپ کے referUrl کو ReferTransferTarget کے طور پر بھیجتا ہے، مثال کے طور پر <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>۔ آپ کا ہینڈلر اس سے ہیڈرز پڑھتا ہے اور اس جگہ کے لیے TwiML واپس کرتا ہے جہاں کالر کو آگے جانا ہے۔ ایڈریس کا صارف حصہ (support) آپ اپنی مرضی سے منتخب کر سکتے ہیں، اس لیے آپ ہر منزل کے لیے ایک ٹرانسفر نمبر شامل کر کے اس کی بنیاد پر روٹ کر سکتے ہیں۔

یہ Twilio Function کالر کو ہینڈ آف کو ٹاسک خصوصیات کے طور پر شامل کرتے ہوئے Flex میں قطار میں ڈالتا ہے اور ہینڈ آف id کے ذریعے خلاصہ تلاش کرتا ہے۔ تلاش Function میں چلتی ہے کیونکہ Studio کا HTTP Request ویجٹ 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);
};

API کلید کو Function کے ماحول کے متغیرات میں رکھیں۔ دیگر فیلڈز کے لیے ہینڈ آف کی گئی کال تلاش کریں دیکھیں۔

اس کی جانچ کریں

ایسے Twilio نمبر پر کال کریں جو اوپر دیا گیا TwiML واپس کرتا ہو، ایجنٹ سے کسی شخص کے لیے کہیں، اور تصدیق کریں کہ آپ کے referUrl ہینڈلر کو دونوں ہیڈرز کے ساتھ ReferTransferTarget ملتا ہے اور کالر قطار تک پہنچتا ہے۔ پھر GET /v1/calls/{call_id} کے ذریعے کال کھولیں: external_call_id کو CallSid ہونا چاہیے۔

حدود

  • Twilio Refer-To کو 256 حروف تک محدود کرتا ہے۔ ThunderPhone ایڈریس کو 254 حروف تک رکھتا ہے اور جو ہیڈر فٹ نہ ہو اسے چھوڑ دیتا ہے، اس لیے ہیڈر کے نام اور اقدار مختصر رکھیں۔
  • Twilio BYE پر ہیڈرز پڑھنے کی دستاویز فراہم نہیں کرتا، اس لیے واپسی ٹرانسفر ہینڈ آف کو واپس Twilio تک نہیں لے جا سکتی۔ اوپر کی طرح REFER استعمال کریں۔
  • Twilio <Conference> یا <Queue> کے ذریعے منسلک کال پر REFER قبول نہیں کرتا، اس لیے اوپر کی طرح ایجنٹ کو <Dial><Sip> کے ذریعے ڈائل کریں۔