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

# Twilio-personalisering

## Ö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](/docs/sv/eleven-agents/customization/personalization#conversation-initiation-webhooks).

## Så fungerar det

1. 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
2. Din webhook returnerar klientdata för samtalsinitiering, inklusive dynamiska variabler och åsidosättningar (ett exempel visas nedan)
3. Dessa data används för att starta samtalet

> **Tip**
>
> 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](https://elevenlabs.io/app/agents/settings) i ElevenAgents.

![Aktivera webhook](/docs/_fern-img/53e98b709e5751bfb6cf6758372a8105c5408b20191523c7e91c2a7625d8b603.webp)

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

![Lägg till hemligheter i rubriker](/docs/_fern-img/416d30e6906cd209de92820bfc146ac9478fbb6ce61c8fbbc24d62cad54d9f05.webp)

#### Aktivera hämtning av data för samtalsinitiering

På fliken "Security" på [agentsidan](https://elevenlabs.io/app/agents/agents/) aktiverar du hämtning av data för samtalsinitiering för inkommande Twilio-samtal och definierar fält som kan åsidosättas.

![Aktivera webhook](/docs/_fern-img/6024b7f7541b8f856514b56ebf391cd6ee24206fd89c07327de1b01d81795c20.webp)

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

> **Info**
>
> 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](/docs/sv/eleven-agents/customization/personalization/dynamic-variables) och
> [åsidosättningar](/docs/sv/eleven-agents/customization/personalization/overrides).

Ett exempelsvar kan se ut så här:

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

> **Warning**
>
> 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](https://elevenlabs.io/app/agents/settings)
* Validera parametrarna i inkommande begäranden