ThunderPhone v3 è online.Attivazione self-service, da 2¢/min.Leggi l’annuncio

Contact centers

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

  1. Scegli un numero di telefono per l'agente sul tuo SBC, ad esempio +14155550188.
  2. Sul SBC, instrada le chiamate a quel numero verso il sip_uri dell'endpoint, ad esempio sip:agent-12-jhxmginwjx@sip.thunderphone.com, tramite TLS sulla porta 5061. ThunderPhone identifica l'endpoint dalla parte utente (agent-12-jhxmginwjx), che deve essere presente sia nell'URI di richiesta sia nell'intestazione To. Trasmetti gli X-header senza modificarli.
  3. 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 come external_call_id della 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.summary e handoff.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.