> 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. # 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 #### [Dynamische Variablen](/docs/de/eleven-agents/customization/personalization/dynamic-variables) Definieren Sie Laufzeitwerte mit der Syntax `{{ var_name }}`, um die Nachrichten, System- Prompts und Tools Ihres Agenten zu personalisieren. #### [Überschreibungen](/docs/de/eleven-agents/customization/personalization/overrides) Ersetzen Sie System-Prompts, erste Nachrichten, Sprach- oder Stimmeinstellungen für jedes Gespräch vollständig. #### [Webhooks zur Gesprächsinitiierung](/docs/de/eleven-agents/customization/personalization#conversation-initiation-webhooks) Rufen Sie für eingehende Gespräche dynamische Variablen und Überschreibungen von Ihrem Server ab. ## 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. ```json { "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" } ``` > **Warning** > > System-Dynamische Variablen (mit dem Präfix `system__`) können nicht in der Client- > Initiierungsnutzlast gesendet oder überschrieben werden. Über das Feld `dynamic_variables` > können nur benutzerdefinierte dynamische Variablen festgelegt werden. ## 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](https://elevenlabs.io/app/agents/settings). 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](/docs/de/eleven-agents/phone-numbers/c-caa-s-integrations/amazon-connect#dynamic-variables) 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. > **Warning** > > Vorschaugespräche, die auf der Seite mit den Agent-Einstellungen gestartet werden, lösen keine > Webhooks zur Gesprächsinitiierung aus. Verwenden Sie beim Testen in der Vorschau die Platzhalter > **Dynamische Variablen** im Agent-Editor. Diese Platzhalter werden nicht für eingehende > Produktionsgespräche verwendet. ElevenAgents sendet Anruferkontext im Anfragetext: ```json { "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](/docs/de/eleven-agents/customization/personalization/twilio-personalization). Dieser Webhook ist von [Webhooks nach dem Anruf](/docs/de/eleven-agents/workflows/post-call-webhooks) getrennt. ## Den richtigen Ansatz wählen Methode Am besten geeignet für Implementierung **Dynamische Variablen** * Einfügen nutzerspezifischer Daten in Vorlageninhalte - Beibehalten eines einheitlichen Agentenverhaltens mit personalisierten Details - Personalisieren von Tool-Parametern Definieren Sie Variablen mit `{{ variable_name }}` und übergeben Sie Werte zur Laufzeit **Überschreibungen** * Vollständiges Ändern des Agentenverhaltens je Nutzer - Wechseln von Sprachen oder Stimmen - Legacy-Anwendungen (ziehen Sie eine Migration zu dynamischen Variablen in Betracht) Aktivieren Sie bestimmte Überschreibungsberechtigungen in den Sicherheitseinstellungen und übergeben Sie vollständige Ersatzinhalte **Webhooks zur Gesprächsinitiierung** * Personalisieren eingehender Twilio-, SIP-, WhatsApp- oder SMS-Gespräche über Ihren Server - Abrufen des Anruferkontexts vor Gesprächsbeginn Aktivieren Sie den Webhook in den Sicherheitseinstellungen und geben Sie `conversation_initiation_client_data` zurück ## Weitere Informationen * [Dokumentation zu dynamischen Variablen](/docs/de/eleven-agents/customization/personalization/dynamic-variables) * [Dokumentation zu Überschreibungen](/docs/de/eleven-agents/customization/personalization/overrides) * [Twilio-Personalisierung](/docs/de/eleven-agents/customization/personalization/twilio-personalization)