Nicht unterstützte WhatsApp-Nachrichtentypen

WhatsApp überträgt Inhalte, die API von Bird nicht abbildet – von Katalogbestellungen bis zu Systemmeldungen über die Konversation. Statt eine solche Nachricht zu verwerfen oder leer zuzustellen, zeichnet Bird sie mit einem unsupported-Arm auf, der den WhatsApp-Inhaltstyp benennt. Die Nachricht ist im WhatsApp-Log sichtbar und erreicht Ihren Webhook wie jede andere.

Was eine nicht unterstützte Nachricht enthält

unsupported.type enthält den eigenen Typ-String von WhatsApp für das, was angekommen ist, und das ist der einzige Inhalt der Nachricht. Der Envelope drumherum bleibt unverändert:

Codebeispiel

{
  "id": "wam_01kyh0w4ujnz2x8p1s5dci0vlg",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "unsupported": { "type": "order" },
  "created_at": "2026-08-25T09:31:20Z"
}

type	Was der Kontakt gesendet hat
interactive	Interaktiver Inhalt, dessen Antwortform die API nicht als Tap lesen konnte
button	Ein Button-Tap, den die API nicht als Antwort lesen konnte
order	Ein Warenkorb oder eine Bestellung aus einem Produktkatalog
system	Eine Systemmeldung über die Konversation, z. B. wenn ein Kontakt seine Telefonnummer ändert
unsupported	Der eigene unsupported-Typ von WhatsApp, für eine Nachricht, die die eigenen Clients nicht rendern können

unsupported ist kein Platzhalter in dieser Tabelle. WhatsApp meldet unter diesem Namen einen eigenen Inhaltstyp, wenn einer seiner Clients etwas sendet, das die anderen nicht anzeigen können, und das kommt als dieser Wert an.

Die Liste ist offen. WhatsApp fügt im Laufe der Zeit Inhaltstypen hinzu. Behandeln Sie daher einen type, den Sie nicht kennen, als zukünftigen Typ und nicht als Fehler: Loggen Sie ihn und machen Sie weiter, statt das Lesen abzubrechen.

Die Webhook-Payload

whatsapp.received wird auch bei einer nicht unterstützten Nachricht ausgelöst und enthält denselben Arm:

Codebeispiel

{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:31:20.774Z",
  "data": {
    "whatsapp_id": "wam_01kyh0w4ujnz2x8p1s5dci0vlg",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "unsupported": { "type": "order" },
    "tags": null,
    "metadata": null
  }
}

Ein Endpoint, der anhand des gefundenen Content-Felds verzweigt, sollte einen Default-Branch haben, und dieser Arm ist das, was dort landet. Bestätigen Sie den Webhook in jedem Fall mit einem 2xx: Ein erneuter Versuch ändert nichts, da der Inhalt zwischen den Versuchen nicht modelliert wird.

Was eine nicht unterstützte Nachricht trotzdem bewirkt

Die Nachricht zählt in jeder Hinsicht als eingehende Nachricht, die nicht von ihrem Inhalt abhängt:

Sie setzt das Kundenservice-Fenster zurück auf volle 24 Stunden. Eine Bestellung aus Ihrem Katalog eröffnet also wieder Freitext-Antworten.
Sie erscheint in der Nachrichtenliste und im WhatsApp-Log, mit dem angezeigten Typ statt einer leeren Zeile.
Sie wird nie berechnet. Keine eingehende Nachricht ist kostenpflichtig.

Was Sie nicht tun können, ist den Inhalt lesen. Eine Bestellung enthält nicht den Warenkorb, und eine Systemmeldung sagt nicht, was sich geändert hat. Wo dieses Detail wichtig ist, fragen Sie den Kontakt in Worten oder verwenden Sie einen Antwort-Button oder ein Listenmenü, damit die Antwort auf einem modellierten Arm ankommt, auf den Sie reagieren können.

Worauf Sie achten sollten

Behandeln Sie den Arm nicht als Fehler. Die Nachricht wurde erfolgreich empfangen; nur ihr Inhalt ist nicht modelliert. Wenn Sie darauf alarmieren, alarmieren Sie jedes Mal, wenn ein Kontakt eine Bestellung aufgibt.
Ein system-Typ kann bedeuten, dass der Kontakt seine Nummer gewechselt hat. Meta dokumentiert eine Telefonnummernänderung als eines der Ereignisse, die eine Systemnachricht auslösen, und regeneriert gleichzeitig die geschäftsbezogene User-ID des Kontakts. Der Arm benennt den Typ und nichts anderes. Behandeln Sie ihn daher als Anlass, erneut festzustellen, mit wem Sie sprechen.
Eine Emoji-Reaktion ist keine nicht unterstützte Nachricht. Sie ist überhaupt keine eingehende Nachricht und erreicht daher keinen Webhook und erscheint in keiner Nachrichtenliste: Jede Änderung wird im Reaktions-Log der reagierten Nachricht selbst erfasst, beschrieben unter WhatsApp-Events.
Speichern Sie den Typ wortgetreu. Ein zukünftiger Typ ergibt einen Namen, für den Sie noch keinen Code haben, und der Rohwert ist das, womit Sie diese Nachrichten später finden können.

Nächste Schritte

So funktioniert der Empfang: der eingehende Envelope, Media-Abruf und der whatsapp.received-Webhook
Interaktive Antworten empfangen: die Taps, die als modellierter Inhalt ankommen
WhatsApp-Log: die Konversation im Dashboard durchsuchen
WhatsApp-Events: die vollständige Event-Liste, über die API oder Webhooks