Twilio-personalisatie

Configureer personalisatie voor inkomende Twilio-oproepen met webhooks.

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 voor informatie over wanneer de webhook wordt geactiveerd en de vorm van de request.

Zo werkt het

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
Je webhook retourneert clientgegevens voor het starten van het gesprek, waaronder dynamische variabelen en overrides (zie het onderstaande voorbeeld)
Deze gegevens worden gebruikt om het gesprek te starten

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 van ElevenAgents de webhook-URL en voeg eventuele secrets toe die nodig zijn voor authenticatie.

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

Ophalen van gegevens voor het starten van gesprekken inschakelen

Schakel op het tabblad “Security” van de agentpagina het ophalen van gegevens voor het starten van gesprekken voor inkomende Twilio-gesprekken in en definieer velden die kunnen worden overschreven.

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.

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

Een voorbeeldresponse kan zijn:

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

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
Valideer de parameters van inkomende requests