WhatsApp Webhooks für eingehende Nachrichten

Wenn ein Kontakt Ihnen eine Nachricht sendet, überträgt Bird whatsapp.received an Ihren Endpoint. Der Payload verwendet den WhatsApp-Event-Envelope und enthält die Felder, die jedes Nachrichten-Event mitführt.

Der received-Payload

whatsapp.received enthält den Nachrichteninhalt zusätzlich zu den Feldern, die jedes Nachrichten-Event mitführt, sodass ein Endpoint auf eine eingehende Nachricht reagieren kann, ohne sie erneut abzurufen. Ein Tippen auf eine interaktive Nachricht kommt als interactive_reply an, und in_reply_to_message_id benennt die Nachricht, auf die geantwortet wird:

Codebeispiel

{
  "data": {
    "direction": "inbound",
    "from": {
      "display_name": "Alex Rivera",
      "phone_number": "+14155550100",
      "username": "alexr"
    },
    "in_reply_to_message_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "interactive_reply": {
      "list": {
        "description": "Next day to 2 days",
        "slug": "priority_express",
        "text": "Priority Mail Express"
      },
      "type": "list"
    },
    "metadata": null,
    "tags": null,
    "to": { "phone_number": "+13124495569" },
    "whatsapp_id": "wam_01ky8b3xq4gd7pmzn2ka51f7te",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:52:04.118Z",
  "type": "whatsapp.received"
}

Die übrigen Inhaltsfelder folgen demselben Eins-von-diesen-Schema: text, image, video, audio, sticker, document, location, contact_cards und unsupported für einen Typ, den API nicht modelliert. GET /v1/whatsapp/messages/{message_id} dokumentiert jedes einzelne.

Nächste Schritte

WhatsApp-Nachrichten empfangen: alle Inhaltsfelder und Abruf eingehender Medien
Reaktions-Webhooks: Reaktionen eines Kontakts kommen separat an
Nachrichtenstatus-Webhooks: Zustellungs- und Fehler-Payloads für von Ihnen gesendete Nachrichten

WhatsApp Webhooks für eingehende Nachrichten

Der received-Payload

Nächste Schritte

Verwandte Ressourcen