Personalizzazione Twilio
Panoramica
Quando ricevi chiamate Twilio in entrata, puoi recuperare dinamicamente i dati di avvio della conversazione tramite un webhook. In questo modo puoi personalizzare il comportamento del tuo agente in base alle informazioni sul chiamante e ad altri dati contestuali.
Per sapere quando si attiva il webhook e la struttura della richiesta, consulta Webhook di avvio della conversazione.
Come funziona
- Quando viene ricevuta una chiamata Twilio, ElevenAgents effettua una chiamata webhook al tuo endpoint specificato, passando come argomenti le informazioni sulla chiamata (
caller_id,agent_id,called_number,call_sid,conversation_id) - Il tuo webhook restituisce i dati client di avvio della conversazione, incluse le variabili dinamiche e gli override (un esempio è riportato di seguito)
- Questi dati vengono utilizzati per avviare la conversazione
Il sistema utilizza il periodo di connessione/composizione di Twilio per recuperare i dati del webhook in parallelo, creando un’esperienza fluida in cui:
- Gli utenti sentono il consueto suono di connessione telefonica
- In parallelo, ElevenAgents recupera i dati webhook necessari
- La conversazione viene avviata con i dati recuperati quando viene stabilita la connessione audio
Configurazione
Configura i dettagli del webhook
Nella pagina delle impostazioni di ElevenAgents, configura l’URL del webhook e aggiungi i segreti necessari per l’autenticazione.

Fai clic sul webhook per modificare i segreti inviati negli header.

Abilita il recupero dei dati di avvio della conversazione
Nella scheda “Security” della pagina dell’agente, abilita il recupero dei dati di avvio della conversazione per le chiamate Twilio in entrata e definisci i campi che possono essere sovrascritti.

Implementa l'endpoint webhook per ricevere i dati Twilio
Il webhook riceverà una richiesta POST con i seguenti parametri:
Restituisci i dati client di avvio della conversazione
Il tuo webhook deve restituire una risposta JSON contenente i dati di avvio dell’agente.
Il campo dynamic_variables deve contenere tutte le variabili dinamiche definite per l’agente. Gli override,
invece, sono del tutto facoltativi. Per maggiori informazioni sulle variabili dinamiche e sugli
override, consulta la documentazione su variabili dinamiche e
override.
Un esempio di risposta potrebbe essere:
La risposta accetta ogni campo dei dati client di avvio della conversazione, incluso start_procedure_ids. starting_workflow_node_id richiede l’override Nodo iniziale del workflow, mentre procedure_ids e start_procedure_ids richiedono l’override Procedure.
ElevenAgents utilizzerà le variabili dinamiche per compilare i dati di avvio della conversazione, che verrà avviata senza problemi.
Assicurati che il tuo webhook risponda entro un timeout ragionevole per evitare ritardi nella gestione della chiamata.
Sicurezza
- Utilizza esclusivamente endpoint HTTPS
- Implementa l’autenticazione usando gli header della richiesta
- Archivia i valori sensibili come segreti tramite il gestore dei segreti di ElevenLabs
- Convalida i parametri delle richieste in entrata