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

# Twilio-personalisatie

## Overzicht

Wanneer je inkomende Twilio-gesprekken ontvangt, kun je via een webhook dynamisch gegevens ophalen om een gesprek te starten. Hiermee kun je het gedrag van je agent aanpassen op basis van informatie over de beller en andere contextuele gegevens.

Zie [Webhooks voor het starten van gesprekken](/docs/nl/eleven-agents/customization/personalization#conversation-initiation-webhooks) voor informatie over wanneer de webhook wordt geactiveerd en de vorm van de request.

## Zo werkt het

1. Wanneer een Twilio-gesprek wordt ontvangen, doet ElevenAgents een webhookaanroep naar je opgegeven endpoint en geeft het gespreksinformatie (`caller_id`, `agent_id`, `called_number`, `call_sid`, `conversation_id`) mee als argumenten
2. Je webhook retourneert clientgegevens voor het starten van het gesprek, waaronder dynamische variabelen en overrides (zie het onderstaande voorbeeld)
3. Deze gegevens worden gebruikt om het gesprek te starten

> **Tip**
>
> Het systeem gebruikt de verbindings-/belperiode van Twilio om parallel webhookgegevens op te halen, voor een
> naadloze ervaring waarbij:
>
> * Gebruikers het verwachte geluid van een telefoonverbinding horen
> * ElevenAgents parallel de benodigde webhookgegevens ophaalt
> * Het gesprek met de opgehaalde gegevens wordt gestart zodra de audioverbinding tot stand is gebracht

## Configuratie

#### Webhookgegevens configureren

Configureer op de [instellingenpagina](https://elevenlabs.io/app/agents/settings) van ElevenAgents de webhook-URL en voeg eventuele
secrets toe die nodig zijn voor authenticatie.

![Webhook inschakelen](/docs/_fern-img/53e98b709e5751bfb6cf6758372a8105c5408b20191523c7e91c2a7625d8b603.webp)

Klik op de webhook om te wijzigen welke secrets in de headers worden verzonden.

![Secrets aan headers toevoegen](/docs/_fern-img/416d30e6906cd209de92820bfc146ac9478fbb6ce61c8fbbc24d62cad54d9f05.webp)

#### Ophalen van gegevens voor het starten van gesprekken inschakelen

Schakel op het tabblad "Security" van de [agentpagina](https://elevenlabs.io/app/agents/agents/) het ophalen van gegevens voor het starten van gesprekken voor inkomende Twilio-gesprekken in en definieer velden die kunnen worden overschreven.

![Webhook inschakelen](/docs/_fern-img/6024b7f7541b8f856514b56ebf391cd6ee24206fd89c07327de1b01d81795c20.webp)

#### Het webhook-endpoint implementeren om Twilio-gegevens te ontvangen

De webhook ontvangt een POST-request met de volgende parameters:

| Parameter         | Type   | Beschrijving                                 |
| ----------------- | ------ | -------------------------------------------- |
| `caller_id`       | string | Het telefoonnummer van de beller             |
| `agent_id`        | string | De ID van de agent die het gesprek ontvangt  |
| `called_number`   | string | Het Twilio-nummer dat is gebeld              |
| `call_sid`        | string | Unieke identificatie voor het Twilio-gesprek |
| `conversation_id` | string | Gespreksidentificatie van ElevenLabs         |

#### Clientgegevens voor het starten van gesprekken retourneren

Je webhook moet een JSON-response retourneren met de startgegevens voor de agent.

> **Info**
>
> Het veld `dynamic_variables` moet alle dynamische variabelen bevatten die voor de agent zijn gedefinieerd. Overrides
> zijn daarentegen volledig optioneel. Zie voor meer informatie over dynamische variabelen en
> overrides de documentatie over [dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables) en
> [overrides](/docs/nl/eleven-agents/customization/personalization/overrides).

Een voorbeeldresponse kan zijn:

```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 gebruikt de dynamische variabelen om de gegevens voor het starten van het gesprek in te vullen, waarna het gesprek soepel begint.

> **Warning**
>
> Zorg dat je webhook binnen een redelijke time-outperiode reageert om vertraging bij de afhandeling van het gesprek
> te voorkomen.

## Beveiliging

* Gebruik alleen HTTPS-endpoints
* Implementeer authenticatie met requestheaders
* Sla gevoelige waarden op als secrets via de [ElevenLabs-secretsmanager](https://elevenlabs.io/app/agents/settings)
* Valideer de parameters van inkomende requests