Open in
Povežite se iz Microsoft Dynamics 365
Klice iz Dynamics 365 Contact Center in Copilot Studio usmerite do glasovnega agenta ThunderPhone prek svojega SBC-ja z glavami X ter prek HTTP pridobite podatke o predaji agenta.
Dynamics 365 Contact Center pošlje klicatelja agentu prek vašega mejnega krmilnika sej (SBC) z do petimi X-glavami, vključno z ID-jem pogovora. Ko agent konča, prekine klic, vaš SBC klicatelja vrne v Dynamics 365, vozlišče HTTP Request pa pridobi predajo.
Preden začnete
- Agent ThunderPhone in organizacijski ključ API.
- Glasovni kanal Dynamics 365 Contact Center, povezan prek storitve Azure Communication Services Direct Routing s SBC-jem, ki ga upravljate (zahteve za SBC): podprt SBC z javnim potrdilom, TLS 1.2 na vratih 5061 in SRTP proti Microsoftu.
- Podpora za SIP X-glave v vozlišču Transfer conversation (Copilot Studio). Potrdite, da je na voljo v vašem okolju.
Dynamics 365 prenese klic samo na telefonsko številko, Microsoft pa Direct Routing preverja s potrdilom, ne z geslom. Vaš SBC je med Microsoftom in ThunderPhone ter to številko pretvori v SIP-naslov agenta.
1. Ustvarite končno točko SIP
Klic doseže ThunderPhone z vašega SBC-ja, zato ustvarite standardno končno točko, ki jo bo uporabljal 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"}'Takoj shranite password iz odgovora; prikaže se samo enkrat, vaš SBC pa z njim
odgovori na izziv ThunderPhone. Če vaš SBC ne podpira avtentikacije digest,
namesto tega ustvarite končno točko z auth, nastavljenim na ip_allowlist, in
javnim naslovom vašega SBC-ja; glejte
Platforme, ki preverjajo pristnost po izvornem IP-ju.
2. Pošiljajte klice s kontekstom
- Na SBC-ju izberite telefonsko številko za agenta, na primer
+14155550188. - Na SBC-ju usmerite klice na to številko v
sip_urikončne točke, na primersip:agent-12-jhxmginwjx@sip.thunderphone.com, prek TLS na vratih5061. ThunderPhone najde končno točko po uporabniškem delu (agent-12-jhxmginwjx), ki mora biti v URI-ju zahteve in glaviTo. X-glave posredujte nespremenjene. - V Copilot Studio dodajte vozlišče Transfer conversation z možnostjo
External phone number transfer na to številko in dodajte X-glave:
X-Call-ID: ID pogovora Dynamics 365. Nobena Microsoftova glava ga ne vsebuje, zato ga dodajte tukaj; ThunderPhone ga shrani kotexternal_call_idklica. V Copilot Studio potrdite, katera spremenljivka vsebuje ID pogovora.- Do štiri dodatne, na primer
X-Customer-Tier.
Microsoft pošlje največ pet X-glav z imeni do 64 znakov in vrednostmi do 256
znakov, pri čemer uporablja črke, številke in = ; . ! % * _ + ~ -. Predpono
zapiše z malimi črkami kot x-; ThunderPhone imena glav primerja ne glede na
velikost črk, zato x-customer-tier doseže poziv kot {{sip_x_customer_tier}}.
Če klic namesto tega ustvarite z Azure Communication Services Call Automation,
AddSipX privzeto zapiše imena X-MS-Custom-. Posredujte
SipHeaderPrefix.X, da X-Call-ID ohrani svoje ime
(kontekst po meri).
3. Prejmite klic nazaj
Agent vrne klic: poslovi se in prekine povezavo. Dodajte to številko za preusmeritev (glejte Dodajte številko za preusmeritev):
{"name": "Dynamics 365", "action": "return"}Za vrnitev klicatelja v Dynamics 365 je odgovoren vaš SBC. Microsoft
dokumentira en način za dohodni klic s kontekstom: nov klic prek SBC-ja na
številko, registrirano v Dynamics 365, z UUI, katerega ključi se ujemajo s
spremenljivkami konteksta, ki jih nastavite v razdelku Delovni tokovi → Napredne nastavitve
(prenos iz IVR-ja tretje osebe).
Z dobaviteljem SBC-ja uskladite, kako klicatelj doseže to številko, ko
ThunderPhone prekine povezavo, in prenesite ID pogovora, ki ste ga poslali v X-Call-ID,
da lahko tok najde klic.
Nato pridobite predajo z vozliščem Zahteva HTTP v Copilot Studio:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ki mu sledi ID pogovora.- Glava
Authorization: Bearer sk_live_…. - Razčlenite odgovor v spremenljivko ter uporabite
handoff.summaryinhandoff.intent.
Glejte Poiščite predani klic.
Preizkusite
Pokličite številko Dynamics 365, ki doseže vozlišče za preusmeritev, prosite
agenta za osebo in preverite, da se klicatelj vrne v Dynamics 365. Nato odprite
klic z GET /v1/calls/{call_id}: sip_headers mora vsebovati x-call-id, medtem ko
mora biti external_call_id ID pogovora. Če klic nikoli ne doseže agenta in dnevniki
vašega SBC-ja prikazujejo SIP 404, URI zahteve ali glava To ne vsebujeta
uporabniškega dela končne točke.
Omejitve
- SBC je obvezen. Microsoft ne more klicati naslova SIP ali odgovoriti na izziv digest.
- Microsoft pošlje največ pet glav X in ob dohodnem klicu ohrani le prvih pet. Dynamics 365 sprejme največ 128 znakov UUI.
- Microsoft ne dokumentira branja glav pri
BYE, zato se predaja vrne le prek poizvedbe.