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

# Personalizzazione Twilio

## Panoramica

Quando ricevi chiamate Twilio in entrata, puoi recuperare dinamicamente i dati di avvio della conversazione tramite un webhook. Questo ti consente di personalizzare il comportamento del tuo agente in base alle informazioni sul chiamante e ad altri dati contestuali.

Per sapere quando viene attivato il webhook e il formato della richiesta, consulta i [webhook di avvio della conversazione](/docs/it/eleven-agents/customization/personalization#conversation-initiation-webhooks).

## Come funziona

1. Quando viene ricevuta una chiamata Twilio, ElevenAgents effettua una chiamata webhook all'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 è mostrato di seguito)
3. Questi dati vengono usati per avviare la conversazione

> **Tip**
>
> Il sistema usa 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 previsto segnale 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](https://elevenlabs.io/app/agents/settings) di ElevenAgents, configura l'URL del webhook e aggiungi gli eventuali
segreti necessari per l'autenticazione.

![Abilita webhook](/docs/_fern-img/53e98b709e5751bfb6cf6758372a8105c5408b20191523c7e91c2a7625d8b603.webp)

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

![Aggiungi segreti agli header](/docs/_fern-img/416d30e6906cd209de92820bfc146ac9478fbb6ce61c8fbbc24d62cad54d9f05.webp)

#### Abilita il recupero dei dati di avvio della conversazione

Nella scheda "Sicurezza" della [pagina dell'agente](https://elevenlabs.io/app/agents/agents/), abilita il recupero dei dati di avvio della conversazione per le chiamate Twilio in entrata e definisci i campi che possono essere sovrascritti.

![Abilita webhook](/docs/_fern-img/6024b7f7541b8f856514b56ebf391cd6ee24206fd89c07327de1b01d81795c20.webp)

#### Implementa l'endpoint webhook per ricevere i dati Twilio

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

| Parametro         | Tipo   | Descrizione                                   |
| ----------------- | ------ | --------------------------------------------- |
| `caller_id`       | string | Il numero di telefono del chiamante           |
| `agent_id`        | string | L'ID dell'agente che riceve la chiamata       |
| `called_number`   | string | Il numero Twilio chiamato                     |
| `call_sid`        | string | Identificatore univoco della chiamata Twilio  |
| `conversation_id` | string | Identificatore della conversazione ElevenLabs |

#### Restituisci i dati client di avvio della conversazione

Il tuo webhook deve restituire una risposta JSON contenente i dati di avvio dell'agente.

> **Info**
>
> Il campo `dynamic_variables` deve contenere tutte le variabili dinamiche definite per l'agente. Gli override,
> invece, sono completamente facoltativi. Per ulteriori informazioni sulle variabili dinamiche e sugli
> override, consulta la documentazione sulle [variabili dinamiche](/docs/it/eleven-agents/customization/personalization/dynamic-variables) e sugli
> [override](/docs/it/eleven-agents/customization/personalization/overrides).

Un esempio di risposta potrebbe essere:

```json
{
  "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"
}
```

ElevenAgents userà le variabili dinamiche per popolare i dati di avvio della conversazione, che verrà avviata senza problemi.

> **Warning**
>
> Assicurati che il webhook risponda entro un timeout ragionevole per evitare di ritardare la gestione della chiamata.

## Sicurezza

* Usa solo endpoint HTTPS
* Implementa l'autenticazione tramite gli header della richiesta
* Archivia i valori sensibili come segreti tramite il [gestore dei segreti di ElevenLabs](https://elevenlabs.io/app/agents/settings)
* Convalida i parametri delle richieste in arrivo