BereitstellenTelefonieTwilio

Twilio-Personalisierung

Konfigurieren Sie die Personalisierung für eingehende Twilio-Anrufe mit Webhooks.

Überblick

Bei eingehenden Twilio-Anrufen können Sie Daten zur Gesprächsinitiierung dynamisch über einen Webhook abrufen. So können Sie das Verhalten Ihres Agenten anhand von Anruferinformationen und anderen Kontextdaten anpassen.

Informationen dazu, wann der Webhook ausgelöst wird und wie die Anfrage aufgebaut ist, finden Sie unter Webhooks zur Gesprächsinitiierung.

So funktioniert es

  1. Wenn ein Twilio-Anruf eingeht, ruft ElevenAgents Ihren angegebenen Endpunkt per Webhook auf und übergibt Anrufinformationen (caller_id, agent_id, called_number, call_sid, conversation_id) als Argumente.
  2. Ihr Webhook gibt Client-Daten zur Gesprächsinitiierung zurück, einschließlich dynamischer Variablen und Überschreibungen (siehe Beispiel unten).
  3. Diese Daten werden verwendet, um das Gespräch zu starten.

Das System nutzt die Verbindungs- bzw. Wählphase von Twilio, um Webhook-Daten parallel abzurufen. Dadurch entsteht ein nahtloses Erlebnis:

  • Nutzer hören den erwarteten Telefon-Verbindungston.
  • Parallel dazu ruft ElevenAgents die erforderlichen Webhook-Daten ab.
  • Wenn die Audioverbindung hergestellt ist, wird das Gespräch mit den abgerufenen Daten gestartet.

Konfiguration

1

Webhook-Details konfigurieren

Konfigurieren Sie auf der Einstellungsseite von ElevenAgents die Webhook-URL und fügen Sie alle für die Authentifizierung benötigten Secrets hinzu.

Webhook aktivieren

Klicken Sie auf den Webhook, um zu ändern, welche Secrets in den Headern gesendet werden.

Secrets zu Headern hinzufügen

2

Abruf von Daten zur Gesprächsinitiierung aktivieren

Aktivieren Sie im Tab „Security“ auf der Agentenseite den Abruf von Daten zur Gesprächsinitiierung für eingehende Twilio-Anrufe und definieren Sie Felder, die überschrieben werden können.

Webhook aktivieren

3

Webhook-Endpunkt für den Empfang von Twilio-Daten implementieren

Der Webhook erhält eine POST-Anfrage mit folgenden Parametern:

ParameterTypBeschreibung
caller_idstringTelefonnummer des Anrufers
agent_idstringID des Agenten, der den Anruf empfängt
called_numberstringAngerufene Twilio-Nummer
call_sidstringEindeutige Kennung des Twilio-Anrufs
conversation_idstringElevenLabs-Gesprächskennung
4

Client-Daten zur Gesprächsinitiierung zurückgeben

Ihr Webhook muss eine JSON-Antwort mit den Initiierungsdaten für den Agenten zurückgeben.

Das Feld dynamic_variables muss alle für den Agenten definierten dynamischen Variablen enthalten. Überschreibungen sind dagegen vollständig optional. Weitere Informationen zu dynamischen Variablen und Überschreibungen finden Sie in der Dokumentation zu dynamischen Variablen und Überschreibungen.

Eine mögliche Antwort:

{
  "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 verwendet die dynamischen Variablen, um die Daten zur Gesprächsinitiierung auszufüllen, und das Gespräch startet reibungslos.

Stellen Sie sicher, dass Ihr Webhook innerhalb eines angemessenen Zeitlimits antwortet, damit die Anrufbearbeitung nicht verzögert wird.

Sicherheit

  • Verwenden Sie ausschließlich HTTPS-Endpunkte.
  • Implementieren Sie die Authentifizierung über Anfrage-Header.
  • Speichern Sie sensible Werte als Secrets über den ElevenLabs Secrets Manager.
  • Validieren Sie die Parameter eingehender Anfragen.