Open in
Talkdesk سے منسلک کریں
Connect to Autopilot Voice کے ذریعے Talkdesk کالز کو ThunderPhone ایجنٹ کے پاس بھیجیں، اور UUI میں hand-off id کے ساتھ انہیں واپس ایسکیلیٹ کریں۔
آپ کا Talkdesk Studio فلو کالر کو تعامل کی آئی ڈی اور UUI کے ساتھ ایجنٹ کے پاس بھیجتا ہے۔ جب کالر کو کسی شخص کی ضرورت ہو، تو ایجنٹ SIP REFER کے ذریعے Talkdesk کو ایسکیلیٹ کرتا ہے، اور ہینڈ آف کی آئی ڈی ایک Studio ویری ایبل میں پہنچ جاتی ہے۔
شروع کرنے سے پہلے
- ایک ThunderPhone ایجنٹ اور تنظیم کی API کلید۔
- ایک Talkdesk کنورسیشن آرکیسٹریٹر لائسنس، جو ایکسٹرنل وائس اسٹریم موڈ میں Studio کے آٹو پائلٹ وائس سے کنیکٹ کریں جزو کا احاطہ کرتا ہے (Talkdesk کا مضمون)۔ Talkdesk اس وقت فی منٹ بل کرتا ہے جب ایجنٹ کال کو برقرار رکھتا ہے۔
1. SIP اینڈپوائنٹ بنائیں
Talkdesk صرف IP الاؤ لسٹ کی دستاویز فراہم کرتا ہے، اس لیے ایسا اینڈپوائنٹ بنائیں جو ماخذ کے پتے کے ذریعے کالز قبول کرے:
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": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'Talkdesk کے مضمون کے مطابق یہ SRTP پر آڈیو بھیجتا ہے، اور "srtp": "optional"
اس وقت SRTP قبول کرتا ہے جب Talkdesk اسے پیش کرے۔ مضمون میں یہ نہیں بتایا گیا کہ آیا Talkdesk
کو SRTP درکار ہے؛ اگر Talkdesk آپ کو بتائے کہ درکار ہے، تو srtp کو required پر سیٹ کریں، جو
اس کے بغیر کالز مسترد کرتا ہے۔
Talkdesk سے Talkdesk کی SIP سگنلنگ رینجز حاصل کریں۔ ہر رینج عوامی IPv4
رینج /16 یا اس سے زیادہ محدود ہونی چاہیے (IPv6 /48 یا اس سے زیادہ محدود)۔ دیکھیں
وہ پلیٹ فارمز جو ماخذ IP کے ذریعے تصدیق کرتے ہیں۔
Talkdesk Twilio کے نیٹ ورک سے SIP بھیجتا ہے، جس کے پتے ہر Twilio صارف کے ساتھ مشترک ہوتے ہیں،
اس لیے اینڈپوائنٹ کا پتہ ہی دوسرے کالرز کو باہر رکھتا ہے: اسے شائع نہ کریں۔
جواب کا sip_uri محفوظ رکھیں، مثال کے طور پر
sip:agent-12-jhxmginwjx@sip.thunderphone.com۔
2. سیاق کے ساتھ کالز بھیجیں
اپنے Studio فلو میں، ایکسٹرنل وائس
اسٹریم موڈ میں آٹو پائلٹ وائس سے کنیکٹ کریں شامل کریں اور اس کا ہدف اینڈپوائنٹ کے sip_uri پر ;transport=tls شامل کر کے سیٹ کریں، مثلاً
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls۔ اینڈپوائنٹ UDP پر آنے والی کالز مسترد کرتا ہے،
جسے Twilio کا SIP استعمال کرتا ہے جب تک اسے دوسری صورت میں نہ بتایا جائے۔
Talkdesk یہ بھیجتا ہے:
X-Talkdesk-Interaction-Id، جو کال کےexternal_call_idکے طور پر محفوظ ہوتا ہے؛User-to-User، ہیکساڈیسیمل میں انکوڈ شدہ، جیسےbusiness_hours=open۔ یہ ڈی کوڈ ہو کر پرامپٹ تک{{sip_uui}}کے طور پر پہنچتا ہے۔
جزو کا ورژن 2.1 متعین ہیڈرز بھی بھیج سکتا ہے۔ Talkdesk کا ترجیحات کا صفحہ انہیں WebSocket کے ذریعے بھیجا جانے والا JSON بیان کرتا ہے، اس لیے ان پر انحصار کرنے سے پہلے Talkdesk سے تصدیق کریں کہ آیا وہ SIP ہیڈرز کے طور پر پہنچتے ہیں۔
3. کال واپس حاصل کریں
ایجنٹ Talkdesk کے ایسکلیشن پتے پر REFER کے ذریعے ایسکلیٹ کرتا ہے، جس میں
ہینڈ آف id اسی پتے کے اندر hex UUI کے طور پر ہوتی ہے، کیونکہ Talkdesk اسے صرف
وہیں پڑھتا ہے۔ یہ ٹرانسفر نمبر شامل کریں (ملاحظہ کریں
ٹرانسفر نمبر شامل کریں
اور ٹرانسفر پتے کے اندر ہیڈرز):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}یہ پتہ Talkdesk کے مضمون میں دیا گیا ہے۔ کمپوننٹ کا ورژن 2.1
autopilot_result= پڑھتا ہے؛ ورژن 1.7 escalate_to= پڑھتا ہے، اس لیے 1.7 پر
یہ کلید استعمال کریں۔ REFER اس طرح ہوتا ہے:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk اس قدر کو Studio ویری ایبل میں رکھتا ہے۔ خلاصہ اور مقصد حاصل کرنے کے لیے، Connections کے ساتھ بنائے گئے حسب ضرورت انٹیگریشن میں ایکشن چلائیں کا مرحلہ شامل کریں:
- Auth قسم API کلید، ہیڈر کا نام
Authorization، قدرBearer sk_live_…۔ - درخواست:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=کے بعد ویری ایبل سے id شامل کریں۔ آپ interaction id کے ساتھexternal_call_idکے ذریعے بھی کال تلاش کر سکتے ہیں۔ handoff.intentکے مطابق روٹ کریں، اور کال لینے والے شخص کوhandoff.summaryدکھائیں۔
ملاحظہ کریں ہینڈ آف کی گئی کال تلاش کریں۔
اس کی جانچ کریں
Studio فلو کے ذریعے کال شروع کریں، ایجنٹ سے کسی شخص کو مانگیں، اور تصدیق کریں
کہ فلو کمپوننٹ کے بعد اپنے ویری ایبل میں ہینڈ آف id کے ساتھ جاری رہتا ہے۔ پھر
کال کو GET /v1/calls/{call_id} سے کھولیں:
external_call_id کو Talkdesk interaction id ہونا چاہیے۔
حدود
- Talkdesk زیادہ سے زیادہ 256 بائٹس کا UUI پڑھتا ہے اور
|یا;سے الگ کی گئی قدروں کی اجازت نہیں دیتا، اس لیے ایک ہی قدر بھیجیں۔ ہینڈ آف id اس میں سما جاتی ہے۔ - Talkdesk کے APIs ایجنٹ کا ٹرانسکرپٹ نہیں پڑھ سکتے۔ اس کے بجائے ہینڈ آف تلاش
یا
GET /v1/calls/{call_id}استعمال کریں۔