Twilio-personalisering

Konfigurera personalisering för inkommande Twilio-samtal med webhooks.

Översikt

När du tar emot inkommande Twilio-samtal kan du dynamiskt hämta data för samtalsinitiering via en webhook. Det gör att du kan anpassa agentens beteende utifrån information om uppringaren och annan kontextuell data.

Information om när webhooken utlöses och begärans struktur finns i webhookar för samtalsinitiering.

Så fungerar det

När ett Twilio-samtal tas emot gör ElevenAgents ett webhookanrop till din angivna slutpunkt och skickar samtalsinformation (caller_id, agent_id, called_number, call_sid, conversation_id) som argument
Din webhook returnerar klientdata för samtalsinitiering, inklusive dynamiska variabler och åsidosättningar (ett exempel visas nedan)
Dessa data används för att starta samtalet

Systemet använder Twilios anslutnings- och uppringningsperiod för att hämta webhookdata parallellt, vilket ger en smidig upplevelse där:

Användare hör det förväntade anslutningsljudet för telefonsamtal
Parallellt hämtar ElevenAgents nödvändiga webhookdata
Samtalet startas med de hämtade uppgifterna när ljudanslutningen har upprättats

Konfiguration

Konfigurera webhookuppgifter

Konfigurera webhook-URL:en och lägg till eventuella hemligheter som behövs för autentisering på inställningssidan i ElevenAgents.

Klicka på webhooken för att ändra vilka hemligheter som skickas i rubrikerna.

Aktivera hämtning av data för samtalsinitiering

På fliken “Security” på agentsidan aktiverar du hämtning av data för samtalsinitiering för inkommande Twilio-samtal och definierar fält som kan åsidosättas.

Implementera webhookslutpunkten för att ta emot Twilio-data

Webhooken tar emot en POST-begäran med följande parametrar:

Parameter	Typ	Beskrivning
`caller_id`	string	Telefonnummer till uppringaren
`agent_id`	string	ID för agenten som tar emot samtalet
`called_number`	string	Twilio-numret som ringdes upp
`call_sid`	string	Unik identifierare för Twilio-samtalet
`conversation_id`	string	ElevenLabs samtalsidentifierare

Returnera klientdata för samtalsinitiering

Din webhook måste returnera ett JSON-svar som innehåller initieringsdata för agenten.

Fältet dynamic_variables måste innehålla alla dynamiska variabler som definierats för agenten. Åsidosättningar är däremot helt valfria. Mer information om dynamiska variabler och åsidosättningar finns i dokumentationen om dynamiska variabler och åsidosättningar.

Ett exempelsvar kan se ut så här:

{
  "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 använder de dynamiska variablerna för att fylla i data för samtalsinitiering, och samtalet startar smidigt.

Se till att webhooken svarar inom en rimlig tidsgräns för att undvika att fördröja samtalshanteringen.

Säkerhet

Använd endast HTTPS-slutpunkter
Implementera autentisering med begäranderubriker
Lagra känsliga värden som hemligheter via ElevenLabs hemlighetshanterare
Validera parametrarna i inkommande begäranden