> 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. # Integrazione nativa Twilio ## Panoramica Questa guida mostra come collegare un numero di telefono Twilio al tuo agente ElevenLabs per gestire sia le chiamate in entrata sia quelle in uscita. Imparerai a: * Importare un numero di telefono Twilio esistente. * Collegarlo al tuo agente per gestire le chiamate in entrata. * Avviare chiamate in uscita usando il tuo agente. ## Tipi di numeri di telefono e funzionalità ElevenLabs supporta due tipi di numeri di telefono Twilio con funzionalità diverse: ### Numeri Twilio acquistati (supporto completo) * **Chiamate in entrata**: supportate: possono ricevere chiamate e inoltrarle agli agenti * **Chiamate in uscita**: supportate: possono effettuare chiamate usando gli agenti * **Requisiti**: il numero deve essere acquistato tramite Twilio e comparire nella sezione "Phone Numbers" ### ID chiamante verificati (solo chiamate in uscita) * **Chiamate in entrata**: non supportate: non possono ricevere chiamate né essere assegnati agli agenti * **Chiamate in uscita**: supportate: possono effettuare chiamate usando gli agenti * **Requisiti**: il numero deve essere verificato nella sezione "Verified Caller IDs" di Twilio * **Caso d'uso**: ideale per usare il tuo numero aziendale esistente per chiamate IA in uscita Scopri di più sulla [verifica degli ID chiamante su larga scala](https://www.twilio.com/docs/voice/api/verifying-caller-ids-scale) nella documentazione di Twilio. > **Note** > > Durante l'importazione del numero di telefono, ElevenLabs rileva automaticamente le funzionalità del numero in base > alla sua configurazione in Twilio. ## Guida ### Prerequisiti * Un [account Twilio](https://twilio.com/). * Uno dei seguenti: * Un [numero di telefono](https://www.twilio.com/docs/phone-numbers) Twilio acquistato e predisposto (per chiamate in entrata e in uscita) * OPPURE un [ID chiamante verificato](https://www.twilio.com/docs/voice/make-calls#verify-your-caller-id) in Twilio (solo per chiamate in uscita) #### Importa un numero di telefono Twilio Nella dashboard di ElevenAgents, vai alla scheda [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers). ![Pagina dei numeri di telefono di ElevenAgents](/docs/_fern-img/7efb681147acd8f04803f84ed7f3289f0e90eb1fb0173e2a825836408cee89d1.webp) Quindi, inserisci i seguenti dati: * **Etichetta:** un nome descrittivo (ad esempio, `Linea assistenza clienti`). * **Numero di telefono:** il numero Twilio che vuoi usare. * **SID Twilio:** il SID del tuo account Twilio o il SID della chiave API. * **Token Twilio:** il token di autenticazione Twilio o il segreto della chiave API. > **Tip** > > **Consigliato: usa le chiavi API per una maggiore sicurezza.** Invece di usare le credenziali dell'intero account, puoi [creare una chiave API Twilio](https://www.twilio.com/docs/iam/api-keys) con autorizzazioni limitate. Quando crei una chiave API, Twilio fornisce un **SID** (che inizia con `SK`) e un **Secret**: usali nei campi sopra. > **Note** > > Puoi trovare il SID dell'account e il token di autenticazione [**nella console di amministrazione Twilio**](https://www.twilio.com/console), oppure creare chiavi API nella [sezione delle chiavi API](https://www.twilio.com/console/project/api-keys). #### Dashboard ElevenAgents ![Configurazione del numero di telefono](/docs/_fern-img/9501110d58bfeca27cb9983bc44035864504bdc2ed9c78d9decbd04802f64418.webp) #### Console di amministrazione Twilio Copia il SID Twilio e il token di autenticazione dalla [console di amministrazione Twilio](https://www.twilio.com/console). ![Dettagli del numero di telefono](/docs/_fern-img/42da512d1cdfb4ca4504c3162fecfed108580d9488236a0cc6a4a1d23a19da14.webp) > **Note** > > ElevenLabs configura automaticamente il numero di telefono Twilio con le impostazioni corrette. #### Impostazioni applicate ![Configurazione del numero di telefono Twilio](/docs/_fern-img/b11d57a0aa588964bbd0117d2135c55592569a4bf051f00f17aa3ee632833a47.webp) > **Info** > > **Rilevamento del numero di telefono**: ElevenLabs rileverà automaticamente se il tuo numero supporta: > > * **Chiamate in entrata e in uscita**: numeri acquistati tramite Twilio > * **Solo chiamate in uscita**: numeri verificati come ID chiamante in Twilio > > Se il numero non viene trovato in nessuna delle due categorie, riceverai un errore che ti chiederà di verificare che esista nel tuo account Twilio. #### Assegna il tuo agente (solo numeri abilitati alle chiamate in entrata) Se il tuo numero di telefono supporta le chiamate in entrata, puoi assegnare un agente per gestirle. ![Seleziona un agente per le chiamate in entrata](/docs/_fern-img/b85c122ef8607527041516e789b0a19047cbf85a13cd3237ee5a7670683815a7.webp) > **Note** > > I numeri che supportano solo le chiamate in uscita (ID chiamante verificati) non possono essere assegnati agli agenti e > verranno mostrati come disabilitati nel menu a discesa dell'agente. Prova l'agente chiamando il numero di telefono. Ora è pronto per gestire le chiamate in entrata e interagire con i tuoi clienti. > **Tip** > > Monitora le prime chiamate nella [dashboard della cronologia chiamate](https://elevenlabs.io/app/agents/history) per assicurarti che tutto funzioni come previsto. ## Effettuare chiamate in uscita > **Info** > > Sia i numeri Twilio acquistati sia gli ID chiamante verificati possono essere usati per le chiamate in uscita. Il pulsante per le chiamate in uscita > sarà disabilitato per i numeri che non le supportano. Il numero di telefono Twilio importato può essere usato anche per avviare chiamate in uscita, in cui il tuo agente chiama un numero di telefono specificato. #### Avvia una chiamata in uscita Nella scheda [**Phone Numbers**](https://elevenlabs.io/app/agents/phone-numbers), trova il numero Twilio importato e fai clic sul pulsante **Outbound call**. ![Pulsante di chiamata in uscita](/docs/_fern-img/953a870b0ab0c0aa30872b3692260f0879f390d4b4b83c7f82e816385504034f.webp) #### Configura la chiamata Nella finestra modale Outbound Call: 1. Seleziona l'agente che gestirà la conversazione 2. Inserisci il numero di telefono da chiamare 3. Fai clic su **Send Test Call** per avviare la chiamata ![Configurazione della chiamata in uscita](/docs/_fern-img/f6b01412a68217661028e6924ce90089bdd5eaa693c8aeafbc321c632de921b7.webp) Una volta avviata, il destinatario riceverà una chiamata dal tuo numero Twilio. Quando risponde, il tuo agente inizierà la conversazione. > **Tip** > > Le chiamate in uscita vengono visualizzate nella [dashboard della cronologia chiamate](https://elevenlabs.io/app/agents/history) > insieme alle chiamate in entrata, così puoi rivedere tutte le conversazioni. > **Note** > > Quando effettua chiamate in uscita, il tuo agente avvia la conversazione. Assicurati quindi che abbia > messaggi iniziali adeguati configurati per iniziarla in modo efficace.