> 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. # Fehlerbehebung und FAQ ## Nachricht akzeptiert, aber nicht zugestellt Eine `200`-Antwort vom Endpunkt für ausgehende Nachrichten bedeutet, dass ElevenLabs die Anfrage akzeptiert und weitergeleitet hat — die Zustellung liegt weiterhin bei Meta. Wenn die Nachricht nie ankommt, prüfen Sie der Reihe nach: 1. **Vorlagengenehmigung** — die Vorlage muss im Status „Genehmigt“ im [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates) sein. Ausstehende oder abgelehnte Vorlagen werden nicht zugestellt. 2. **Zahlungen** — eine fehlende Zahlungsmethode oder offene Zahlungen auf Ihrem WhatsApp-Unternehmenskonto blockieren die Zustellung von Vorlagen (Meta-Fehler 131042). Fügen Sie die Zahlungsmethode im WhatsApp Manager hinzu oder aktualisieren Sie sie. 3. **Parameterstruktur** — Einträge in `template_params` müssen Komponentenobjekte sein (`{"type": "body", "parameters": [...]}`), jeder Platzhalter in der Vorlage muss ausgefüllt sein und benannte Vorlagen benötigen bei jedem Wert ein `parameter_name`. Siehe [Vorlagenparameter](/docs/de/eleven-agents/whatsapp/outbound#template-parameters). 4. **Empfängerformat** — `whatsapp_user_id` enthält nur Ziffern einschließlich Landesvorwahl, ohne `+`. Siehe [Format der Empfängernummer](/docs/de/eleven-agents/whatsapp/outbound#recipient-number-format). 5. **Marketinglimits** — Meta begrenzt, wie viele [Marketingvorlagen](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/per-user-limits) ein Nutzer innerhalb eines Zeitraums erhalten kann (Fehler 131049). Utility-Vorlagen unterliegen diesem Limit nicht. ## Importprobleme * **Die Nummer kann nicht importiert werden** — sie ist bei einem anderen WhatsApp-Anbieter registriert oder in der WhatsApp-Business-App aktiv. Eine Nummer kann nur bei einem Anbieter registriert sein; siehe [Einschränkungen](/docs/de/eleven-agents/whatsapp#limitations). * **Ihre WABA erscheint nicht im Importablauf** — bestätigen Sie, dass Sie bei einem Facebook-Konto mit Adminzugriff auf das Unternehmensportfolio angemeldet sind, dem die WABA gehört. Versuchen Sie den Import dann erneut. * **WABAs, die unter einer Meta-Entwickler-App erstellt wurden,** können nicht über den Standardablauf importiert werden. ### Prüfen, ob ein anderer Partner die Nummer verwaltet Eine Nummer, die nicht berechtigt erscheint, im Importablauf fehlt oder beim Import einen Fehler auslöst, ist häufig noch bei einem früheren Anbieter registriert. Ein Partner, der die Nummer kontrolliert, erklärt sowohl einen fehlgeschlagenen Import als auch eine fehlende WABA. 1. Öffnen Sie [business.facebook.com](https://business.facebook.com) und wählen Sie das Unternehmensportfolio aus. 2. Öffnen Sie **Unternehmenseinstellungen** > **WhatsApp-Konten**. 3. Prüfen Sie bei jedem WhatsApp-Konto die **Telefonnummern**, bis Sie das Konto mit Ihrer Nummer finden. 4. Öffnen Sie **Partner**. 5. Trennen Sie die Nummer von diesem Partner (oder entfernen Sie das gesamte Unternehmensportfolio) und versuchen Sie den Import einige Minuten später erneut. ## Der Agent antwortet nicht auf eingehende Nachrichten Lesebestätigung und Tippindikator grenzen die Ursache ein: Sie werden gesendet, sobald eine Nachricht zur Verarbeitung akzeptiert wird, bevor der Agent eine Antwort erstellt. Wenn **Tippindikator aktivieren** eingeschaltet ist (Standard), senden Sie eine Testnachricht und prüfen Sie, ob Ihre Nachricht als gelesen markiert wird und der Tippindikator erscheint. **Der Tippindikator erscheint, aber keine Antwort kommt an.** Die Nachricht hat ElevenLabs erreicht und der Agent hat mit der Verarbeitung begonnen; der Fehler tritt beim Erstellen oder Zustellen der Antwort auf: * Der Agent benötigt eine [dynamische Variable](/docs/de/eleven-agents/customization/personalization/dynamic-variables), die keinen Wert hat. Eingehende WhatsApp-Unterhaltungen starten ohne vom Nutzer bereitgestellte dynamische Variablen — nur die Systemvariablen werden befüllt. Die Lösung ist ein [Webhook zur Gesprächsinitialisierung](/docs/de/eleven-agents/customization/personalization#conversation-initiation-webhooks), der jede vom Agenten benötigte Variable zurückgibt; siehe [Initialisierungskontext](/docs/de/eleven-agents/whatsapp#initialization-context). Die unter **Dynamische Variablen** im Agent-Editor eingegebenen Werte sind Platzhalter für Tests und werden nicht in der Produktion verwendet. * Meta hat die Antwort des Agenten abgelehnt — beispielsweise aufgrund eines Ratenlimits für dieses Unternehmens-Nutzer-Paar oder eines Zahlungsproblems auf Kontoebene. Siehe die [Fehlerreferenz](#meta-error-reference) unten. Die Unterhaltung schlägt fehl, wenn diese erforderlichen dynamischen Variablen nicht vorhanden sind. **Kein Tippindikator erscheint.** Die Nachricht wurde verworfen, bevor sie den Agenten erreichte: * Dem Nummer ist kein Agent zugewiesen oder der Schalter **Messaging aktivieren** ist deaktiviert — prüfen Sie die Kontoeinstellungen auf der [WhatsApp-Seite](https://elevenlabs.io/app/agents/whatsapp). * Die Autorisierung des Kontos ist nicht mehr gültig — das Zugriffstoken ist abgelaufen oder wurde auf Meta-Seite widerrufen. Importieren Sie das Konto auf der [WhatsApp-Seite](https://elevenlabs.io/app/agents/whatsapp) erneut. * Der Agent-Workspace befindet sich im [Zero-Retention-Modus](/docs/de/eleven-api/resources/zero-retention-mode), der eingehende WhatsApp-Nachrichten vollständig ignoriert. * Die eingehende Nachricht hat einen nicht unterstützten Typ (beispielsweise ein Video oder eine WhatsApp-Flow-Antwort) — siehe [Einschränkungen](/docs/de/eleven-agents/whatsapp#limitations). > **Note** > > Wenn **Tippindikator aktivieren** für das Konto deaktiviert ist, gilt diese Prüfung nicht — arbeiten > Sie beide Listen durch. ## Die erste Antwort nach einer Vorlage verhält sich unerwartet Wenn für Ihren Agenten auf dem Tab **Sicherheit** die Überschreibung **Erste Nachricht** aktiviert ist, kann sie mit Unterhaltungen über ausgehende Vorlagen in Konflikt geraten — die Vorlage hat bereits als erste Nachricht gedient. Wenn Antworten auf Vorlagen unerwartet ausfallen, entfernen Sie die Überschreibung für die erste Nachricht bei Agenten, die mit ausgehenden WhatsApp-Nachrichten verwendet werden. ## Meta-Fehlerreferenz Fehler, die Meta während der Zustellung zurückgibt, werden nach Möglichkeit mit Hinweisen zur Behebung angezeigt. Die häufigsten: | Code | Bedeutung | Vorgehen | | ------ | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | | 131042 | Zahlungsproblem beim WhatsApp-Unternehmenskonto | Fügen Sie die Zahlungsmethode im WhatsApp Manager hinzu oder korrigieren Sie sie | | 131056 | Ratenlimit für dieses Unternehmens-Nutzer-Paar | Senden Sie diesem Nutzer Nachrichten langsamer | | 131047 | Erneute Kontaktaufnahme erforderlich | Das Kundenservice-Fenster wurde geschlossen — nehmen Sie mit einer Vorlage erneut Kontakt auf | | 130497 | Unternehmen darf Nutzern in einem Land nicht schreiben | Meta hat das kontoübergreifende Messaging zwischen Ländern eingeschränkt — klären Sie dies mit dem Meta-Support | | 132000 | Parameteranzahl stimmt nicht mit der Vorlage überein | Senden Sie genau die Parameter, die die Vorlage definiert — siehe [Vorlagenparameter](/docs/de/eleven-agents/whatsapp/outbound#template-parameters) | | 132001 | Vorlage existiert nicht | Prüfen Sie den Vorlagennamen, den Sprachcode und ob die Vorlage genehmigt ist | | 131037 | Problem mit dem Anzeigenamen der Telefonnummer | Schließen Sie die Genehmigung des Anzeigenamens im WhatsApp Manager ab | | 190 | Zugriffstoken abgelaufen | Importieren Sie das Konto auf der [WhatsApp-Seite](https://elevenlabs.io/app/agents/whatsapp) erneut | Die vollständige Liste finden Sie in [Metas Fehlercodereferenz](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes). ## FAQ #### Wie wird die WhatsApp-Nutzung abgerechnet? Zwei Parteien rechnen unabhängig voneinander mit Ihnen ab. **ElevenLabs** berechnet die Nutzung des Agenten — Gesprächszeit, Nachrichten, Speech-to-Text und Text to Speech für Sprachnachrichten sowie LLM-Nutzung — über die Credits Ihres Plans gemäß der üblichen [ElevenLabs-Abrechnung](/docs/de/overview/administration/billing). **Meta** berechnet WhatsApp-Gebühren wie Vorlagennachrichten, ausgehende Anrufe und Anfragen für Anrufberechtigungen separat über die Zahlungsmethode im WhatsApp Manager. Die Preise variieren je nach Nachrichtenkategorie und Land. Meta hat Preisaktualisierungen angekündigt, die am 1. Oktober 2026 in Kraft treten — die für Ihre Märkte geltenden Preise finden Sie unter [WhatsApp- Preise von Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing). #### Kann ich ElevenLabs neben einem anderen WhatsApp-Anbieter nutzen? Eine Nummer kann derzeit nur bei einem Messaging-Anbieter registriert sein. Wenn ein Drittanbieter (beispielsweise Gupshup) Ihr Konto verwaltet, kann es nicht zusätzlich in ElevenLabs importiert werden. Wir arbeiten mit Meta daran, [Multi-Solution Conversations](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/multi-solution-conversations) zu aktivieren, wodurch mehrere Anbieter für eine Nummer möglich werden. **Sprache über SIP.** Wenn Sie das Messaging bei Ihrem aktuellen Anbieter behalten und einen ElevenLabs-Agenten für Sprache verwenden möchten, gibt es bereits heute einen Weg: WhatsApp Business Calling unterstützt SIP. Ein Anbieter, der SIP-Konfiguration bereitstellt, kann die WhatsApp-Anrufe Ihrer Nummer an einen ElevenLabs-[SIP-Trunk](/docs/de/eleven-agents/phone-numbers/sip-trunking) weiterleiten. Ihr Anbieter bearbeitet weiterhin Nachrichten für die Nummer; Anrufe werden über SIP von Ihrem Agenten beantwortet. Ob dies funktioniert, hängt davon ab, ob Ihr Anbieter SIP-Anrufweiterleitung unterstützt — [kontaktieren Sie uns](https://elevenlabs.io/contact-sales), damit wir Ihre Konfiguration prüfen können. Wenn Sie eine eigene WhatsApp-App für dasselbe Konto betreiben (statt einen Drittanbieter zu nutzen), können Sie ElevenLabs bereits so konfigurieren, dass nur Anrufe verarbeitet werden: Deaktivieren Sie den Schalter ***Messaging aktivieren*** in den Kontoeinstellungen. #### Wie übergebe ich eine Unterhaltung an einen Menschen? Demnächst verfügbar. Wir arbeiten mit Meta an Coexistence with WhatsApp Business, wodurch Ihr Team an Unterhaltungen über dieselbe Nummer teilnehmen kann, die auch der Agent verwendet. #### Funktioniert der Zero-Retention-Modus mit WhatsApp? Der [Zero-Retention-Modus](/docs/de/eleven-api/resources/zero-retention-mode) beschränkt unsere Möglichkeit, WhatsApp-Funktionen bereitzustellen: Eingehende Nachrichten werden ignoriert und ausgehende Anrufe sind nicht zulässig. #### Kann ich anhand der WhatsApp-Anzeige personalisieren, auf die ein Nutzer geklickt hat? Noch nicht. Der Agent empfängt und beantwortet Unterhaltungen, die über Click-to-WhatsApp-Anzeigen gestartet werden, aber Metas Metadaten zu Anzeigenverweisen (etwa `ctwa_clid` sowie Kampagnen- oder Creative-Kennungen) werden derzeit nicht für den Agenten, dynamische Variablen oder Webhooks bereitgestellt. Daher werden anzeigenbasierte Personalisierung und Attribution nicht nativ unterstützt. Dies wird als Funktionsanfrage verfolgt — wenn Anzeigen- Attribution für Ihren Anwendungsfall wichtig ist, [kontaktieren Sie uns](https://elevenlabs.io/contact-sales). #### Wie sende ich Bestätigungscodes (OTP)? Verwenden Sie eine Utility-Vorlage mit dem Code als Body-Parameter, die über den [Endpunkt für ausgehende Nachrichten ](/docs/de/eleven-agents/whatsapp/outbound) gesendet wird. Metas Kategorie „Authentication“-Vorlage (mit Schaltflächen zum Kopieren des Codes) wird noch nicht speziell unterstützt. #### Wer ist der Technologieanbieter für mein WhatsApp-Konto? Wenn Sie ein WhatsApp-Unternehmenskonto importieren, agiert ElevenLabs als **Technologieanbieter** für dieses Konto im Partnermodell von Meta. ElevenLabs ist ein Meta-Technologiepartner, kein Wiederverkäufer: Meta stellt Ihnen WhatsApp-Gebühren direkt über die Zahlungsmethode im WhatsApp Manager in Rechnung. #### Wird EU-Datenresidenz unterstützt? EU-Datenresidenz für ElevenAgents, einschließlich WhatsApp-Konversationsdaten, ist in Enterprise-Plänen über die isolierte EU-Umgebung verfügbar. Dies umfasst Daten, die von der ElevenLabs- Infrastruktur verarbeitet werden; der Nachrichtentransport über WhatsApp selbst unterliegt Ihrer Vereinbarung mit Meta.