Personalisierung

Überblick

Mit Personalisierung können Sie das Verhalten Ihres Agenten an einzelne Nutzer anpassen und so natürlichere, kontextrelevante Gespräche ermöglichen. ElevenLabs bietet mehrere Ansätze zur Personalisierung:

1. Dynamische Variablen – Laufzeitwerte in Prompts und Nachrichten einfügen
2. Überschreibungen – System-Prompts oder Nachrichten vollständig ersetzen
3. Webhooks zur Gesprächsinitiierung – Diese Daten beim Start eines Gesprächs von Ihrem Server abrufen

Personalisierungsmethoden

Datenstruktur zur Gesprächsinitiierung

Das Objekt conversation_initiation_client_data definiert, was beim Start eines Gesprächs angepasst werden kann. Clients können es direkt senden. Ein Webhook zur Gesprächsinitiierung gibt dasselbe Objekt zurück.

{
  "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 zur Gesprächsinitiierung

Für eingehende Telefonie und Nachrichten kann ElevenAgents diese Initiierungsdaten von Ihrem Server abrufen, statt vom Client. Wenn der Webhook aktiviert ist, sendet ElevenAgents eine POST-Anfrage und übernimmt das JSON, das Sie zurückgeben.

Konfigurieren Sie die Webhook-URL und Header-Secrets in den Agent-Einstellungen. Aktivieren Sie auf dem Tab Sicherheit des Agenten Initiierungs-Client-Daten über einen Webhook abrufen sowie alle Überschreibungsfelder, die Ihre Antwort enthalten kann.

Der Webhook wird für ein neues eingehendes Gespräch über Twilio Voice, Exotel, SIP-Trunk, WhatsApp oder Twilio SMS ausgeführt, wenn noch keine Initiierungs-Client-Daten vorhanden sind. Er wird auch für Sitzungen von Amazon Connect ausgeführt. Dort wird Ihre Antwort mit dem Kontaktkontext zusammengeführt, den Amazon Connect bereitstellt.

Ausgehende Twilio-Voice-, Exotel-, SIP- und WhatsApp-Anrufe lösen ihn nur aus, wenn die ausgehende Anfrage kein conversation_initiation_client_data enthielt. Ausgehende WhatsApp-Nachrichten lösen ihn nie aus – übergeben Sie stattdessen dynamische Variablen in der ausgehenden Anfrage.

Er wird nicht für Widget- oder SDK-Gespräche, andere Messaging-Integrationen oder fortgesetzte WhatsApp- und SMS-Threads ausgeführt.

ElevenAgents sendet Anruferkontext im Anfragetext:

{
  "caller_id": "+15551234567",
  "called_number": "+15557654321",
  "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
  "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "conversation_id": "conv_8901k5zvyjhmfg983brhmhkd98n6"
}

caller_id und called_number sind Telefonnummern für Twilio, Exotel, SIP und SMS. Bei eingehendem WhatsApp sind sie die WhatsApp-Nutzer-ID und die ID Ihrer WhatsApp-Telefonnummer. Bei ausgehenden Anrufen ist caller_id Ihre Nummer und called_number die angerufene Person. call_sid ist die Call-SID des Anbieters bei Telefonie und eine leere Zeichenfolge bei WhatsApp, SMS und Amazon Connect. SIP-Anrufe können auch call_id und sip_headers enthalten. Bei Amazon-Connect-Sitzungen ist call_id auf die Kontakt-ID gesetzt.

Ihre Antwort muss die oben dargestellte Struktur von conversation_initiation_client_data verwenden. Schließen Sie jede benutzerdefinierte dynamische Variable ein, die der Agent definiert. Überschreibungen sind optional und müssen unter Sicherheit aktiviert sein. Der HTTP-Antworttext darf maximal 256 KB (262.144 Byte) groß sein.

Ein fehlgeschlagener Webhook oder ein Webhook-Timeout kann verhindern, dass das Gespräch startet. Informationen zur Twilio-Einrichtung finden Sie unter Twilio-Personalisierung. Dieser Webhook ist von Webhooks nach dem Anruf getrennt.

Den richtigen Ansatz wählen

Weitere Informationen

• Dokumentation zu dynamischen Variablen
• Dokumentation zu Überschreibungen
• Twilio-Personalisierung