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 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.
4. Empfängerformat — whatsapp_user_id enthält nur Ziffern einschließlich Landesvorwahl, ohne +. Siehe Format der Empfängernummer.
5. Marketinglimits — Meta begrenzt, wie viele Marketingvorlagen 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.
• 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 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, 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, der jede vom Agenten benötigte Variable zurückgibt; siehe Initialisierungskontext. 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 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.
• 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 erneut.
• Der Agent-Workspace befindet sich im Zero-Retention-Modus, 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.

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:

Die vollständige Liste finden Sie in Metas Fehlercodereferenz.

FAQ