Open in
Microsoft Dynamics 365 سے مربوط کریں
Dynamics 365 Contact Center اور Copilot Studio کی کالز کو اپنے SBC کے ذریعے X-headers کے ساتھ ThunderPhone ایجنٹ کو بھیجیں، اور HTTP کے ذریعے ایجنٹ کے ہینڈ آف کو تلاش کریں۔
Dynamics 365 Contact Center کال کرنے والے کو آپ کے سیشن بارڈر کنٹرولر (SBC) کے ذریعے ایجنٹ تک بھیجتا ہے، جس میں گفتگو ID سمیت زیادہ سے زیادہ پانچ X-ہیڈرز ہوتے ہیں۔ جب ایجنٹ مکمل کر لیتا ہے، تو وہ کال منقطع کر دیتا ہے، آپ کا SBC کال کرنے والے کو دوبارہ Dynamics 365 میں لے آتا ہے، اور ایک HTTP Request نوڈ منتقلی کی تفصیل حاصل کرتا ہے۔
شروع کرنے سے پہلے
- ایک ThunderPhone ایجنٹ اور تنظیم کی API کلید۔
- Dynamics 365 Contact Center وائس چینل، جو Azure Communication Services براہِ راست روٹنگ کے ذریعے آپ کے چلائے ہوئے SBC سے منسلک ہو (SBC کے تقاضے): عوامی سرٹیفکیٹ کے ساتھ ایک معاون SBC، پورٹ 5061 پر TLS 1.2، اور Microsoft کی سمت SRTP۔
- SIP X-ہیڈر سپورٹ، گفتگو منتقل کریں نوڈ پر (Copilot Studio)۔ تصدیق کریں کہ یہ آپ کے ماحول میں دستیاب ہے۔
Dynamics 365 صرف فون نمبر پر منتقل کرتا ہے، اور Microsoft براہِ راست روٹنگ کی توثیق پاس ورڈ سے نہیں بلکہ سرٹیفکیٹ سے کرتا ہے۔ آپ کا SBC Microsoft اور ThunderPhone کے درمیان ہوتا ہے اور اس نمبر کو ایجنٹ کے SIP پتے میں تبدیل کرتا ہے۔
1. SIP اینڈپوائنٹ بنائیں
کال آپ کے SBC سے ThunderPhone تک پہنچتی ہے، اس لیے SBC کے استعمال کے لیے ایک معیاری اینڈپوائنٹ بنائیں:
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": "Dynamics 365 SBC"}'جواب سے password فوراً محفوظ کریں؛ یہ صرف ایک بار دکھایا جاتا ہے، اور آپ کا SBC اسی سے ThunderPhone کے چیلنج کا جواب دیتا ہے۔ اگر آپ کا SBC ڈائجسٹ توثیق نہیں کر سکتا، تو اس کے بجائے auth کو ip_allowlist پر سیٹ کر کے اور اپنے SBC کا عوامی پتہ دے کر اینڈپوائنٹ بنائیں؛
وہ پلیٹ فارمز جو ماخذ IP سے توثیق کرتے ہیں دیکھیں۔
2. سیاق کے ساتھ کالز بھیجیں
- اپنے SBC پر ایجنٹ کے لیے ایک فون نمبر منتخب کریں، مثلاً
+14155550188۔ - SBC پر، اس نمبر کی کالز کو اینڈپوائنٹ کے
sip_uriپر روٹ کریں، مثلاًsip:agent-12-jhxmginwjx@sip.thunderphone.com، پورٹ5061پر TLS کے ذریعے۔ ThunderPhone صارف کے حصے (agent-12-jhxmginwjx) سے اینڈپوائنٹ تلاش کرتا ہے، جو ریکویسٹ URI اورToہیڈر دونوں میں ہونا ضروری ہے۔ X-ہیڈرز کو بغیر تبدیلی کے منتقل کریں۔ - Copilot Studio میں، بیرونی فون نمبر پر منتقلی کے ساتھ ایک گفتگو منتقل کریں نوڈ شامل کریں، اور X-ہیڈرز شامل کریں:
X-Call-ID: Dynamics 365 گفتگو ID۔ Microsoft کا کوئی ہیڈر اسے نہیں رکھتا، اس لیے اسے یہاں شامل کریں؛ ThunderPhone اسے کال کےexternal_call_idکے طور پر محفوظ کرتا ہے۔ Copilot Studio میں تصدیق کریں کہ کون سا متغیر گفتگو ID رکھتا ہے۔- مزید زیادہ سے زیادہ چار، مثلاً
X-Customer-Tier۔
Microsoft زیادہ سے زیادہ پانچ X-ہیڈرز بھیجتا ہے، جن کے نام 64 حروف تک اور قدریں 256 تک ہو سکتی ہیں، اور ان میں حروف، ہندسے اور = ; . ! % * _ + ~ - استعمال ہوتے ہیں۔ یہ سابقہ چھوٹے حروف میں x- لکھتا ہے؛ ThunderPhone ہیڈر ناموں کو بڑے یا چھوٹے حروف کے فرق کے بغیر ملاتا ہے، اس لیے x-customer-tier prompt میں {{sip_x_customer_tier}} کے طور پر پہنچتا ہے۔
اگر آپ اس کے بجائے Azure Communication Services Call Automation کے ساتھ کال بناتے ہیں، تو AddSipX بطور ڈیفالٹ X-MS-Custom- نام لکھتا ہے۔ SipHeaderPrefix.X پاس کریں تاکہ X-Call-ID اپنا نام برقرار رکھے
(حسب ضرورت سیاق)۔
3. کال واپس حاصل کریں
ایجنٹ کال واپس منتقل کرتا ہے: الوداع کہتا ہے اور کال ختم کر دیتا ہے۔ یہ ٹرانسفر نمبر شامل کریں (دیکھیں ٹرانسفر نمبر شامل کریں):
{"name": "Dynamics 365", "action": "return"}کالر کو دوبارہ Dynamics 365 میں لانا آپ کے SBC کا کام ہے۔ Microsoft
سیاق کے ساتھ کال کے لیے ایک طریقہ دستاویز کرتا ہے: SBC کے ذریعے ایک نئی کال جو
Dynamics 365 میں رجسٹرڈ نمبر پر جائے، اور UUI جس کی keys ان سیاقی متغیرات سے مطابقت رکھتی ہوں
جو آپ نے ورک اسٹریمز → اعلیٰ ترتیبات کے تحت ترتیب دیے ہیں
(فریق ثالث IVR ٹرانسفر)۔
اپنے SBC وینڈر کے ساتھ طے کریں کہ ThunderPhone کے کال ختم کرنے پر
کالر اس نمبر تک کیسے پہنچتا ہے، اور وہ گفتگو کی ID جو آپ نے X-Call-ID
میں بھیجی تھی ساتھ رکھیں تاکہ فلو کال کو تلاش کر سکے۔
پھر Copilot Studio کے HTTP درخواست نوڈ کے ذریعے منتقلی کی معلومات حاصل کریں:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=کے بعد گفتگو کی ID شامل کریں۔- ہیڈر
Authorization: Bearer sk_live_…۔ - جواب کو ایک متغیر میں parse کریں اور
handoff.summaryاورhandoff.intentاستعمال کریں۔
دیکھیں منتقل کی گئی کال تلاش کریں۔
اس کی جانچ کریں
ایسے Dynamics 365 نمبر پر کال کریں جو ٹرانسفر نوڈ تک پہنچتا ہو، ایجنٹ سے کسی
انسانی نمائندے کے لیے کہیں، اور تصدیق کریں کہ کالر دوبارہ Dynamics 365 میں آتا ہے۔ پھر
GET /v1/calls/{call_id} کے ذریعے کال کھولیں: sip_headers میں x-call-id درج ہونا چاہیے، اور
external_call_id گفتگو کی ID ہونی چاہیے۔ اگر کال کبھی ایجنٹ تک نہ پہنچے اور آپ کے SBC کے لاگز میں SIP 404 ہو، تو اس کی request URI یا To ہیڈر میں
اینڈ پوائنٹ کا صارف حصہ موجود نہیں ہے۔
حدود
- SBC ضروری ہے۔ Microsoft کسی SIP ایڈریس پر ڈائل نہیں کر سکتا یا ڈائجسٹ چیلنج کا جواب نہیں دے سکتا۔
- Microsoft زیادہ سے زیادہ پانچ X-ہیڈرز بھیجتا ہے، اور آنے والی کال پر صرف پہلے پانچ رکھتا ہے۔ Dynamics 365 زیادہ سے زیادہ 128 حروف کا UUI قبول کرتا ہے۔
- Microsoft
BYEپر ہیڈرز پڑھنے کی دستاویز نہیں کرتا، اس لیے منتقلی کی معلومات صرف lookup کے ذریعے واپس آتی ہیں۔