# 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](/docs/guides/whatsapp/message-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: ```json { "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: ```json { "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ü](/docs/guides/whatsapp/message-types/interactive), 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](/docs/guides/whatsapp/business-scoped-user-ids) 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](/docs/guides/whatsapp/events#reaction-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](/docs/guides/whatsapp/receiving-whatsapp): der eingehende Envelope, Media-Abruf und der `whatsapp.received`-Webhook - [Interaktive Antworten empfangen](/docs/guides/whatsapp/receiving-whatsapp/interactive-replies): die Taps, die als modellierter Inhalt ankommen - [WhatsApp-Log](/docs/guides/whatsapp/message-log): die Konversation im Dashboard durchsuchen - [WhatsApp-Events](/docs/guides/whatsapp/events): die vollständige Event-Liste, über die API oder Webhooks ## Related resources - [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video) - [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer) - [WhatsApp message builder](/tools/whatsapp-message-builder) (tool) - [WhatsApp](/products/whatsapp) (product) [Get an implementation brief](/learn/workspace?topic=whatsapp)