Open in
Pripojenie z Microsoft Dynamics 365
Odosielajte hovory z Dynamics 365 Contact Center a Copilot Studio k hlasovému agentovi ThunderPhone prostredníctvom svojho SBC s hlavičkami X a vyhľadajte odovzdanie hovoru agentom cez HTTP.
Dynamics 365 Contact Center odošle volajúceho k agentovi cez váš hraničný riadiaci prvok relácie (SBC) s až piatimi X-hlavičkami vrátane ID konverzácie. Keď agent skončí, ukončí hovor, váš SBC vráti volajúceho do Dynamics 365 a uzol požiadavky HTTP načíta odovzdanie.
Skôr než začnete
- Agent ThunderPhone a kľúč API organizácie.
- Hlasový kanál Dynamics 365 Contact Center pripojený cez Azure Communication Services Priame smerovanie k SBC, ktorý prevádzkujete (požiadavky na SBC): podporovaný SBC s verejným certifikátom, TLS 1.2 na porte 5061 a SRTP smerom k Microsoftu.
- Podpora SIP X-hlavičiek v uzle Preniesť konverzáciu (Copilot Studio). Potvrďte, že je vo vašom prostredí dostupná.
Dynamics 365 prenáša len na telefónne číslo a Microsoft overuje Priame smerovanie certifikátom, nie heslom. Váš SBC sa nachádza medzi Microsoftom a ThunderPhone a prevádza toto číslo na SIP adresu agenta.
1. Vytvorte koncový bod SIP
Hovor prichádza do ThunderPhone z vášho SBC, preto vytvorte štandardný koncový bod, ktorý bude SBC používať:
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"}'Heslo password z odpovede si ihneď uložte; zobrazí sa iba raz a váš SBC ním odpovie na výzvu ThunderPhone. Ak váš SBC nepodporuje autentifikáciu Digest, vytvorte koncový bod s hodnotou auth nastavenou na ip_allowlist a namiesto toho uveďte verejnú adresu vášho SBC; pozrite si
platformy overované podľa zdrojovej IP adresy.
2. Odosielajte hovory s kontextom
- Vyberte pre agenta na vašom SBC telefónne číslo, napríklad
+14155550188. - Na SBC smerujte hovory na toto číslo do
sip_urikoncového bodu, napríkladsip:agent-12-jhxmginwjx@sip.thunderphone.com, cez TLS na porte5061. ThunderPhone nájde koncový bod podľa používateľskej časti (agent-12-jhxmginwjx), ktorá musí byť v URI požiadavky aj v hlavičkeTo. X-hlavičky odovzdajte bez zmien. - V Copilot Studio pridajte uzol Preniesť konverzáciu s možnosťou
Prenos na externé telefónne číslo na toto číslo a pridajte X-hlavičky:
X-Call-ID: ID konverzácie Dynamics 365. Žiadna hlavička Microsoftu ho nenesie, preto ho pridajte tu; ThunderPhone ho uloží akoexternal_call_idhovoru. V Copilot Studio potvrďte, ktorá premenná obsahuje ID konverzácie.- Až štyri ďalšie, napríklad
X-Customer-Tier.
Microsoft odosiela najviac päť X-hlavičiek s názvami dlhými až 64 znakov a
hodnotami dlhými až 256 znakov, pričom používa písmená, číslice a = ; . ! % * _ + ~ -. Predponu zapisuje malými písmenami ako x-; ThunderPhone porovnáva názvy hlavičiek bez ohľadu na veľkosť písmen, takže x-customer-tier sa dostane do promptu ako {{sip_x_customer_tier}}.
Ak hovor namiesto toho vytvárate pomocou Azure Communication Services Call Automation,
AddSipX predvolene zapisuje názvy X-MS-Custom-. Odovzdajte
SipHeaderPrefix.X, aby si X-Call-ID zachovalo svoj názov
(vlastný kontext).
3. Vráťte hovor späť
Hlasový agent vráti hovor: rozlúči sa a zavesí. Pridajte toto číslo pre presmerovanie (pozrite si Pridanie čísla pre presmerovanie):
{"name": "Dynamics 365", "action": "return"}Vrátenie volajúceho do Dynamics 365 je úlohou vášho SBC. Microsoft
dokumentuje jeden spôsob prichádzajúceho hovoru s kontextom: nový hovor cez SBC na
číslo zaregistrované v Dynamics 365 s UUI, ktorého kľúče zodpovedajú premenným kontextu,
ktoré nastavíte v časti Pracovné toky → Rozšírené nastavenia
(presmerovanie IVR tretej strany).
S dodávateľom SBC si dohodnite, ako volajúci dosiahne toto číslo, keď
ThunderPhone zavesí, a preneste ID konverzácie, ktoré ste odoslali v X-Call-ID,
aby tok mohol hovor nájsť.
Potom načítajte odovzdanie pomocou uzla Požiadavka HTTP v Copilot Studio:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=nasledované ID konverzácie.- Hlavička
Authorization: Bearer sk_live_…. - Odpoveď spracujte do premennej a použite
handoff.summaryahandoff.intent.
Pozrite si časť Vyhľadanie odovzdaného hovoru.
Otestujte to
Zavolajte na číslo Dynamics 365, ktoré vedie k uzlu presmerovania, požiadajte
agenta o spojenie s človekom a overte, že sa volajúci vráti do Dynamics 365. Potom otvorte
hovor pomocou GET /v1/calls/{call_id}: položka sip_headers by mala obsahovať x-call-id a
external_call_id by malo byť ID konverzácie. Ak hovor nikdy nedorazí k
agentovi a protokoly SBC zobrazujú SIP 404, identifikátor URI požiadavky alebo hlavička To
neobsahuje používateľskú časť koncového bodu.
Obmedzenia
- Vyžaduje sa SBC. Microsoft nemôže vytočiť adresu SIP ani odpovedať na výzvu digest.
- Microsoft odosiela najviac päť hlavičiek X a pri prichádzajúcom hovore uchová iba prvých päť. Dynamics 365 prijíma v UUI najviac 128 znakov.
- Microsoft nedokumentuje čítanie hlavičiek pri
BYE, takže odovzdanie sa vráti iba prostredníctvom vyhľadania.