Vai alla navigazione

Personalizzazione Twilio

Configura la personalizzazione per le chiamate Twilio in entrata tramite webhook.

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

  1. 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)
  2. Il tuo webhook restituisce i dati client di avvio della conversazione, incluse le variabili dinamiche e gli override (un esempio è riportato di seguito)
  3. 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

1

Configura i dettagli del webhook

Nella pagina delle impostazioni di ElevenAgents, configura l’URL del webhook e aggiungi i segreti necessari per l’autenticazione.

Abilita il webhook

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

Aggiungi segreti agli header

2

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.

Abilita il webhook

3

Implementa l'endpoint webhook per ricevere i dati Twilio

Il webhook riceverà una richiesta POST con i seguenti parametri:

ParametroTipoDescrizione
caller_idstringIl numero di telefono del chiamante
agent_idstringL’ID dell’agente che riceve la chiamata
called_numberstringIl numero Twilio chiamato
call_sidstringIdentificatore univoco della chiamata Twilio
conversation_idstringIdentificatore della conversazione ElevenLabs
4

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:

{
"type": "conversation_initiation_client_data",
"conversation_config_override": {
"agent": {
"prompt": {
"prompt": "The customer's bank account balance is $100. They are based in San Francisco.",
"llm": "gpt-5.6-luna"
},
"first_message": "Hi, how can I help you today?",
"language": "en"
},
"tts": {
"voice_id": "new-voice-id"
},
"conversation": {
"text_only": false
}
},
"dynamic_variables": {
"customer_name": "John Doe",
"account_status": "premium",
"last_interaction": "2026-01-15"
},
"branch_id": "agtbrch_xxxx",
"environment": "production",
"starting_workflow_node_id": "node_xxxx",
"procedure_ids": ["agtprc_xxxx", "agtprc_yyyy"]
}

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