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

# Personnalisation Twilio

## Vue d’ensemble

Lorsque vous recevez des appels Twilio entrants, vous pouvez récupérer dynamiquement les données d’initialisation de la conversation via un webhook. Vous pouvez ainsi adapter le comportement de votre agent aux informations sur l’appelant et à d’autres données contextuelles.

Pour savoir à quel moment le webhook se déclenche et connaître le format de la requête, consultez les [webhooks d’initialisation de conversation](/docs/fr/eleven-agents/customization/personalization#conversation-initiation-webhooks).

## Fonctionnement

1. Lorsqu’un appel Twilio est reçu, ElevenAgents envoie une requête webhook au point de terminaison indiqué, en transmettant les informations d’appel (`caller_id`, `agent_id`, `called_number`, `call_sid`, `conversation_id`) comme arguments
2. Votre webhook renvoie les données client d’initialisation de la conversation, y compris les variables dynamiques et les remplacements (un exemple est présenté ci-dessous)
3. Ces données servent à initialiser la conversation

> **Tip**
>
> Le système exploite la période de connexion et de numérotation de Twilio pour récupérer les données du webhook en parallèle, afin d’offrir une expérience fluide :
>
> * Les utilisateurs entendent le son de connexion téléphonique attendu
> * En parallèle, ElevenAgents récupère les données webhook nécessaires
> * La conversation est initialisée avec les données récupérées au moment où la connexion audio est établie

## Configuration

#### Configurer les détails du webhook

Sur la [page des paramètres](https://elevenlabs.io/app/agents/settings) d’ElevenAgents, configurez l’URL du webhook et ajoutez les
secrets nécessaires à l’authentification.

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

Cliquez sur le webhook pour modifier les secrets envoyés dans les en-têtes.

![Ajouter des secrets aux en-têtes](/docs/_fern-img/416d30e6906cd209de92820bfc146ac9478fbb6ce61c8fbbc24d62cad54d9f05.webp)

#### Activer la récupération des données d’initialisation de la conversation

Dans l’onglet « Security » de la [page de l’agent](https://elevenlabs.io/app/agents/agents/), activez la récupération des données d’initialisation de la conversation pour les appels Twilio entrants et définissez les champs pouvant être remplacés.

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

#### Implémenter le point de terminaison webhook pour recevoir les données Twilio

Le webhook reçoit une requête POST avec les paramètres suivants :

| Paramètre         | Type   | Description                            |
| ----------------- | ------ | -------------------------------------- |
| `caller_id`       | string | Numéro de téléphone de l’appelant      |
| `agent_id`        | string | ID de l’agent qui reçoit l’appel       |
| `called_number`   | string | Numéro Twilio appelé                   |
| `call_sid`        | string | Identifiant unique de l’appel Twilio   |
| `conversation_id` | string | Identifiant de conversation ElevenLabs |

#### Renvoyer les données client d’initialisation de la conversation

Votre webhook doit renvoyer une réponse JSON contenant les données d’initialisation de l’agent.

> **Info**
>
> Le champ `dynamic_variables` doit contenir toutes les variables dynamiques définies pour l’agent. Les remplacements,
> quant à eux, sont entièrement facultatifs. Pour en savoir plus sur les variables dynamiques et les
> remplacements, consultez la documentation sur les [variables dynamiques](/docs/fr/eleven-agents/customization/personalization/dynamic-variables) et les
> [remplacements](/docs/fr/eleven-agents/customization/personalization/overrides).

Voici un exemple de réponse :

```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 utilise les variables dynamiques pour renseigner les données d’initialisation de la conversation, qui démarre alors sans interruption.

> **Warning**
>
> Assurez-vous que votre webhook répond dans un délai raisonnable afin d’éviter de retarder la prise
> en charge de l’appel.

## Sécurité

* Utilisez uniquement des points de terminaison HTTPS
* Implémentez l’authentification à l’aide des en-têtes de requête
* Stockez les valeurs sensibles sous forme de secrets via le [gestionnaire de secrets ElevenLabs](https://elevenlabs.io/app/agents/settings)
* Validez les paramètres des requêtes entrantes