> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Trunking SIP Sinch

> **Note**
>
> Prima di seguire questa guida, ti consigliamo di leggere la [guida al trunking SIP di ElevenLabs ](/docs/it/eleven-agents/phone-numbers/sip-trunking) e la [guida al trunking SIP di Sinch Voice ](https://developers.sinch.com/docs/voice/api-reference/sip-trunking).

## Panoramica

Questa guida spiega come connettere direttamente un'applicazione Sinch Voice a ElevenLabs Agents. L'integrazione ti permette di mantenere i tuoi numeri e l'instradamento Sinch, mentre ElevenLabs gestisce l'esperienza dell'agente IA vocale.

## Come funziona il trunking SIP con Sinch

Un trunk SIP Sinch è una connessione bidirezionale tra la rete Sinch e la piattaforma ElevenLabs:

1. **Chiamate in entrata**: un DID assegnato alla tua applicazione Sinch Voice riceve una chiamata. Sinch invia l'`INVITE` all'indirizzo di origine ElevenLabs configurato come endpoint statico nelle impostazioni in entrata del trunk.
2. **Chiamate in uscita**: le chiamate avviate da ElevenLabs vengono inviate all'indirizzo SIP con nome di dominio completo (FQDN) della tua applicazione, che Sinch instrada alla PSTN.
3. **Autenticazione**: Sinch richiede l'autenticazione in uscita (credenziali SIP) e supporta l'autenticazione ACL (allowlist degli IP) per il traffico in arrivo sul trunk.

## Requisiti

Prima di iniziare, assicurati di avere:

1. Un account ElevenLabs attivo con un agente configurato
2. Un account Sinch con un'applicazione vocale creata nella [dashboard Sinch Build](https://dashboard.sinch.com/voice/apps)
3. Almeno un numero di telefono (DID) acquistato in Sinch e assegnato all'applicazione

## Configurazione delle chiamate in entrata (da Sinch a ElevenLabs)

Indirizza l'inoltro chiamate della tua applicazione all'indirizzo SIP di ElevenLabs.

### Accedi alla dashboard Sinch Build

Accedi al tuo account Sinch e vai all'applicazione che vuoi connettere.

### Aggiungi un endpoint statico per ElevenLabs

Nelle impostazioni di inoltro chiamate dell'applicazione, aggiorna il gestore degli eventi di chiamata a `SIP Forwarding` e aggiungi un URI SIP statico che punti all'indirizzo di origine ElevenLabs:

* **DID**: il numero di telefono Sinch che vuoi chiamare
* **Indirizzo**: `sip.rtc.elevenlabs.io`
* **Porta e trasporto**: `5061/TLS`, `5060/TCP`

Ad esempio: `sip:15551234567@sip.rtc.elevenlabs.io:5061;transport=tls`.

Se il tuo workspace ElevenLabs usa una regione isolata per la residenza dei dati o l'infrastruttura SIP con IP statico, usa l'endpoint corrispondente anziché `sip.rtc.elevenlabs.io`. Consulta la pagina sulla [residenza dei dati](/docs/it/overview/administration/data-residency) per le regioni disponibili.

### Assegna il tuo DID all'applicazione

Assegna a questa applicazione il numero di telefono che deve raggiungere il tuo agente.

## Configurazione delle chiamate in uscita (da ElevenLabs a Sinch)

Per le chiamate in uscita, ElevenLabs invia un `INVITE` SIP alla tua applicazione Sinch e si autentica con essa.

### Prendi nota dell'FQDN della tua regione Sinch

Recupera l'[FQDN SIP](https://developers.sinch.com/docs/voice/api-reference/sip-trunking#termination-uris) della tua regione Sinch. Questo è l'indirizzo di terminazione da inserire in ElevenLabs. Inserisci solo il nome host, senza il prefisso `sip:`.

### Inserisci le credenziali SIP

Copia in modo sicuro la chiave e il segreto della tua applicazione Sinch. Verranno usati come nome utente e password in ElevenLabs.

### Numero di inoltro

La tua applicazione Sinch inoltrerà la chiamata al suo indirizzo di inoltro. Per effettuare una chiamata in uscita al numero specificato nella richiesta di chiamata in uscita, lascia vuoto questo campo nelle impostazioni dell'applicazione.

## Completa la configurazione in ElevenLabs

### Importa il numero di telefono del trunk SIP

Segui la [guida al trunking SIP](/docs/it/eleven-agents/phone-numbers/sip-trunking) per importare il tuo numero Sinch, usando queste impostazioni:

| Impostazione              | Valore                                                                                  |
| ------------------------- | --------------------------------------------------------------------------------------- |
| Numero di telefono        | Il tuo DID Sinch, ad esempio `15551234567`                                              |
| Tipo di trasporto         | TLS                                                                                     |
| Crittografia dei media    | `Disabled` per TCP; `Allowed` o `Required` quando il trunk è configurato per TLS e SRTP |
| Indirizzo                 | FQDN del tuo trunk Sinch, solo nome host                                                |
| Nome utente del trunk SIP | Chiave dell'applicazione Sinch                                                          |
| Password del trunk SIP    | Segreto dell'applicazione Sinch                                                         |

Mantieni coerenti le impostazioni di trasporto e crittografia su entrambi i lati.

### Assegna un agente

Assegna un agente al numero nella [dashboard Phone Numbers](https://elevenlabs.io/app/agents/phone-numbers). Le chiamate in entrata al DID raggiungeranno ora quell'agente.

### Prova una chiamata in uscita

Effettua una chiamata dall'agente tramite la tua applicazione Sinch, usando il menu del numero di telefono o l'API per le chiamate in uscita:

```bash
curl -X POST https://api.elevenlabs.io/v1/convai/sip-trunk/outbound-call \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
    "agent_phone_number_id": "phnum_8901k4t9z5defmb8vh3e9361y7nj",
    "to_number": "+15551234567"
  }'
```

Consulta [Chiamata in uscita tramite trunk SIP](/docs/it/eleven-agents/api-reference/sip-trunk/outbound-call) per lo schema completo della richiesta e [Chiamate batch](/docs/it/eleven-agents/phone-numbers/batch-calls) per eseguire campagne in uscita.

## Configurazione dei trasferimenti

Gli agenti trasferiscono le chiamate a una persona tramite lo strumento di sistema [`transfer_to_number`](/docs/it/eleven-agents/customization/tools/system-tools/transfer-to-number).

> **Warning**
>
> Su un trunk Sinch funzionano solo i trasferimenti in conferenza. SIP REFER e i trasferimenti ciechi non funzionano.

### Trasferimenti in conferenza

ElevenLabs chiama la destinazione tramite il tuo trunk Sinch, unisce entrambe le parti in una conferenza, quindi disconnette l'agente.

## Usa invece Sinch Voice API v2

La configurazione precedente assegna a ElevenLabs l'intero percorso vocale. Se hai bisogno che Sinch gestisca il controllo delle chiamate, Sinch Voice API v2 può rispondere a una chiamata, applicare la propria logica e collegare una seconda tratta al tuo agente ElevenLabs tramite SVAML, senza un server relay. Questo modello è più adatto quando vuoi inserire funzionalità Sinch come il rilevamento della segreteria telefonica, la registrazione delle chiamate o il mascheramento del numero prima che l'agente partecipi, oppure quando l'agente è un passaggio in un flusso di chiamata Sinch più ampio.

Consulta il tutorial di Sinch [Integra un agente IA ElevenLabs tramite SIP](https://developers.sinch.com/docs/voice-2.0/tutorials/elevenlabs-sip) per altri scenari comuni.

## Risoluzione dei problemi

#### Le chiamate in entrata non si connettono

* Verifica che l'endpoint statico in entrata del trunk punti a `sip.rtc.elevenlabs.io` sulla porta e con il trasporto che intendi usare.
* Verifica che il DID sia assegnato a quel trunk.
* Controlla che il numero in ElevenLabs corrisponda a quello inviato da Sinch, incluso il `+` iniziale.
* Attendi almeno 60 secondi dopo aver modificato endpoint o ACL, quindi riprova.
* Verifica che il firewall consenta la segnalazione SIP sulla porta 5060 per TCP o 5061 per TLS e non blocchi RTP.

#### Le chiamate in uscita ricevono risposte 403 o 407

* Verifica che il nome utente e la password del trunk SIP in ElevenLabs corrispondano alle credenziali del trunk Sinch.
* Controlla che il campo **Indirizzo** contenga solo l'FQDN del trunk, senza il prefisso `sip:`.
* Verifica che le autorizzazioni per il Paese di destinazione siano abilitate sul trunk.
* Verifica che l'ID chiamante presentato sia un numero accettato da Sinch su quel trunk.
* Se ti affidi all'autenticazione ACL, ricorda che la segnalazione ElevenLabs proviene da un pool distribuito di indirizzi. Passa all'autenticazione digest o usa l'infrastruttura con IP statico.

#### Audio unidirezionale o assenza di audio

* Verifica che il firewall consenta RTP tramite UDP in entrambe le direzioni e non sia limitato a indirizzi statici specifici.
* Controlla che la crittografia dei media corrisponda: un trunk Sinch TLS richiede SRTP, quindi imposta la crittografia dei media su `Allowed` o `Required` in ElevenLabs.
* Esegui un test con TCP e crittografia dei media disabilitata per capire se il problema è correlato a TLS o SRTP.
* Verifica che G711 sia offerto sul trunk. ElevenLabs supporta G711 e G722.

#### Le chiamate non terminano dopo che l'agente riaggancia

Una risposta `481` a un `BYE` di solito significa che la richiesta ha raggiunto un server SIP senza lo stato della sessione per quella chiamata. Invia le richieste all'interno della sessione all'URI `Contact` restituito nel `200 OK`, anziché all'indirizzo condiviso `sip.rtc.elevenlabs.io`. Se `BYE` o `REFER` tramite TLS non supera la convalida del certificato, aggiungi l'FQDN per cui è emesso il certificato del trunk nel campo **Domini remoti** delle impostazioni del numero di telefono.

## FAQ

#### Quale trasporto devo usare?

TLS sulla porta 5061 per la produzione, abbinato ai media SRTP sul trunk Sinch. TCP sulla porta 5060 è un buon punto di partenza per la convalida. UDP è sperimentale su ElevenLabs e non deve gestire traffico di produzione.

#### Quali codec audio sono compatibili?

ElevenLabs supporta G711 (8 kHz) e G722 (16 kHz). Mantieni G711 disponibile sul trunk Sinch come opzione comune.

#### Come posso passare il contesto del chiamante nella conversazione?

Gli header `X-` personalizzati nell'`INVITE` in entrata sono esposti come variabili dinamiche; ad esempio, `X-Contact-ID` diventa `{{sip_contact_id}}`. `X-Call-ID` e `X-Caller-ID` corrispondono a `system__call_sid` e `system__caller_id`. Consulta [Trunking SIP](/docs/it/eleven-agents/phone-numbers/sip-trunking) per le regole di normalizzazione complete.

## Link utili

* [Guida al trunking SIP](/docs/it/eleven-agents/phone-numbers/sip-trunking)
* [Riferimento SIP](/docs/it/eleven-agents/phone-numbers/sip-reference)
* [Trasferisci al numero](/docs/it/eleven-agents/customization/tools/system-tools/transfer-to-number)
* [Sinch Voice API v2: integra un agente IA ElevenLabs tramite SIP](https://developers.sinch.com/docs/voice-2.0/tutorials/elevenlabs-sip)