Open in
Unganisha kutoka Microsoft Dynamics 365
Tuma simu za Dynamics 365 Contact Center na Copilot Studio kwa ejenti wa ThunderPhone kupitia SBC yako ukitumia vichwa vya X, na tafuta uhamisho wa ejenti kupitia HTTP.
Dynamics 365 Contact Center humtuma mpigaji simu kwa ejenti kupitia kidhibiti chako cha mpaka wa sesheni (SBC), ikiwa na hadi X-header tano ikijumuisha id ya mazungumzo. Ejenti inapomaliza, hukata simu, SBC yako humrudisha mpigaji simu kwenye Dynamics 365, na nodi ya Ombi la HTTP hupata makabidhiano.
Kabla ya kuanza
- Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
- Kituo cha sauti cha Dynamics 365 Contact Center, kilichounganishwa kupitia Azure Communication Services Uelekezaji wa Moja kwa Moja kwenye SBC unayoendesha (mahitaji ya SBC): SBC inayotumika yenye cheti cha umma, TLS 1.2 kwenye bandari 5061 na SRTP kuelekea Microsoft.
- Usaidizi wa SIP X-header kwenye nodi ya Hamisha mazungumzo (Copilot Studio). Thibitisha kuwa unapatikana katika mazingira yako.
Dynamics 365 huhamisha tu kwenye nambari ya simu, na Microsoft huthibitisha Uelekezaji wa Moja kwa Moja kwa cheti, si kwa nywila. SBC yako hukaa kati ya Microsoft na ThunderPhone na kugeuza nambari hiyo kuwa anwani ya SIP ya ejenti.
1. Unda kituo cha mwisho cha SIP
Simu hufika ThunderPhone kutoka kwenye SBC yako, kwa hivyo unda kituo cha mwisho cha kawaida kitakachotumiwa na 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"}'Hifadhi password kutoka kwenye jibu mara moja; huonyeshwa mara moja, na
SBC yako hujibu changamoto ya ThunderPhone kwa kuitumia. Ikiwa SBC yako haiwezi
kufanya uthibitishaji wa muhtasari, unda kituo cha mwisho huku auth ikiwa
imewekwa kuwa ip_allowlist na anwani ya umma ya SBC yako badala yake; tazama
Majukwaa yanayothibitisha kwa IP chanzo.
2. Tuma simu zenye muktadha
- Chagua nambari ya simu ya ejenti kwenye SBC yako, kama vile
+14155550188. - Kwenye SBC, elekeza simu zinazoingia kwenye nambari hiyo kwenye
sip_uriya kituo cha mwisho, kwa mfanosip:agent-12-jhxmginwjx@sip.thunderphone.com, kupitia TLS kwenye bandari5061. ThunderPhone hupata kituo cha mwisho kwa sehemu ya mtumiaji (agent-12-jhxmginwjx), ambayo lazima iwe katika URI ya ombi na kichwa chaTo. Pitisha X-header bila kuzibadilisha. - Katika Copilot Studio, ongeza nodi ya Hamisha mazungumzo yenye
Hamisha kwa nambari ya simu ya nje hadi kwenye nambari hiyo, na uongeze
X-header:
X-Call-ID: id ya mazungumzo ya Dynamics 365. Hakuna kichwa cha Microsoft kinachoibeba, kwa hivyo iongeze hapa; ThunderPhone huihifadhi kamaexternal_call_idya simu. Thibitisha katika Copilot Studio ni kigeu gani kinachoshikilia id ya mazungumzo.- Hadi nyingine nne, kama vile
X-Customer-Tier.
Microsoft hutuma upeo wa X-header tano, zikiwa na majina ya hadi vibambo 64 na
thamani za hadi 256, kwa kutumia herufi, tarakimu na = ; . ! % * _ + ~ -.
Huandika kiambishi awali kwa herufi ndogo x-; ThunderPhone hulinganisha majina
ya vichwa bila kuzingatia ukubwa wa herufi, kwa hivyo x-customer-tier hufika
kwenye prompt kama {{sip_x_customer_tier}}.
Ikiwa badala yake utaunda simu kwa Azure Communication Services Call Automation,
AddSipX huandika majina ya X-MS-Custom- kwa chaguo-msingi. Pitisha
SipHeaderPrefix.X ili X-Call-ID ihifadhi jina lake
(muktadha maalum).
3. Rejesha simu
Ejenti hurudisha simu: inaaga na kukata simu. Ongeza nambari hii ya uhamisho (angalia Ongeza nambari ya uhamisho):
{"name": "Dynamics 365", "action": "return"}Kurudisha mpigaji simu kwenye Dynamics 365 ni kazi ya SBC yako. Microsoft
inaeleza njia moja ya kuingiza simu yenye muktadha: simu mpya kupitia SBC hadi
kwenye nambari iliyosajiliwa katika Dynamics 365, yenye UUI ambayo funguo zake
zinalingana na vigeu vya muktadha unavyoweka chini ya Mitiririko ya kazi → Mipangilio ya kina
(uhamisho wa IVR wa mhusika mwingine).
Panga na mtoa huduma wako wa SBC jinsi mpigaji simu anavyofika kwenye nambari
hiyo ThunderPhone inapokata simu, na pitisha kitambulisho cha mazungumzo
ulichotuma katika X-Call-ID ili mtiririko uweze kupata simu.
Kisha pata maelezo ya uhamisho kwa kutumia nodi ya Copilot Studio ya Ombi la HTTP:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ikifuatiwa na kitambulisho cha mazungumzo.- Kichwa
Authorization: Bearer sk_live_…. - Changanua jibu katika kigeu na utumie
handoff.summarynahandoff.intent.
Angalia Tafuta simu iliyohamishwa.
Ijaribu
Piga nambari ya Dynamics 365 inayofikia nodi ya uhamisho, mwombe ejenti mtu,
na uhakikishe kuwa mpigaji simu anarudi kwenye Dynamics 365. Kisha fungua simu
kwa GET /v1/calls/{call_id}: sip_headers zinapaswa kuorodhesha x-call-id,
na external_call_id inapaswa kuwa kitambulisho cha mazungumzo. Ikiwa simu
haimfikii ejenti kamwe na kumbukumbu za SBC yako zinaonyesha SIP 404, URI ya
ombi lake au kichwa cha To hakina sehemu ya mtumiaji ya endpoint.
Vikomo
- SBC inahitajika. Microsoft haiwezi kupiga anwani ya SIP au kujibu changamoto ya digest.
- Microsoft hutuma vichwa vya X visivyozidi vitano, na huhifadhi vitano vya kwanza pekee kwenye simu inayoingia. Dynamics 365 huchukua herufi zisizozidi 128 za UUI.
- Microsoft haielezi kusoma vichwa kwenye
BYE, kwa hivyo maelezo ya uhamisho hurudi kupitia utafutaji pekee.