Open in
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-IDCallSidلے جاتا ہے۔ Twilio اپنے کسی call-id ہیڈر کو دستاویز نہیں کرتا، اس لیے یہ شامل کریں: ThunderPhone اسے کال کےexternal_call_idکے طور پر محفوظ کرتا ہے۔{{CallSid}}TwiML Bin میں کام کرتا ہے؛ اپنے سرور سے، آنے والی درخواست کاCallSidلکھیں۔- اسی طریقے سے مزید سیاق شامل کریں، مثلاً
&X-Account-Id=12345۔ TwiML کے اندر&کو&کے طور پر لکھیں، کیونکہ اکیلا&غیر درست XML ہے۔ ہر ایک prompt تک ایک متغیر کے طور پر پہنچتا ہے، یہاں{{sip_x_account_id}}۔ Twiliox-ہیڈرز اورUser-to-Userکی اجازت دیتا ہے، فی صد انکوڈ شدہ صورت میں، جبکہ پورا URI 255 حروف سے کم اور ہیڈرز 1,024 سے کم ہوں۔ referUrlTwilio کو ایجنٹ کا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>کے ذریعے ڈائل کریں۔