Open in
Microsoft Dynamics 365 मधून कनेक्ट करा
X-headers वापरून तुमच्या SBC द्वारे Dynamics 365 Contact Center आणि Copilot Studio कॉल ThunderPhone एजंटकडे पाठवा आणि HTTP वरून एजंटच्या हँड-ऑफची माहिती शोधा.
Dynamics 365 Contact Center कॉलरला तुमच्या सेशन बॉर्डर कंट्रोलर (SBC) मार्फत एजंटकडे पाठवते, ज्यामध्ये संभाषण id सह पाचपर्यंत X-headers असतात. एजंटचे काम पूर्ण झाल्यावर तो कॉल संपवतो, तुमचा SBC कॉलरला Dynamics 365 मध्ये परत आणतो आणि HTTP Request नोड हस्तांतरण मिळवतो.
सुरू करण्यापूर्वी
- एक ThunderPhone एजंट आणि संस्थेची API की.
- Dynamics 365 Contact Center आवाज चॅनेल, तुम्ही चालवत असलेल्या SBC ला Azure Communication Services Direct Routing द्वारे जोडलेले (SBC आवश्यकता): सार्वजनिक प्रमाणपत्र असलेला समर्थित SBC, पोर्ट 5061 वर TLS 1.2 आणि Microsoft कडे SRTP.
- संभाषण हस्तांतरित करा नोडवर SIP X-header समर्थन (Copilot Studio). ते तुमच्या वातावरणात उपलब्ध असल्याची खात्री करा.
Dynamics 365 केवळ फोन नंबरवर हस्तांतरित करते आणि Microsoft Direct Routing चे प्रमाणीकरण पासवर्डने नव्हे, तर प्रमाणपत्राद्वारे करते. तुमचा 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 digest प्रमाणीकरण करू शकत नसल्यास, त्याऐवजी auth ला ip_allowlist आणि तुमच्या SBC चा सार्वजनिक पत्ता सेट करून एंडपॉइंट तयार करा; पहा
स्रोत IP द्वारे प्रमाणीकरण करणारे प्लॅटफॉर्म.
2. संदर्भासह कॉल पाठवा
- तुमच्या SBC वर एजंटसाठी फोन नंबर निवडा, उदाहरणार्थ
+14155550188. - SBC वर, त्या नंबरवरील कॉल एंडपॉइंटच्या
sip_uriकडे रूट करा, उदाहरणार्थ TLS द्वारे पोर्ट5061वरsip:agent-12-jhxmginwjx@sip.thunderphone.com. ThunderPhone वापरकर्ता भागावरून (agent-12-jhxmginwjx) एंडपॉइंट शोधते, जो विनंती URI आणिToहेडर दोन्हीमध्ये असणे आवश्यक आहे. X-headers मध्ये कोणताही बदल करू नका. - Copilot Studio मध्ये, त्या नंबरवर बाह्य फोन नंबर हस्तांतरण असलेला संभाषण हस्तांतरित करा नोड जोडा आणि X-headers जोडा:
X-Call-ID: Dynamics 365 संभाषण id. कोणत्याही Microsoft हेडरमध्ये ते नसते, म्हणून ते येथे जोडा; ThunderPhone ते कॉलच्याexternal_call_idम्हणून जतन करते. संभाषण id कोणत्या व्हेरिएबलमध्ये आहे ते Copilot Studio मध्ये निश्चित करा.- आणखी चारपर्यंत, उदाहरणार्थ
X-Customer-Tier.
Microsoft जास्तीत जास्त पाच X-headers पाठवते, ज्यांची नावे 64 वर्णांपर्यंत आणि मूल्ये 256 पर्यंत असतात; त्यात अक्षरे, अंक आणि = ; . ! % * _ + ~ - वापरले जातात. ते उपसर्ग लहान अक्षरांत x- म्हणून लिहिते; ThunderPhone हेडर नावे केसकडे दुर्लक्ष करून जुळवते, त्यामुळे x-customer-tier prompt पर्यंत {{sip_x_customer_tier}} म्हणून पोहोचते.
तुम्ही त्याऐवजी Azure Communication Services Call Automation वापरून कॉल तयार करत असल्यास, AddSipX डीफॉल्टनुसार X-MS-Custom- नावे लिहिते. X-Call-ID चे नाव कायम ठेवण्यासाठी
SipHeaderPrefix.X पास करा
(सानुकूल संदर्भ).
3. कॉल परत मिळवा
एजंट कॉल परत पाठवतो: तो निरोप घेऊन कॉल संपवतो. हा ट्रान्सफर क्रमांक जोडा (पहा ट्रान्सफर क्रमांक जोडा):
{"name": "Dynamics 365", "action": "return"}कॉल करणाऱ्या व्यक्तीला पुन्हा Dynamics 365 मध्ये आणणे हे तुमच्या SBC चे काम आहे. Microsoft
कॉन्टेक्स्टसह कॉलसाठी एक मार्ग दस्तऐवजीकरण करते: Dynamics 365 मध्ये नोंदणीकृत
क्रमांकावर SBC द्वारे नवीन कॉल, ज्यामध्ये तुम्ही वर्कस्ट्रीम्स → प्रगत सेटिंग्ज अंतर्गत
सेट केलेल्या कॉन्टेक्स्ट व्हेरिएबल्सशी जुळणाऱ्या की असलेला UUI असतो
(तृतीय-पक्ष IVR ट्रान्सफर).
ThunderPhone कॉल संपवल्यावर कॉल करणारी व्यक्ती त्या क्रमांकावर कशी पोहोचते हे तुमच्या SBC विक्रेत्यासोबत
ठरवा आणि तुम्ही X-Call-ID मध्ये पाठवलेला संभाषण आयडी सोबत ठेवा,
जेणेकरून प्रवाहाला कॉल शोधता येईल.
नंतर Copilot Studio मधील HTTP विनंती नोडने हस्तांतरणाची माहिती मिळवा:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=यानंतर संभाषण आयडी.- हेडर
Authorization: Bearer sk_live_…. - प्रतिसाद व्हेरिएबलमध्ये पार्स करा आणि
handoff.summaryवhandoff.intentवापरा.
पहा हस्तांतरित कॉल शोधा.
याची चाचणी करा
ट्रान्सफर नोडपर्यंत पोहोचणाऱ्या Dynamics 365 क्रमांकावर कॉल करा, एजंटकडे एखाद्या व्यक्तीशी
बोलण्याची विनंती करा आणि कॉल करणारी व्यक्ती पुन्हा Dynamics 365 मध्ये येते का ते तपासा. नंतर
GET /v1/calls/{call_id} ने कॉल उघडा: sip_headers मध्ये x-call-id सूचीबद्ध असावा आणि
external_call_id हा संभाषण आयडी असावा. कॉल कधीही एजंटपर्यंत पोहोचत नसेल आणि तुमच्या SBC लॉगमध्ये SIP
404 दिसत असेल, तर त्याच्या विनंती URI किंवा To हेडरमध्ये एंडपॉइंटचा वापरकर्ता भाग नाही.
मर्यादा
- SBC आवश्यक आहे. Microsoft SIP पत्ता डायल करू शकत नाही किंवा डाइजेस्ट चॅलेंजला उत्तर देऊ शकत नाही.
- Microsoft जास्तीत जास्त पाच X-हेडर्स पाठवते आणि येणाऱ्या कॉलवर फक्त पहिले पाच ठेवते. Dynamics 365 जास्तीत जास्त 128 वर्णांचा UUI स्वीकारते.
- Microsoft
BYEवरील हेडर्स वाचण्याचे दस्तऐवजीकरण करत नाही, त्यामुळे हस्तांतरणाची माहिती फक्त लुकअपद्वारेच परत येते.