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

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.

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

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

ElevenAgents verstuurt de bellercontext in de requestbody:

{
  "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. Deze webhook staat los van webhooks na een gesprek.

De juiste aanpak kiezen

Meer informatie

• Documentatie over dynamische variabelen
• Documentatie over overschrijvingen
• Twilio-personalisatie