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

# SIP trunking Bandwidth

> **Note**
>
> Prima di seguire questa guida, ti consigliamo di leggere la [guida al SIP trunking ](/docs/it/eleven-agents/phone-numbers/sip-trunking) per capire come ElevenLabs supporta i SIP
> trunk.

## Panoramica

Questa guida spiega come collegare direttamente i tuoi SIP trunk Bandwidth a ElevenLabs Agents. Questa integrazione ti consente di usare i numeri di telefono e l'infrastruttura Bandwidth esistenti sfruttando le funzionalità avanzate di IA vocale di ElevenLabs, sia per le chiamate in entrata sia per quelle in uscita.

## Come funziona il SIP trunking con Bandwidth

Il SIP trunking stabilisce una connessione diretta tra la tua infrastruttura telefonica Bandwidth e la piattaforma ElevenLabs:

1. **Chiamate in entrata**: le chiamate da Bandwidth vengono instradate alla piattaforma ElevenLabs tramite il nostro URI di origine. Puoi configurarlo nell'app Bandwidth usando un Voice Configuration Package (VCP).
2. **Chiamate in uscita**: le chiamate avviate da ElevenLabs vengono instradate al tuo SIP trunk Bandwidth tramite il tuo FQDN realm o gli indirizzi SBC di terminazione, consentendo ai tuoi agenti di effettuare chiamate in uscita.
3. **Autenticazione**: Bandwidth fornisce l'autenticazione basata su SIP per i trunk Unified Communications (UC), usando l'autenticazione digest tramite credenziali SIP (network bridge). Questo metodo è essenziale per facilitare le chiamate in uscita da ElevenLabs e garantire comunicazioni sicure.
4. **Segnalazione e contenuti multimediali**: la configurazione iniziale della chiamata (segnalazione) usa UDP/TLS. Una volta stabilita la chiamata, i dati audio effettivi (stream RTP) vengono trasmessi tramite UDP.

## Requisiti

Prima di configurare l'integrazione del SIP trunk Bandwidth, assicurati di avere:

1. Un account ElevenLabs attivo
2. Un account Bandwidth Universal Platform attivo con SIP trunking abilitato (con sip-auth abilitato)
3. Almeno un numero di telefono acquistato o trasferito al tuo account Bandwidth
4. Accesso come amministratore al tuo account nell'[app Bandwidth](https://app.bandwidth.com/)

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

Configura le impostazioni di origine di Bandwidth per instradare le chiamate in entrata a ElevenLabs.

#### Accedi all'app Bandwidth

Accedi all'[app Bandwidth](https://app.bandwidth.com/).

#### Crea un Voice Configuration Package

1. Vai alla scheda **Service Management** e seleziona **Voice Configuration**.
2. Fai clic su **Create New** per iniziare a creare un nuovo Voice Configuration Package.
3. Inserisci un nome univoco per il pacchetto.
4. Fai clic su **Add Route**.
5. Scegli **Route to Domain Name**.
6. Inserisci nel campo apposito l'FQDN fornito da ElevenLabs. In genere è `sip.rtc.elevenlabs.io`. Se il tuo account ElevenLabs usa una regione isolata per la residenza dei dati o l'infrastruttura SIP statica, usa invece l'endpoint SIP corrispondente. Consulta [residenza dei dati](/docs/it/overview/administration/data-residency) per le regioni disponibili.
7. Fai clic su **Save** per completare la creazione del Voice Configuration Package.

> **Note**
>
> Consulta la [documentazione VCP di Bandwidth ](https://dev.bandwidth.com/docs/universal-platform/create-a-vcp) per ulteriori
> dettagli.

#### Verifica la formattazione E.164

Bandwidth invia le chiamate in entrata nel formato E.164. Quando importi il numero di telefono in ElevenLabs, usa lo stesso formato con un `+` iniziale (ad esempio, `+15551234567`).

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

Per le chiamate in uscita, ElevenLabs deve autenticarsi con Bandwidth. L'approccio consigliato è l'autenticazione SIP digest tramite un realm e credenziali.

#### Crea un realm

1. Nell'app Bandwidth, seleziona **Account** e fai clic su **SIP Credentials**.
2. Scorri fino a **Manage Realms** e fai clic su **Add**.
3. Inserisci un nome per il realm e una descrizione facoltativa, quindi fai clic su **Add**.

Bandwidth crea un FQDN realm nel formato `{realmname}.{hash}.auth.bandwidth.com`. Prendi nota di questo FQDN: lo userai come indirizzo in uscita in ElevenLabs.

> **Note**
>
> Se non visualizzi la scheda **SIP Credentials**, contatta il tuo Account Manager Bandwidth o apri un
> ticket con il supporto Bandwidth per abilitare l'autenticazione SIP sul tuo account.

#### Crea le credenziali SIP

1. Nella sezione **SIP Credentials**, fai clic su **Add**.
2. Inserisci **Username** e **Password**.
3. Seleziona il realm creato nel passaggio precedente.
4. Fai clic su **Add SIP Credentials**.

Conserva username e password in modo sicuro. Li inserirai nella configurazione del SIP trunk di ElevenLabs.

#### Annota il tuo FQDN realm

Il tuo indirizzo di terminazione in uscita è l'FQDN realm visualizzato dopo la creazione (ad esempio, `myrealm-a1b2c3.auth.bandwidth.com`). Inserisci questo hostname nel campo **Address** quando configuri le impostazioni in uscita in ElevenLabs.

Per verificare gli indirizzi IP SBC associati al tuo realm, esegui una ricerca SRV:

```bash
nslookup -type=SRV _sip._{udp/tls}.{realm_FQDN}
```

Bandwidth fornisce una coppia di IP SBC per la ridondanza. Entrambi devono essere raggiungibili per il traffico in uscita.

## Completa la configurazione in ElevenLabs

Dopo aver configurato queste impostazioni nell'app Bandwidth, importa il tuo numero di telefono in ElevenLabs:

#### Importa il numero di telefono del SIP trunk

Segui la [guida al SIP trunking](/docs/it/eleven-agents/phone-numbers/sip-trunking) per importare il tuo numero di telefono Bandwidth. Usa le seguenti impostazioni:

* **Tipo di trasporto**: UDP (o TLS se il tuo trunk Bandwidth usa la segnalazione crittografata)
* **Crittografia multimediale**: deve corrispondere alla configurazione del tuo trunk Bandwidth
* **Indirizzo in uscita**: il tuo FQDN realm (ad esempio, `myrealm-a1b2c3.auth.bandwidth.com`)
* **Username e password del SIP trunk**: le credenziali create nell'app Bandwidth

#### Assegna un agente

Dopo l'importazione, assegna un agente al numero di telefono nella [dashboard Numeri di telefono](https://elevenlabs.io/app/agents/phone-numbers).

> **Warning**
>
> Dopo aver configurato il tuo SIP trunk Bandwidth, segui la [guida al SIP trunking ](/docs/it/eleven-agents/phone-numbers/sip-trunking) per completare la configurazione in
> ElevenLabs.

## Risoluzione dei problemi

#### Le chiamate in entrata non riescono a connettersi

* Verifica che `sip.rtc.elevenlabs.io` sia inserito come destinazione della route nelle impostazioni di origine del tuo VCP Bandwidth.
* Conferma che il numero di telefono sia assegnato al VCP con le impostazioni di origine corrette.
* Assicurati che il formato del numero di telefono in ElevenLabs corrisponda al formato E.164 inviato da Bandwidth (con un `+` iniziale).
* Verifica che il firewall consenta il traffico di segnalazione SIP sul protocollo e sulla porta di trasporto configurati (5060 per UDP, 5061 per TLS) e che le porte RTP non siano bloccate.

#### Le chiamate in uscita ricevono errori 407 o di autenticazione

* Conferma che **username del SIP trunk**, **password** e **realm** in ElevenLabs corrispondano alle credenziali create nell'app Bandwidth.
* Verifica che il campo **Address** contenga solo l'hostname FQDN realm, senza il prefisso `sip:`.
* Assicurati che il tipo di trasporto nelle impostazioni in uscita di ElevenLabs corrisponda alla configurazione del tuo trunk Bandwidth (UDP o TLS).

#### Audio unidirezionale o assenza di audio

* Conferma che le porte RTP siano aperte per il traffico multimediale e non bloccate dal firewall.
* Verifica la compatibilità con il codec G711ulaw. Bandwidth ed ElevenLabs supportano entrambi G711.

## Domande frequenti

#### Quale trasporto e quali porte di segnalazione richiede Bandwidth?

Bandwidth ed ElevenLabs usano UDP sulla porta 5060 per la segnalazione SIP. Se il tuo trunk Bandwidth è configurato per il trasporto crittografato, usa invece TLS sulla porta 5061.

#### Quale formato di numero di telefono devo usare?

Usa il formato E.164 con un `+` iniziale (ad esempio, `+19192971100`). Bandwidth invia e si aspetta numeri in questo formato.

#### Quali codec audio sono compatibili?

ElevenLabs supporta G711 e G722. Bandwidth supporta G711ulaw e G729a. G711ulaw è il codec consigliato per la compatibilità tra entrambe le piattaforme.

## Link utili

* [Guida al SIP trunking](/docs/it/eleven-agents/phone-numbers/sip-trunking)
* [Riferimento SIP](/docs/it/eleven-agents/phone-numbers/sip-reference)
* [Guida all'integrazione del trunking UC Bandwidth](https://www.bandwidth.com/support/en/articles/12822954-uc-trunking-integration-guide)
* [Configurazione dell'autenticazione SIP Bandwidth](https://www.bandwidth.com/support/en/articles/12823069-sip-authentication-network-bridge-setup-and-configuration)
* [Gestione dei Voice Configuration Package Bandwidth](https://www.bandwidth.com/support/en/articles/12823404-managing-voice-configuration-packages-on-the-universal-platform)
* [Guida a Universal Platform](https://www.bandwidth.com/support/en/collections/12889706-universal-platform)