> 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. # Erste Schritte ## Was Sie erstellen Am Ende dieses Leitfadens beantwortet Ihr Agent WhatsApp-Textnachrichten und Sprachnachrichten über Ihre geschäftliche Nummer. Außerdem haben Sie eine per API initiierte Vorlagennachricht gesendet. Rechnen Sie mit etwa 20 Minuten sowie einer kurzen Wartezeit, bis Meta Ihre erste Vorlage genehmigt. ## Bevor Sie beginnen Sie benötigen: * Einen [ElevenLabs-Agenten](/docs/de/eleven-agents/quickstart). Jeder vorhandene Agent funktioniert. * Ein [Meta-Unternehmensportfolio](https://business.facebook.com/), das Sie verwalten können. * Eine Telefonnummer, die **nicht** derzeit in der WhatsApp-Business-App verwendet oder bei einem anderen WhatsApp-Anbieter registriert ist. Anderswo verwendete Nummern können nicht importiert werden — siehe [Einschränkungen](/docs/de/eleven-agents/whatsapp#limitations). * Eine Zahlungsmethode im [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/), wenn Sie Vorlagen senden oder Anrufe tätigen möchten. Meta rechnet diese separat von ElevenLabs ab. #### Ihr WhatsApp-Business-Konto importieren Gehen Sie zur [WhatsApp-Seite](https://elevenlabs.io/app/agents/whatsapp) und klicken Sie auf ***Konto importieren***. Dadurch wird der Autorisierungsablauf von Meta geöffnet. Dort wählen Sie das WhatsApp-Business-Konto und die Telefonnummer aus (oder erstellen sie) und erteilen ElevenLabs die Berechtigung, sie zu verwalten: ![WhatsApp-Autorisierungsablauf](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp) #### Agenten zuweisen und Verhalten festlegen Nach dem Import gelangen Sie zur Seite mit den Kontoeinstellungen. Weisen Sie einen Agenten zu — bis dahin werden eingehende Nachrichten ignoriert und eingehende Anrufe abgelehnt: ![WhatsApp-Kontoseite](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp) Konfigurieren Sie das Verhalten des Agenten für diese Nummer (die vollständige Referenz finden Sie unter [Kontoeinstellungen](/docs/de/eleven-agents/whatsapp#account-settings)): * **Messaging aktivieren** — ob der Agent überhaupt auf Nachrichten antwortet. Deaktivieren Sie dies, wenn ein anderes System Nachrichten verarbeitet und ElevenLabs nur Anrufe bearbeiten soll. * **Antwort auf Audionachrichten aktivieren** — wenn aktiviert, beantwortet der Agent Sprachnachrichten mit Sprachnachrichten in seiner eigenen Stimme; wenn deaktiviert, antwortet er immer mit Text. * **Tippindikator aktivieren** — wenn aktiviert, markiert der Agent eingehende Nachrichten als gelesen und zeigt während der Bearbeitung einen Tippindikator an. #### Ihre erste Unterhaltung führen Schreiben Sie Ihrer geschäftlichen Nummer von einem privaten Telefon aus. Der Agent antwortet. Senden Sie eine Sprachnachricht — sie wird für den Agenten transkribiert, und der Agent antwortet mit einer eigenen Sprachnachricht: ![WhatsApp-Textunterhaltung](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp) Die Unterhaltung erscheint währenddessen in Ihrem [Unterhaltungsverlauf](https://elevenlabs.io/app/agents/history). > **Info** > > Eine Nachrichtenunterhaltung endet, wenn der Agent das System-Tool ***Unterhaltung beenden*** verwendet, die > ***Maximale Unterhaltungsdauer*** abläuft oder nach der letzten Antwort des Agenten > das standardmäßige Inaktivitäts-Timeout von 15 Minuten verstreicht. Die nächste Nachricht des Nutzers startet eine neue > Unterhaltung. Mehr über [Unterhaltungs- Timeouts](/docs/de/eleven-agents/customization/conversation-flow#maximum-conversation-duration). #### Ihre erste ausgehende Nachricht senden Um einen Nutzer zuerst zu kontaktieren, benötigen Sie eine von Meta genehmigte **Nachrichtenvorlage** — WhatsApp erlaubt frei formulierte Geschäftsnachrichten nur innerhalb einer aktiven Unterhaltung. Erstellen Sie im [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates) eine einfache Utility-Vorlage, zum Beispiel: ```text Hi {{name}}, thanks for signing up. Reply here if you have any questions. ``` Sobald die Vorlage genehmigt ist, senden Sie sie: #### Python ```python from elevenlabs import ElevenLabs elevenlabs = ElevenLabs() elevenlabs.conversational_ai.whatsapp.outbound_message( whatsapp_phone_number_id="524029457612345", whatsapp_user_id="12213231492", template_name="welcome", template_language_code="en", template_params=[ { "type": "body", "parameters": [ {"type": "text", "parameter_name": "name", "text": "Daniele"} ], } ], agent_id="agent_9201kwcrbq9qfxaa2t8nnnkqf2w9", ) ``` #### TypeScript ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.whatsapp.outboundMessage({ whatsappPhoneNumberId: "524029457612345", whatsappUserId: "12213231492", templateName: "welcome", templateLanguageCode: "en", templateParams: [ { type: "body", parameters: [{ type: "text", parameterName: "name", text: "Daniele" }], }, ], agentId: "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9", }); ``` #### cURL ```bash curl -X POST https://api.elevenlabs.io/v1/convai/whatsapp/outbound-message \ -H "xi-api-key: $ELEVENLABS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "whatsapp_phone_number_id": "524029457612345", "whatsapp_user_id": "12213231492", "template_name": "welcome", "template_language_code": "en", "template_params": [ { "type": "body", "parameters": [ {"type": "text", "parameter_name": "name", "text": "Daniele"} ] } ], "agent_id": "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9" }' ``` Zwei Details sind hier wichtig: * `template_params` ist eine Liste von Komponentenobjekten — der Wrapper `{"type": "body", ...}` ist erforderlich. * `whatsapp_user_id` enthält nur Ziffern, mit Ländervorwahl und ohne `+` (zum Beispiel `14155552671`). Ihre `whatsapp_phone_number_id` finden Sie auf der [WhatsApp-Seite](https://elevenlabs.io/app/agents/whatsapp) über die Option ***Telefonnummer-ID kopieren*** im Kontomenü. Ihr Telefon empfängt die Vorlage. Antworten Sie darauf — der Agent übernimmt die Unterhaltung von dort aus. ## Wenn etwas nicht funktioniert hat * **Der Agent antwortet nie**: Der Nummer ist kein Agent zugewiesen oder **Messaging aktivieren** ist deaktiviert. Wenn das korrekt aussieht, prüfen Sie, ob der Agent [dynamische Variablen](/docs/de/eleven-agents/customization/personalization/dynamic-variables) benötigt — eine eingehende WhatsApp-Unterhaltung startet ohne vom Nutzer bereitgestellte Werte. Ein Agent, dessen Tools oder erste Nachricht einen solchen Wert benötigen, scheitert daher vor der Antwort, sofern ein Webhook zur Gesprächsinitiierung ihn nicht bereitstellt. Siehe [Initialisierungskontext](/docs/de/eleven-agents/whatsapp#initialization-context). * **Der Import schlägt fehl**: Die Nummer ist bereits bei einem anderen Anbieter oder in der WhatsApp-Business-App registriert. * **Die API hat 200 zurückgegeben, aber keine Nachricht ist angekommen**: Die Vorlage ist noch nicht genehmigt, die Parameter stimmen nicht mit der Vorlage überein oder Ihr WhatsApp-Business-Konto hat offene Zahlungen (Meta-Fehler 131042). * **Die Antwort des Nutzers hat eine separate Unterhaltung ohne Kontext gestartet**: Das Empfänger-ID-Format war falsch — siehe [Format der Empfängernummer](/docs/de/eleven-agents/whatsapp/outbound#recipient-number-format). Für alles Weitere siehe [Fehlerbehebung & FAQ](/docs/de/eleven-agents/whatsapp/troubleshooting). ## Nächste Schritte * Personalisieren Sie Unterhaltungen mit [dynamischen Variablen](/docs/de/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments) und den [Systemvariablen zur Personalisierung](/docs/de/eleven-agents/whatsapp#personalization). * Führen Sie Outreach im großen Maßstab mit [ausgehenden Nachrichten & Vorlagen](/docs/de/eleven-agents/whatsapp/outbound) durch. * Lassen Sie den Agenten mit [interaktiven Nachrichten](/docs/de/eleven-agents/whatsapp/interactive-messages) antippbare Auswahlmöglichkeiten anbieten. * Senden Sie mit [WhatsApp-Tools](/docs/de/eleven-agents/whatsapp/tools) WhatsApp-Nachrichten von Agenten auf anderen Kanälen. * Informieren Sie sich über Kosten in den [Preis-FAQ](/docs/de/eleven-agents/whatsapp/troubleshooting#faq).