---
title: "Connetti da Microsoft Dynamics 365"
description: "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'agente tramite HTTP."
---

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](/it/guides/api-keys) 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](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  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](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  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:

```bash
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](/it/guides/sip-addresses).

## 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](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 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](/it/guides/contact-centers/overview)):

```json
{"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](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
