Open in
Savienojiet no Microsoft Dynamics 365
Nosūtiet zvanus no Dynamics 365 Contact Center un Copilot Studio uz ThunderPhone balss aģentu, izmantojot savu SBC ar X galvenēm, un HTTP ceļā uzmeklējiet aģenta zvana pāradresēšanu.
Dynamics 365 Contact Center novirza zvanītāju uz balss aģentu, izmantojot jūsu sesijas robežkontrolieri (SBC), ar līdz piecām X galvenēm, tostarp sarunas ID. Kad balss aģents ir pabeidzis, tas noliek klausuli, jūsu SBC atgriež zvanītāju pakalpojumā Dynamics 365, un HTTP pieprasījuma mezgls iegūst pārsūtīšanas informāciju.
Pirms sākat
- ThunderPhone balss aģents un organizācijas API atslēga.
- Dynamics 365 Contact Center balss kanāls, kas ar Azure Communication Services Direct Routing ir savienots ar jūsu pārvaldītu SBC (SBC prasības): atbalstīts SBC ar publisku sertifikātu, TLS 1.2 portā 5061 un SRTP savienojumam ar Microsoft.
- SIP X-galvenes atbalsts mezglā Transfer conversation (Copilot Studio). Apstipriniet, ka tas ir pieejams jūsu vidē.
Dynamics 365 pārsūta tikai uz tālruņa numuru, un Microsoft autentificē Direct Routing ar sertifikātu, nevis paroli. Jūsu SBC atrodas starp Microsoft un ThunderPhone un pārvērš šo numuru par balss aģenta SIP adresi.
1. Izveidojiet SIP galapunktu
Zvans sasniedz ThunderPhone no jūsu SBC, tāpēc izveidojiet standarta galapunktu, ko izmantot 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"}'Nekavējoties saglabājiet atbildē saņemto password; tā tiek parādīta vienreiz,
un jūsu SBC ar to atbild uz ThunderPhone izaicinājumu. Ja jūsu SBC neatbalsta
digest autentifikāciju, tā vietā izveidojiet galapunktu ar auth iestatītu uz
ip_allowlist un norādiet sava SBC publisko adresi; skatiet
Platformas, kas autentificē pēc avota IP.
2. Sūtiet zvanus ar kontekstu
- Izvēlieties savā SBC balss aģentam tālruņa numuru, piemēram,
+14155550188. - SBC maršrutējiet zvanus uz šo numuru uz galapunkta
sip_uri, piemēram,sip:agent-12-jhxmginwjx@sip.thunderphone.com, izmantojot TLS portā5061. ThunderPhone atrod galapunktu pēc lietotāja daļas (agent-12-jhxmginwjx), kurai jābūt gan pieprasījuma URI, ganTogalvenē. Nododiet X-galvenes tālāk nemainītas. - Copilot Studio pievienojiet mezglu Transfer conversation ar
External phone number transfer uz šo numuru un pievienojiet X-galvenes:
X-Call-ID: Dynamics 365 sarunas ID. Neviena Microsoft galvene to nenodod, tāpēc pievienojiet to šeit; ThunderPhone to saglabā kā zvanaexternal_call_id. Copilot Studio apstipriniet, kurš mainīgais satur sarunas ID.- Līdz četrām papildu galvenēm, piemēram,
X-Customer-Tier.
Microsoft nosūta ne vairāk kā piecas X-galvenes, kuru nosaukumi var būt līdz
64 rakstzīmēm gari un vērtības — līdz 256 rakstzīmēm garas, izmantojot burtus,
ciparus un = ; . ! % * _ + ~ -. Tā raksta prefiksu ar mazajiem burtiem
x-; ThunderPhone salīdzina galveņu nosaukumus, neņemot vērā reģistru,
tāpēc x-customer-tier uzvednē nonāk kā {{sip_x_customer_tier}}.
Ja tā vietā veidojat zvanu ar Azure Communication Services Call Automation,
AddSipX pēc noklusējuma raksta X-MS-Custom- nosaukumus. Nododiet
SipHeaderPrefix.X, lai X-Call-ID saglabātu savu nosaukumu
(pielāgots konteksts).
3. Saņemiet zvanu atpakaļ
Aģents atgriež zvanu: tas atvadās un noliek klausuli. Pievienojiet šo pārsūtīšanas numuru (skatiet Pievienojiet pārsūtīšanas numuru):
{"name": "Dynamics 365", "action": "return"}Par zvanītāja atgriešanu Dynamics 365 atbild jūsu SBC. Microsoft
dokumentē vienu veidu, kā ienākt zvanam ar kontekstu: jauns zvans caur SBC uz
Dynamics 365 reģistrētu numuru ar UUI, kura atslēgas atbilst konteksta
mainīgajiem, ko iestatījāt sadaļā Darba plūsmas → Papildu iestatījumi
(trešās puses IVR pārsūtīšana).
Saskaņojiet ar savu SBC piegādātāju, kā zvanītājs sasniedz šo numuru, kad
ThunderPhone noliek klausuli, un pārsūtiet sarunas ID, ko nosūtījāt laukā
X-Call-ID, lai plūsma varētu atrast zvanu.
Pēc tam izgūstiet nodošanu ar Copilot Studio HTTP pieprasījuma mezglu:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=kam seko sarunas ID.- Galvene
Authorization: Bearer sk_live_…. - Parsējiet atbildi mainīgajā un izmantojiet
handoff.summaryunhandoff.intent.
Skatiet Meklējiet nodotu zvanu.
Pārbaudiet
Zvaniet uz Dynamics 365 numuru, kas sasniedz pārsūtīšanas mezglu, palūdziet
aģentam savienot ar cilvēku un pārbaudiet, vai zvanītājs atgriežas Dynamics 365.
Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}: laukā sip_headers jābūt
norādītam x-call-id, un external_call_id jābūt sarunas ID. Ja zvans nekad
nesasniedz aģentu un jūsu SBC žurnālos redzams SIP 404, tā pieprasījuma URI
vai To galvenē nav galapunkta lietotāja daļas.
Ierobežojumi
- Nepieciešams SBC. Microsoft nevar sastādīt SIP adresi vai atbildēt uz digest autentifikācijas pieprasījumu.
- Microsoft nosūta ne vairāk kā piecas X-galvenes un ienākošam zvanam saglabā tikai pirmās piecas. Dynamics 365 UUI pieņem ne vairāk kā 128 rakstzīmes.
- Microsoft nedokumentē galveņu nolasīšanu
BYEziņojumā, tāpēc nodošana tiek atgriezta tikai ar uzmeklēšanu.