Open in
Microsoft Dynamics 365માંથી કનેક્ટ કરો
X-headers સાથે તમારા SBC મારફતે Dynamics 365 Contact Center અને Copilot Studio કૉલ્સને ThunderPhone એજન્ટ સુધી મોકલો અને HTTP દ્વારા એજન્ટનું હેન્ડ-ઓફ શોધો.
Dynamics 365 Contact Center કૉલરને તમારા session border controller (SBC) મારફતે એજન્ટ સુધી મોકલે છે, જેમાં conversation ID સહિત વધુમાં વધુ પાંચ X-headers હોય છે. એજન્ટનું કાર્ય પૂર્ણ થાય ત્યારે તે કૉલ ડિસ્કનેક્ટ કરે છે, તમારું SBC કૉલરને ફરી Dynamics 365 પર લાવે છે, અને HTTP Request નોડ હેન્ડ-ઓફ મેળવે છે.
શરૂ કરતાં પહેલાં
- એક ThunderPhone એજન્ટ અને એક સંસ્થાની API કી.
- Dynamics 365 Contact Center voice channel, જે તમે ચલાવતા SBC સાથે Azure Communication Services ડાયરેક્ટ રાઉટિંગ દ્વારા જોડાયેલ હોય (SBC આવશ્યકતાઓ): જાહેર સર્ટિફિકેટ ધરાવતું સમર્થિત SBC, પોર્ટ 5061 પર TLS 1.2 અને Microsoft તરફ SRTP.
- SIP X-header સપોર્ટ વાતચીત ટ્રાન્સફર કરો નોડ પર (Copilot Studio). તે તમારા environment માં ઉપલબ્ધ છે તેની પુષ્ટિ કરો.
Dynamics 365 ફક્ત ફોન નંબર પર ટ્રાન્સફર કરે છે, અને Microsoft Direct Routing ને password દ્વારા નહીં પરંતુ સર્ટિફિકેટ દ્વારા authenticate કરે છે. તમારું SBC Microsoft અને ThunderPhone વચ્ચે રહે છે અને તે નંબરને એજન્ટના SIP સરનામામાં ફેરવે છે.
1. SIP endpoint બનાવો
કૉલ તમારા SBCમાંથી ThunderPhone સુધી પહોંચે છે, તેથી SBC ઉપયોગ કરી શકે તે માટે એક standard endpoint બનાવો:
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"}'response માંથી password તરત જ સંગ્રહિત કરો; તે એક જ વાર દર્શાવવામાં આવે છે, અને તમારું SBC તેની મદદથી ThunderPhoneના challenge નો જવાબ આપે છે. જો તમારું SBC digest authentication કરી શકતું ન હોય, તો તેના બદલે auth ને ip_allowlist પર સેટ કરીને અને તમારા SBCનું જાહેર સરનામું આપીને endpoint બનાવો; જુઓ
સ્રોત IP દ્વારા authenticate કરતા પ્લેટફોર્મ્સ.
2. context સાથે કૉલ મોકલો
- તમારા SBC પર એજન્ટ માટે એક ફોન નંબર પસંદ કરો, જેમ કે
+14155550188. - SBC પર, તે નંબરના કૉલને endpointના
sip_uriપર રૂટ કરો, ઉદાહરણ તરીકે TLS મારફતે પોર્ટ5061પરsip:agent-12-jhxmginwjx@sip.thunderphone.com. ThunderPhone user part દ્વારા endpoint શોધે છે (agent-12-jhxmginwjx), જે request URI અનેToheader બંનેમાં હોવો આવશ્યક છે. X-headers ને કોઈ ફેરફાર વિના પસાર કરો. - Copilot Studio માં, તે નંબર માટે બાહ્ય ફોન નંબર ટ્રાન્સફર સાથે વાતચીત ટ્રાન્સફર કરો નોડ ઉમેરો, અને X-headers ઉમેરો:
X-Call-ID: Dynamics 365 conversation ID. કોઈ Microsoft header તેને ધરાવતું નથી, તેથી તેને અહીં ઉમેરો; ThunderPhone તેને કૉલનાexternal_call_idતરીકે સંગ્રહિત કરે છે. conversation ID કયો variable ધરાવે છે તેની Copilot Studio માં પુષ્ટિ કરો.- વધુમાં વધુ ચાર, જેમ કે
X-Customer-Tier.
Microsoft વધુમાં વધુ પાંચ X-headers મોકલે છે, જેમાં નામ 64 અક્ષરો સુધીના અને values 256 સુધીના હોય છે, અને તેમાં અક્ષરો, અંકો તથા = ; . ! % * _ + ~ - વપરાય છે. તે prefix ને lowercase x- તરીકે લખે છે; ThunderPhone header નામોને case અવગણીને મેળવે છે, તેથી x-customer-tier prompt માં {{sip_x_customer_tier}} તરીકે પહોંચે છે.
જો તેના બદલે તમે Azure Communication Services Call Automation સાથે કૉલ બનાવો, તો AddSipX default રૂપે X-MS-Custom- નામો લખે છે. X-Call-ID તેનું નામ જાળવી રાખે તે માટે
SipHeaderPrefix.X પસાર કરો
(custom context).
3. કૉલ પાછો મેળવો
એજન્ટ કૉલ પાછો કરે છે: તે વિદાય કહે છે અને કૉલ બંધ કરે છે. આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ ટ્રાન્સફર નંબર ઉમેરો):
{"name": "Dynamics 365", "action": "return"}કૉલરને Dynamics 365 માં પાછા લાવવાનું કામ તમારા SBC નું છે. Microsoft
સંદર્ભ સાથે કૉલ દાખલ કરવાની એક રીતનું દસ્તાવેજીકરણ કરે છે: Dynamics 365 માં
નોંધાયેલા નંબર પર SBC મારફતે નવો કૉલ, જેમાં UUI ની કીઓ તમે
Workstreams → અદ્યતન સેટિંગ્સ હેઠળ સેટ કરેલા સંદર્ભ વેરિએબલ્સ સાથે મેળ ખાય છે
(તૃતીય-પક્ષ IVR ટ્રાન્સફર).
ThunderPhone કૉલ બંધ કરે ત્યારે કૉલર તે નંબર સુધી કેવી રીતે પહોંચે છે તે તમારા
SBC વેન્ડર સાથે નક્કી કરો, અને તમે X-Call-ID માં મોકલેલ વાર્તાલાપ ID સાથે રાખો
જેથી ફ્લો કૉલ શોધી શકે.
પછી Copilot Studio ના HTTP વિનંતી નોડ વડે હેન્ડ-ઓફ મેળવો:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=પછી વાર્તાલાપ 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 વાર્તાલાપ ID હોવું જોઈએ. જો કૉલ ક્યારેય
એજન્ટ સુધી ન પહોંચે અને તમારા SBC લૉગ્સ SIP 404 દર્શાવે, તો તેની રિક્વેસ્ટ URI
અથવા To હેડરમાં એન્ડપોઇન્ટનો વપરાશકર્તા ભાગ નથી.
મર્યાદાઓ
- SBC આવશ્યક છે. Microsoft SIP સરનામા પર ડાયલ કરી શકતું નથી અથવા ડાયજેસ્ટ ચેલેન્જનો જવાબ આપી શકતું નથી.
- Microsoft વધુમાં વધુ 5 X-હેડર્સ મોકલે છે અને આવતા કૉલમાં માત્ર પ્રથમ 5 જ રાખે છે. Dynamics 365 વધુમાં વધુ 128 અક્ષરોનું UUI લે છે.
- Microsoft
BYEપર હેડર્સ વાંચવાનું દસ્તાવેજીકરણ કરતું નથી, તેથી હેન્ડ-ઓફ માત્ર લુકઅપ મારફતે પાછો આવે છે.