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

# Personalisatie

## Overzicht

Met personalisatie kun je het gedrag van je agent aanpassen aan elke individuele gebruiker, voor natuurlijkere en contextueel relevantere gesprekken. ElevenLabs biedt meerdere manieren voor personalisatie:

1. **Dynamische variabelen** - Voeg runtimewaarden toe aan prompts en berichten
2. **Overschrijvingen** - Vervang systeemprompts of berichten volledig
3. **Webhooks voor gespreksinitiatie** - Haal die gegevens van je server op wanneer een gesprek begint

## Personalisatiemethoden

#### [Dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables)

Definieer runtimewaarden met de syntaxis `{{ var_name }}` om de berichten, systeemprompts
en tools van je agent te personaliseren.

#### [Overschrijvingen](/docs/nl/eleven-agents/customization/personalization/overrides)

Vervang systeemprompts, eerste berichten, taal- of steminstellingen volledig voor elk
gesprek.

#### [Webhooks voor gespreksinitiatie](/docs/nl/eleven-agents/customization/personalization#conversation-initiation-webhooks)

Haal dynamische variabelen en overschrijvingen op van je server voor inkomende gesprekken.

## Datastructuur voor gespreksinitiatie door de client

Het object `conversation_initiation_client_data` bepaalt wat je kunt aanpassen wanneer je een gesprek start. Clients kunnen het rechtstreeks versturen. Een webhook voor gespreksinitiatie retourneert hetzelfde object.

```json
{
  "type": "conversation_initiation_client_data",
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "prompt": "overriding system prompt",
        "llm": "gpt-5.6-luna"
      },
      "first_message": "overriding first message",
      "language": "en"
    },
    "tts": {
      "voice_id": "voice-id-here"
    },
    "conversation": {
      "text_only": false
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso"]
    }
  },
  "custom_llm_extra_body": {
    "temperature": 0.7,
    "max_tokens": 100
  },
  "dynamic_variables": {
    "string_var": "text value",
    "number_var": 1.2,
    "integer_var": 123,
    "boolean_var": true
  },
  "user_id": "your_custom_user_id",
  "branch_id": "agtbrch_xxxx",
  "environment": "production"
}
```

> **Warning**
>
> Dynamische systeemvariabelen (met het voorvoegsel `system__`) kunnen niet worden verstuurd of
> overschreven in de initiatiepayload van de client. Alleen aangepaste dynamische variabelen kun je
> instellen via het veld `dynamic_variables`.

## Webhooks voor gespreksinitiatie

Voor inkomende telefonie en berichten kan ElevenAgents deze initiatiegegevens ophalen van je server in plaats van van de client. Wanneer de webhook is ingeschakeld, stuurt ElevenAgents een `POST`-request en past het de JSON toe die je retourneert.

Configureer de webhook-URL en headersecrets in [Agents-instellingen](https://elevenlabs.io/app/agents/settings). Schakel op het tabblad **Beveiliging** van de agent **Initiatiegegevens van de client ophalen via een webhook** in, evenals alle overschrijvingsvelden die je response kan bevatten.

De webhook wordt uitgevoerd voor een nieuw inkomend gesprek via Twilio Voice, Exotel, SIP-trunk, WhatsApp of Twilio SMS wanneer initiatiegegevens van de client nog niet aanwezig zijn. Hij wordt ook uitgevoerd voor sessies van [Amazon Connect](/docs/nl/eleven-agents/phone-numbers/c-caa-s-integrations/amazon-connect#dynamic-variables), waarbij je response wordt samengevoegd met de contactcontext die Amazon Connect verstrekt.

Uitgaande gesprekken via Twilio Voice, Exotel, SIP en WhatsApp activeren hem alleen als het uitgaande request geen `conversation_initiation_client_data` bevatte. Uitgaande WhatsApp-berichten activeren hem nooit — geef in plaats daarvan dynamische variabelen mee in het uitgaande request.

Hij wordt niet uitgevoerd voor widget- of SDK-gesprekken, andere berichtenintegraties of hervatte WhatsApp- en SMS-threads.

> **Warning**
>
> Preview-gesprekken die je start vanaf de instellingenpagina van de agent activeren geen webhooks
> voor gespreksinitiatie. Gebruik tijdens het testen in Preview de placeholders voor **Dynamische
> variabelen** in de agenteditor. Deze placeholders worden niet gebruikt in inkomende
> productiegesprekken.

ElevenAgents verstuurt de bellercontext in de requestbody:

```json
{
  "caller_id": "+15551234567",
  "called_number": "+15557654321",
  "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
  "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "conversation_id": "conv_8901k5zvyjhmfg983brhmhkd98n6"
}
```

`caller_id` en `called_number` zijn telefoonnummers op Twilio, Exotel, SIP en SMS. Bij inkomende WhatsApp zijn dit de WhatsApp-gebruikers-ID en de ID van je WhatsApp-telefoonnummer. Bij uitgaande gesprekken is `caller_id` je nummer en is `called_number` de persoon die wordt gebeld. `call_sid` is de call SID van de provider voor telefonie en een lege tekenreeks voor WhatsApp, SMS en Amazon Connect. SIP-gesprekken kunnen ook `call_id` en `sip_headers` bevatten. Amazon Connect-sessies bevatten `call_id` ingesteld op de contact-ID.

Je response moet de bovenstaande structuur `conversation_initiation_client_data` gebruiken. Neem elke aangepaste dynamische variabele op die de agent definieert. Overschrijvingen zijn optioneel en moeten zijn ingeschakeld in **Beveiliging**. De HTTP-responsebody mag maximaal 256 KB (262.144 bytes) zijn.

Een mislukte webhook of een webhook met time-out kan voorkomen dat het gesprek start. Zie voor de Twilio-configuratie [Twilio-personalisatie](/docs/nl/eleven-agents/customization/personalization/twilio-personalization). Deze webhook staat los van [webhooks na een gesprek](/docs/nl/eleven-agents/workflows/post-call-webhooks).

## De juiste aanpak kiezen

<thead>
  <tr>
    <th>
      Methode
    </th>

    <th>
      Meest geschikt voor
    </th>

    <th>
      Implementatie
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      **Dynamische variabelen**
    </td>

    <td>
      * Gebruikersspecifieke gegevens invoegen in content met templates - Consistent
        agentgedrag behouden met gepersonaliseerde details - Toolparameters personaliseren
    </td>

    <td>
      Definieer variabelen met 

      `{{ variable_name }}`

       en geef waarden mee tijdens runtime
    </td>
  </tr>

  <tr>
    <td>
      **Overschrijvingen**
    </td>

    <td>
      * Agentgedrag volledig wijzigen per gebruiker - Talen of stemmen wisselen - Verouderde
        applicaties (overweeg te migreren naar dynamische variabelen)
    </td>

    <td>
      Schakel specifieke rechten voor overschrijvingen in bij de beveiligingsinstellingen en geef
      volledige vervangende content mee
    </td>
  </tr>

  <tr>
    <td>
      **Webhooks voor gespreksinitiatie**
    </td>

    <td>
      * Inkomende Twilio-, SIP-, WhatsApp- of SMS-gesprekken personaliseren vanaf je server -
        Bellercontext opzoeken voordat het gesprek begint
    </td>

    <td>
      Schakel de webhook in bij de beveiligingsinstellingen en retourneer `conversation_initiation_client_data`
    </td>
  </tr>
</tbody>

## Meer informatie

* [Documentatie over dynamische variabelen](/docs/nl/eleven-agents/customization/personalization/dynamic-variables)
* [Documentatie over overschrijvingen](/docs/nl/eleven-agents/customization/personalization/overrides)
* [Twilio-personalisatie](/docs/nl/eleven-agents/customization/personalization/twilio-personalization)