Open in
Zoom Contact Center سے کنیکٹ کریں
تیسرے فریق کے وائس بوٹ کنیکٹر کے ذریعے Zoom Contact Center کی کالز ThunderPhone ایجنٹ کو بھیجیں، اور SIP REFER کے ذریعے انہیں واپس انسانی ایجنٹ کو منتقل کریں۔
آپ کے Zoom Contact Center فلو میں ایک بوٹ ویجیٹ کالر کو Zoom کے کال SID کے ساتھ ایجنٹ کے پاس بھیجتا ہے۔ جب کالر کو کسی شخص کی ضرورت ہو، تو ایجنٹ Zoom کے انسانی ایجنٹ کے پتے پر ایک SIP REFER بھیجتا ہے، اور آپ کا فلو کال SID کے ذریعے منتقلی حاصل کرتا ہے۔
شروع کرنے سے پہلے
- ایک ThunderPhone ایجنٹ اور ایک تنظیم کی API کلید۔
- ایک Zoom Marketplace عمومی ایپ، جسے آپ کا منتظم منظم کرے اور Contact Center کے لیے دستیاب بنائے، اور جس میں بوٹ ویجیٹ کے لیے کنیکٹر ہو (Zoom کی تیسرے فریق کے وائس بوٹ کی رہنمائی)۔
- Zoom سے بوٹ فراہم کنندہ تک ایک SIP ٹرنک۔ Zoom کی ISV ٹیم اسے مراحل میں بناتی ہے (دریافت، ایک اسٹیجنگ ٹرنک، پھر پروڈکشن)، اور ایپ کا کمپنی نام ٹرنک ریکارڈ سے بالکل مطابقت رکھنا چاہیے۔ یہ سیٹ اپ صرف آپ کے Zoom اکاؤنٹ میں نہیں، بلکہ ThunderPhone سپورٹ اور Zoom کے ساتھ شروع ہوتا ہے۔
1. SIP اینڈ پوائنٹ بنائیں
Zoom کا کنیکٹر SIP پتے کے بجائے 999 سے شروع ہونے والے 15 ہندسوں کے نمبر پر
ڈائل کرتا ہے۔ کنیکٹر محفوظ کرنے سے یہ نمبر بنتا ہے۔ Zoom کا ٹرنک آڈیو کے لیے
SRTP کے ساتھ پورٹ 5061 پر TLS 1.2 استعمال کرتا ہے، اور پاس ورڈ کے بجائے Zoom کے
سب نیٹس کے ذریعے اجازت فہرست میں شامل ہوتا ہے۔ اس لیے کنیکٹر کے نمبر کو ڈائل اِن
نمبر کے طور پر اور SRTP کو لازمی رکھتے ہوئے ایک ip_allowlist اینڈ پوائنٹ بنائیں
(دیکھیں
وہ پلیٹ فارمز جو فون نمبر پر ڈائل کرتے ہیں):
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": "Zoom Contact Center",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["999123456789012"],
"srtp": "required"
}'allowed_source_cidrs: Zoom سے حاصل کردہ Zoom کے SIP سگنلنگ سب نیٹس۔ ہر ایک عوامی IPv4 رینج/16یا اس سے زیادہ محدود ہونی چاہیے (IPv6/48یا اس سے زیادہ محدود)۔dial_in_numbers: کنیکٹر کا نمبر بالکل اسی طرح جیسے Zoom اسے بھیجتا ہے، کسی+کے بغیر۔srtp:required، کیونکہ Zoom کا ٹرنک ہمیشہ SRTP استعمال کرتا ہے۔
Zoom کے پتے اس کے تمام صارفین کے درمیان مشترک ہیں، اس لیے Zoom کا کوئی دوسرا صارف جو اس نمبر پر ڈائل کرے گا آپ کے ایجنٹ تک پہنچے گا۔ Zoom نمبر تفویض کرتا ہے؛ اسے شائع نہ کریں۔
2. سیاق کے ساتھ کالز بھیجیں
اپنے فلو میں ایک بوٹ ویجیٹ شامل کریں اور اسے کنیکٹر سے منسلک کریں۔ Zoom کی ISV
ٹیم سے کہیں کہ وہ ٹرنک کو sip.thunderphone.com پر، پورٹ 5061 پر TLS کے ساتھ،
ریکویسٹ URI اور To ہیڈر دونوں میں کنیکٹر کے نمبر کے ساتھ ترتیب دے۔ اینڈ پوائنٹ
UDP کو مسترد کرتا ہے، اس لیے یقینی بنائیں کہ ٹرنک اس پر واپس نہ جائے۔
Zoom یہ بھیجتا ہے:
X-ZOOM-Call-Sid، جو کال کےexternal_call_idکے طور پر محفوظ ہوتا ہے۔ Zoom کے اپنے ڈیٹا میپنگ صفحے میں یہ درج نہیں ہے؛ ایک دوسرے AI فراہم کنندہ کی Zoom انٹیگریشن میں اس کی دستاویز موجود ہے، اس لیے اپنی پہلی آزمائشی کال میں اسے چیک کریں۔X-ZOOM-DNIS، وہ نمبر جس پر کالر نے ڈائل کیا، بطور{{sip_x_zoom_dnis}}۔X-ZOOM-WEBHOOK، کنیکٹر کا جامد URL۔
3. کال واپس حاصل کریں
ایجنٹ Zoom کے SBC پر انسانی ایجنٹ کے پتے کو ایک REFER بھیجتا ہے۔ Zoom کی جانب سے دیا گیا SBC پتہ استعمال کرتے ہوئے یہ
منتقلی نمبر شامل کریں (دیکھیں
منتقلی نمبر شامل کریں):
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoom کی گائیڈ میں دو طریقے بیان کیے گئے ہیں جن سے بوٹ سیاق منتقل کرتا ہے: REFER سے پہلے
کنیکٹر کے اسٹاٹک URL پر ایک POST (voicebot_metadata اور ملتے جلتے
ایونٹس)، اور Bot سے آنے والی کے تحت میپ کیے گئے SIP ہیڈرز۔ ThunderPhone
اسٹاٹک URL پر پوسٹ نہیں کرتا۔ Zoom کی گائیڈ یہ نہیں بتاتی کہ آیا وہ
REFER سے میپ کیے گئے ہیڈرز پڑھتا ہے؛ اگر آپ آزمانا چاہتے ہیں تو اندراج میں
"X-Handoff-Id": "{{handoff_id}}" جیسے headers شامل کریں اور ٹیسٹ کال پر جانچیں۔ نیز
Zoom سے تصدیق کریں کہ وہ اس سے پہلے میٹا ڈیٹا POST کے بغیر REFER قبول کرتا ہے۔
ان میں سے کسی پر انحصار کیے بغیر ہینڈ آف حاصل کرنے کے لیے، اپنے فلو میں Bot ویجٹ کے بعد اسے HTTP کال یا اسکرپٹ ویجٹ کے ذریعے تلاش کروائیں:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=جس کے بعد کال sid ہو۔- ہیڈر
Authorization: Bearer sk_live_…۔ - کالر کو روٹ کرنے اور کال لینے والے شخص کو مختصر بریفنگ دینے کے لیے
handoff.summaryاورhandoff.intentاستعمال کریں۔
Zoom ان ویجٹس کے لیے فیلڈ کی سطح کی دستاویزات شائع نہیں کرتا، اس لیے اپنے
اکاؤنٹ میں تصدیق کریں کہ ویجٹ Authorization ہیڈر بھیج سکتا ہے۔ دیکھیں
منتقل کی گئی کال تلاش کریں۔
اس کی جانچ کریں
ایسے نمبر پر کال کریں جو Bot ویجٹ تک پہنچتا ہو، ایجنٹ سے کسی شخص سے بات کرنے کو کہیں، اور جانچیں
کہ کالر انسانی ایجنٹ تک پہنچتا ہے اور ویجٹ ہینڈ آف واپس کرتا ہے۔ پھر
GET /v1/calls/{call_id} کے ساتھ کال کھولیں: sip_headers میں
x-zoom-call-sid درج ہونا چاہیے، اور external_call_id اس کال sid سے مطابقت رکھنا چاہیے جسے آپ کا فلو
استعمال کرتا ہے۔
حدود
- ThunderPhone کنیکٹر کے اسٹاٹک URL پر پوسٹ نہیں کرتا، اس لیے Zoom کو
ہینڈ آف تلاش کے ذریعے ملتا ہے، یا میپ کیے گئے ہیڈرز کے ذریعے اگر آپ کا ٹیسٹ دکھائے کہ
Zoom انہیں
REFERسے پڑھتا ہے۔ - ٹرنک Zoom کی ISV ٹیم بناتی ہے، اس لیے آپ اسے خود سیٹ اپ یا ٹیسٹ نہیں کر سکتے۔