Open in
Connetti da Microsoft Dynamics 365
Invia le chiamate di Dynamics 365 Contact Center e Copilot Studio a un agente ThunderPhone tramite il tuo SBC con X-header e cerca il trasferimento dell
Dynamics 365 Contact Center invia il chiamante all'agente tramite il tuo session border controller (SBC), con fino a cinque X-header incluso l'ID della conversazione. Al termine, l'agente riaggancia, il tuo SBC riporta il chiamante in Dynamics 365 e un nodo HTTP Request recupera il passaggio.
Prima di iniziare
- Un agente ThunderPhone e una chiave API dell'organizzazione.
- Il canale vocale di Dynamics 365 Contact Center, connesso tramite Instradamento diretto di Azure Communication Services a un SBC da te gestito (requisiti SBC): un SBC supportato con certificato pubblico, TLS 1.2 sulla porta 5061 e SRTP verso Microsoft.
- Supporto degli X-header SIP nel nodo Trasferisci conversazione (Copilot Studio). Verifica che sia disponibile nel tuo ambiente.
Dynamics 365 trasferisce solo a un numero di telefono e Microsoft autentica l'Instradamento diretto tramite certificato, non tramite password. Il tuo SBC si trova tra Microsoft e ThunderPhone e trasforma quel numero nell'indirizzo SIP dell'agente.
1. Crea l'endpoint SIP
La chiamata raggiunge ThunderPhone dal tuo SBC, quindi crea un endpoint standard da usare con l'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"}'Salva subito la password della risposta; viene mostrata una sola volta e
il tuo SBC risponde con essa alla richiesta di autenticazione di ThunderPhone. Se il tuo SBC non supporta l'autenticazione
digest, crea invece l'endpoint con auth impostato su ip_allowlist e l'indirizzo pubblico del tuo
SBC; consulta
Piattaforme che si autenticano tramite IP di origine.
2. Invia le chiamate con il contesto
- Scegli un numero di telefono per l'agente sul tuo SBC, ad esempio
+14155550188. - Sul SBC, instrada le chiamate a quel numero verso il
sip_uridell'endpoint, ad esempiosip:agent-12-jhxmginwjx@sip.thunderphone.com, tramite TLS sulla porta5061. ThunderPhone identifica l'endpoint dalla parte utente (agent-12-jhxmginwjx), che deve essere presente sia nell'URI di richiesta sia nell'intestazioneTo. Trasmetti gli X-header senza modificarli. - In Copilot Studio, aggiungi un nodo Trasferisci conversazione con
Trasferimento a numero di telefono esterno verso quel numero e aggiungi gli X-header:
X-Call-ID: l'ID della conversazione Dynamics 365. Nessuna intestazione Microsoft lo contiene, quindi aggiungilo qui; ThunderPhone lo archivia comeexternal_call_iddella chiamata. Verifica in Copilot Studio quale variabile contiene l'ID della conversazione.- Fino a quattro altri, ad esempio
X-Customer-Tier.
Microsoft invia al massimo cinque X-header, con nomi lunghi fino a 64 caratteri e
valori fino a 256, usando lettere, cifre e = ; . ! % * _ + ~ -. Scrive
il prefisso come x- in minuscolo; ThunderPhone confronta i nomi delle intestazioni senza distinguere maiuscole e minuscole,
quindi x-customer-tier raggiunge il prompt come {{sip_x_customer_tier}}.
Se crei invece la chiamata con Azure Communication Services Call Automation,
AddSipX scrive per impostazione predefinita nomi X-MS-Custom-. Passa
SipHeaderPrefix.X affinché X-Call-ID mantenga il proprio nome
(contesto personalizzato).
3. Ricevi di nuovo la chiamata
L'agente restituisce la chiamata: saluta e riaggancia. Aggiungi questo numero di trasferimento (vedi Aggiungere il numero di trasferimento):
{"name": "Dynamics 365", "action": "return"}Riportare il chiamante in Dynamics 365 è compito del tuo SBC. Microsoft
documenta un modo per inoltrare una chiamata con contesto: una nuova chiamata
attraverso l'SBC a un numero registrato in Dynamics 365, con UUI le cui chiavi
corrispondono alle variabili di contesto configurate in Flussi di lavoro → Impostazioni avanzate
(trasferimento IVR di terze parti).
Definisci con il fornitore dell'SBC come il chiamante raggiunge quel numero quando
ThunderPhone riaggancia e trasporta l'ID conversazione inviato in X-Call-ID
in modo che il flusso possa trovare la chiamata.
Quindi recupera il passaggio di consegne con un nodo Richiesta HTTP di Copilot Studio:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=seguito dall'ID conversazione.- Intestazione
Authorization: Bearer sk_live_…. - Analizza la risposta in una variabile e usa
handoff.summaryehandoff.intent.
Vedi Cercare una chiamata passata.
Testalo
Chiama un numero Dynamics 365 che raggiunge il nodo di trasferimento, chiedi
all'agente di parlare con una persona e verifica che il chiamante rientri in
Dynamics 365. Quindi apri la chiamata con GET /v1/calls/{call_id}: sip_headers
dovrebbe elencare x-call-id e external_call_id dovrebbe essere l'ID
conversazione. Se la chiamata non raggiunge mai l'agente e i log dell'SBC mostrano
SIP 404, l'URI della richiesta o l'intestazione To non contiene la parte utente
dell'endpoint.
Limiti
- È richiesto un SBC. Microsoft non può comporre un indirizzo SIP né rispondere a una richiesta digest.
- Microsoft invia al massimo cinque intestazioni X e conserva solo le prime cinque in una chiamata in arrivo. Dynamics 365 accetta al massimo 128 caratteri di UUI.
- Microsoft non documenta la lettura delle intestazioni in un
BYE, quindi il passaggio di consegne viene restituito solo tramite la ricerca.