---
title: "Connetti da Talkdesk"
description: "Invia le chiamate Talkdesk a un agente ThunderPhone con Connect to Autopilot Voice e ritrasferiscile con l'ID di hand-off in UUI."
---

Il flusso Talkdesk Studio invia il chiamante all'agente con l'ID di interazione
e l'UUI. Quando il chiamante necessita di una persona, l'agente effettua
l'escalation con un `REFER` SIP a Talkdesk e l'ID di trasferimento viene salvato in una variabile di Studio.

## Prima di iniziare

- Un agente ThunderPhone e una [chiave API](/it/guides/api-keys) dell'organizzazione.
- Una licenza Talkdesk **Conversation Orchestrator**, che include il componente
  **Connetti a voce Autopilot** di Studio in modalità **Flusso vocale esterno**
  ([articolo di Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk addebita il costo al minuto mentre l'agente mantiene la chiamata.

## 1. Crea l'endpoint SIP

Talkdesk documenta solo un elenco di autorizzazione IP, quindi crea un endpoint che accetti
le chiamate in base all'indirizzo sorgente:

```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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'
```

L'articolo di Talkdesk afferma che l'audio viene inviato tramite SRTP e `"srtp": "optional"`
risponde con SRTP quando Talkdesk lo propone. L'articolo non specifica se Talkdesk
richiede SRTP; se Talkdesk ti comunica che lo richiede, imposta `srtp` su `required`, che
rifiuta le chiamate senza SRTP.

Richiedi a Talkdesk gli intervalli di segnalazione SIP di Talkdesk. Ciascuno deve essere un intervallo
IPv4 pubblico di `/16` o più ristretto (IPv6 `/48` o più ristretto). Consulta
[Piattaforme che eseguono l'autenticazione tramite IP sorgente](/it/guides/sip-addresses).
Talkdesk invia SIP dalla rete di Twilio, i cui indirizzi sono condivisi da ogni cliente Twilio,
quindi l'indirizzo dell'endpoint è ciò che impedisce l'accesso agli altri chiamanti: non
pubblicarlo.
Conserva il `sip_uri` della risposta, ad esempio
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Invia le chiamate con contesto

Nel flusso Studio, aggiungi **Connetti a voce Autopilot** in modalità **Flusso vocale
esterno** e imposta come destinazione il `sip_uri` dell'endpoint con `;transport=tls` aggiunto, ad
esempio `sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. L'endpoint
rifiuta le chiamate tramite UDP, che il SIP di Twilio usa se non diversamente specificato.

Talkdesk invia:

- `X-Talkdesk-Interaction-Id`, salvato come `external_call_id` della chiamata;
- `User-to-User`, codificato in esadecimale, ad esempio `business_hours=open`. Raggiunge il
  prompt decodificato, come `{{sip_uui}}`.

La versione 2.1 del componente può anche inviare **Intestazioni definite**. La pagina delle
preferenze di Talkdesk le descrive come JSON inviato tramite WebSocket, quindi verifica con
Talkdesk se arrivano come intestazioni SIP prima di farvi affidamento.

## 3. Ricevi nuovamente la chiamata

L'agente effettua l'escalation con un `REFER` all'indirizzo di escalation di Talkdesk, con l'ID di hand-off come UUI esadecimale all'interno di quell'indirizzo, l'unico punto in cui Talkdesk lo legge.
Aggiungi questo numero di trasferimento (consulta
[Aggiungi il numero di trasferimento](/it/guides/contact-centers/overview)
e [Intestazioni all'interno dell'indirizzo di trasferimento](/it/guides/call-transfers)):

```json
{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

L'indirizzo è quello indicato nell'articolo di Talkdesk. La versione 2.1 del componente
legge `autopilot_result=`; la versione 1.7 legge `escalate_to=`, quindi usa quella chiave
nella versione 1.7. Il `REFER` è così:

```
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
```

Talkdesk inserisce il valore in una variabile Studio. Per ottenere il riepilogo e l'intento,
aggiungi un passaggio **Esegui azione** a un'integrazione personalizzata creata con
Connections:

- Tipo di autenticazione **Chiave API**, nome dell'intestazione `Authorization`, valore
  `Bearer sk_live_…`.
- Richiesta: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  seguito dall'ID della variabile. Puoi anche cercare la chiamata tramite
  `external_call_id` usando l'ID dell'interazione.
- Instrada in base a `handoff.intent` e mostra `handoff.summary` alla persona che prende
  la chiamata.

Consulta [Cerca una chiamata trasferita](/api-reference/calls#look-up-a-handed-off-call).

## Testalo

Avvia una chiamata tramite il flusso Studio, chiedi all'agente di parlare con una persona e verifica
che il flusso prosegua oltre il componente con l'ID di hand-off nella relativa
variabile. Quindi apri la chiamata con `GET /v1/calls/{call_id}`:
`external_call_id` dovrebbe essere l'ID dell'interazione Talkdesk.

## Limiti

- Talkdesk legge al massimo 256 byte di UUI e non consente valori separati da
  `|` o `;`, quindi invia un singolo valore. L'ID di hand-off è compatibile.
- Le API di Talkdesk non possono leggere la trascrizione dell'agente. Usa invece la ricerca dell'hand-off o
  `GET /v1/calls/{call_id}`.
