Nicht unterstützte WhatsApp-Nachrichtentypen

Einige Nachrichten funktionieren in der WhatsApp-App, können aber über die API nicht gelesen werden. Bird erfasst sie als empfangene Nachrichten mit einem unsupported-Feld. Sie können sehen, wer die Nachricht wann gesendet hat, aber Sie können ihren Inhalt weder im Dashboard noch über die API lesen. Bitten Sie den Absender, die Information als Text oder einen anderen unterstützten Nachrichtentyp erneut zu senden.

Warum eine empfangene Nachricht einen Fehler enthalten kann

Meta kann den Fehler 131051 in einer eingehenden Nachrichtenbenachrichtigung mitsenden, wenn WhatsApp Cloud API diesen Inhalt nicht unterstützt. Eine Funktion kann in der WhatsApp-App funktionieren und trotzdem über Cloud API nicht verfügbar sein.

Bird erfasst diese Benachrichtigung mit direction: inbound und status: received. Das last_error-Feld der Nachricht kann meta_error_code: "131051" enthalten, obwohl Bird nicht versucht hat, sie zu senden. In diesem Fall beschreibt der Fehler den nicht verfügbaren eingehenden Inhalt. Er weist nicht auf einen fehlgeschlagenen ausgehenden Versand hin.

Das normalisierte Feld last_error.code kann in diesem empfangenen Datensatz den Wert undeliverable haben. Prüfen Sie direction, status und last_error.meta_error_code gemeinsam, bevor Sie einen Datensatz als Zustellungsfehler behandeln.

Meta verwendet 131060 auch für eine Nachricht, die derzeit nicht verfügbar ist. Das kann auftreten, wenn jemand einem Unternehmen zum ersten Mal über eine verbundene WhatsApp Business-App-Nummer schreibt. Die Bedeutung unterscheidet sich vom Fehler für nicht unterstützten Inhalt 131051. Siehe Metas Referenz für nicht unterstützte Nachrichten zu diesen Benachrichtigungen.

Nachrichtentyp lesen

Das Feld unsupported.type identifiziert den Inhalt so genau, wie es die Benachrichtigung zulässt:

Wenn Meta unsupported.type liefert, übernimmt Bird den Wert, zum Beispiel poll_creation, pin oder edit.
Wenn Meta unsupported.type weglässt, behält Bird den übergeordneten Typ der Nachricht in diesem Feld bei. Ein Wert wie unsupported oder unknown identifiziert nicht die Aktion, die der Absender ausgeführt hat.
Wenn Meta Inhalte liefert, die das API von Bird nicht abbildet, erfasst Bird den Typ hier ebenfalls, zum Beispiel order oder system.

Der Typname enthält nicht den fehlenden Inhalt. poll_creation liefert Ihnen beispielsweise nicht die Frage oder die Antwortmöglichkeiten, und edit liefert Ihnen nicht den Ersatztext. Speichern Sie unbekannte Typwerte beim Ablegen von Nachrichten, damit Ihre Integration neue Typen akzeptieren kann.

Bird unterstützt Bilder, Button-Antworten, Listenantworten und Reaktionen. Eine nicht unterstützte Benachrichtigung mit einem dieser Namen beschreibt genau diese Benachrichtigung; sie bedeutet nicht, dass das gesamte Feature nicht unterstützt wird. Siehe Bilder empfangen, interaktive Antworten und Reaktions-Webhooks.

Den empfangenen Webhook verarbeiten

Eine nicht unterstützte Nachricht löst whatsapp.received mit data.unsupported.type aus. Der empfangene Webhook enthält nicht das last_error des Nachrichtendatensatzes; rufen Sie die Nachricht über die API ab, wenn Sie diese Diagnoseinformation benötigen.

Verarbeiten Sie unsupported explizit, bevor Sie den Inhalt weiterverarbeiten. Zeigen Sie an, dass der Inhalt nicht verfügbar ist, speichern Sie den Typ und bestätigen Sie den Webhook mit einer 2xx-Antwort, sobald Sie ihn verarbeitet haben. Ein erneutes Senden derselben Benachrichtigung stellt den fehlenden Inhalt nicht wieder her. Siehe Webhook-Zustellung für Bestätigungs- und Wiederholungsverhalten.

Der Datensatz bleibt im WhatsApp-Log sichtbar. Bird behandelt ihn als eingehende Nachricht für das Kundenservice-Fenster.

Beispiele zum Ausprobieren

Dies sind Beispiele für Werte von unsupported.type. Wenn Ihre WhatsApp-App die entsprechende Aktion in der Konversation anbietet, die Sie testen, können Sie sie ausprobieren und den resultierenden Datensatz prüfen:

Nachricht oder Aktion	`unsupported.type`
Eine Umfrage erstellen	`poll_creation`
In einer Umfrage abstimmen	`poll_update`
Eine Nachricht anpinnen	`pin`
Eine gesendete Nachricht bearbeiten	`edit`
Eine verschwindende Nachricht im Chat behalten	`keep_in_chat`
Eine Gruppeneinladung senden	`group_invite`
Nicht identifizierte Nachricht	`unknown`

Die Verfügbarkeit hängt von der App, der Konversation und dem Konto ab. Sie erhalten möglicherweise einen generischen Typ oder gar keine Benachrichtigung über eine eingehende Nachricht für eine Aktion. Vergleichen Sie Absender, Zeitstempel und unsupported.type mit der ausgeführten Aktion. Wenn der Typ generisch ist, können Sie die Aktion allein anhand dieses Datensatzes nicht identifizieren.

Nächste Schritte

So funktioniert der Empfang: eingehende Nachrichten, Medien und Webhooks
Interaktive Antworten empfangen: Buttonklicks und Listenauswahlen
WhatsApp-Protokoll: Nachrichten im Dashboard oder über API prüfen

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.

Übung ausprobieren und ein Implementierungs-Briefing erhalten