Hoppa till navigering

Twilio-personalisering

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

Översikt

När du tar emot inkommande Twilio-samtal kan du hämta data för att starta konversationen dynamiskt 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 hur begäran ser ut finns i Webhooks för att starta konversationer.

Så fungerar det

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

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

  • Användare hör det förväntade telefonanslutningsljudet
  • Samtidigt hämtar ElevenAgents nödvändig webhook-data
  • Konversationen startas med de hämtade uppgifterna när ljudanslutningen har upprättats

Konfiguration

1

Konfigurera webhook-information

På inställningssidan i ElevenAgents konfigurerar du webhook-URL:en och lägger till eventuella hemligheter som behövs för autentisering.

Aktivera webhook

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

Lägg till hemligheter i rubriker

2

Aktivera hämtning av data för att starta konversationen

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

Aktivera webhook

3

Implementera webhook-slutpunkten för att ta emot Twilio-data

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

ParameterTypBeskrivning
caller_idstringTelefonnummer till uppringaren
agent_idstringID för agenten som tar emot samtalet
called_numberstringTwilio-numret som ringdes upp
call_sidstringUnik identifierare för Twilio-samtalet
conversation_idstringIdentifierare för ElevenLabs-konversationen
4

Returnera klientdata för att starta konversationen

Din webhook måste returnera ett JSON-svar som innehåller startdata 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 vara:

{
"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",
"starting_workflow_node_id": "node_xxxx",
"procedure_ids": ["agtprc_xxxx", "agtprc_yyyy"]
}

Svaret accepterar alla fält i klientdata för att starta konversationen, inklusive start_procedure_ids. starting_workflow_node_id kräver åsidosättningen Workflow start node, och procedure_ids och start_procedure_ids kräver åsidosättningen Procedures.

ElevenAgents använder de dynamiska variablerna för att fylla i data för att starta konversationen, och konversationen startar smidigt.

Se till att din webhook 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