Open in
Conectați-vă din Microsoft Dynamics 365
Trimiteți apelurile Dynamics 365 Contact Center și Copilot Studio către un agent vocal ThunderPhone prin SBC-ul dumneavoastră cu antete X și căutați transferul agentului prin HTTP.
Dynamics 365 Contact Center trimite apelantul către agent prin controlerul dumneavoastră de frontieră de sesiune (SBC), cu până la cinci antete X, inclusiv id-ul conversației. Când agentul termină, încheie apelul, SBC-ul dumneavoastră readuce apelantul în Dynamics 365, iar un nod de solicitare HTTP preia predarea.
Înainte de a începe
- Un agent ThunderPhone și o cheie API de organizație.
- Canalul vocal Dynamics 365 Contact Center, conectat prin Azure Communication Services Rutare directă la un SBC administrat de dumneavoastră (cerințe pentru SBC): un SBC compatibil cu certificat public, TLS 1.2 pe portul 5061 și SRTP către Microsoft.
- Suport pentru antete SIP X în nodul Transferați conversația (Copilot Studio). Confirmați că este disponibil în mediul dumneavoastră.
Dynamics 365 transferă doar către un număr de telefon, iar Microsoft autentifică Rutarea directă prin certificat, nu prin parolă. SBC-ul dumneavoastră se află între Microsoft și ThunderPhone și transformă acel număr în adresa SIP a agentului.
1. Creați punctul final SIP
Apelul ajunge la ThunderPhone de la SBC-ul dumneavoastră, deci creați un punct final standard pe care SBC-ul să îl utilizeze:
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"}'Salvați imediat password din răspuns; este afișată o singură dată, iar
SBC-ul dumneavoastră răspunde cu aceasta la provocarea ThunderPhone. Dacă SBC-ul nu poate efectua
autentificarea Digest, creați în schimb punctul final cu auth setat la ip_allowlist și adresa publică a
SBC-ului; consultați
Platforme care se autentifică după IP-ul sursă.
2. Trimiteți apeluri cu context
- Alegeți un număr de telefon pentru agent pe SBC-ul dumneavoastră, precum
+14155550188. - Pe SBC, direcționați apelurile către acel număr la
sip_urial punctului final, de exemplusip:agent-12-jhxmginwjx@sip.thunderphone.com, prin TLS pe portul5061. ThunderPhone identifică punctul final după partea de utilizator (agent-12-jhxmginwjx), care trebuie să fie atât în URI-ul solicitării, cât și în antetulTo. Transmiteți antetele X fără modificări. - În Copilot Studio, adăugați un nod Transferați conversația cu
Transfer către număr de telefon extern către acel număr și adăugați antetele X:
X-Call-ID: id-ul conversației Dynamics 365. Niciun antet Microsoft nu îl conține, deci adăugați-l aici; ThunderPhone îl stochează caexternal_call_idal apelului. Confirmați în Copilot Studio ce variabilă conține id-ul conversației.- Încă până la patru antete, precum
X-Customer-Tier.
Microsoft trimite cel mult cinci antete X, cu nume de până la 64 de caractere și
valori de până la 256 de caractere, folosind litere, cifre și = ; . ! % * _ + ~ -. Scrie
prefixul cu litere mici, x-; ThunderPhone compară numele antetelor fără a ține cont de majuscule,
astfel încât x-customer-tier ajunge în prompt ca {{sip_x_customer_tier}}.
Dacă creați apelul cu Azure Communication Services Call Automation
în schimb, AddSipX scrie implicit nume X-MS-Custom-. Transmiteți
SipHeaderPrefix.X pentru ca X-Call-ID să își păstreze numele
(context personalizat).
3. Preluați apelul înapoi
Agentul returnează apelul: își ia rămas-bun și închide. Adăugați acest număr de transfer (consultați Adăugați numărul de transfer):
{"name": "Dynamics 365", "action": "return"}Readucerea apelantului în Dynamics 365 este responsabilitatea SBC-ului dumneavoastră. Microsoft
documentează o modalitate de a iniția un apel cu context: un apel nou prin SBC către un
număr înregistrat în Dynamics 365, cu UUI ale cărui chei corespund variabilelor de context
pe care le configurați în Fluxuri de lucru → Setări avansate
(transfer IVR de la terți).
Stabiliți împreună cu furnizorul SBC cum ajunge apelantul la acel număr atunci când
ThunderPhone închide apelul și transmiteți ID-ul conversației pe care l-ați trimis în X-Call-ID
pentru ca fluxul să poată găsi apelul.
Apoi preluați predarea cu un nod Solicitare HTTP din Copilot Studio:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=urmat de ID-ul conversației.- Antetul
Authorization: Bearer sk_live_…. - Analizați răspunsul într-o variabilă și utilizați
handoff.summaryșihandoff.intent.
Consultați Căutați un apel predat.
Testați
Apelați un număr Dynamics 365 care ajunge la nodul de transfer, solicitați agentului o
persoană și verificați că apelantul revine în Dynamics 365. Apoi deschideți apelul cu
GET /v1/calls/{call_id}: sip_headers trebuie să includă x-call-id, iar
external_call_id trebuie să fie ID-ul conversației. Dacă apelul nu ajunge niciodată la
agent și jurnalele SBC indică SIP 404, URI-ul solicitării sau antetul To nu conține
partea de utilizator a punctului final.
Limite
- Este necesar un SBC. Microsoft nu poate apela o adresă SIP și nu poate răspunde la o provocare digest.
- Microsoft trimite cel mult cinci antete X și păstrează doar primele cinci pentru un apel primit. Dynamics 365 acceptă cel mult 128 de caractere de UUI.
- Microsoft nu documentează citirea antetelor într-un
BYE, astfel că predarea revine numai prin căutare.