Webhooki wiadomości przychodzących WhatsApp

Gdy kontakt wyśle Ci wiadomość, Bird przekazuje whatsapp.received do Twojego endpointu. Payload używa koperty zdarzenia WhatsApp i zawiera pola wspólne dla każdego zdarzenia wiadomości.

Payload wiadomości odebranej

whatsapp.received zawiera treść wiadomości oprócz pól wspólnych dla każdego zdarzenia wiadomości, dzięki czemu endpoint może zareagować na wiadomość przychodzącą bez ponownego jej odczytywania. Dotknięcie interaktywnej wiadomości przychodzi jako interactive_reply, a in_reply_to_message_id wskazuje wiadomość, na którą odpowiada:

{
  "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"
}

Pozostałe warianty treści mają tę samą strukturę „jeden z wielu": text, image, video, audio, sticker, document, location, contact_cards oraz unsupported dla rodzaju, którego API nie modeluje. GET /v1/whatsapp/messages/{message_id} opisuje każdy z nich.

Następne kroki

• Odbieranie wiadomości WhatsApp: wszystkie warianty treści i pobieranie mediów przychodzących
• Webhooki reakcji: reakcje kontaktu przychodzą osobno
• Webhooki statusu wiadomości: payloady dostarczenia i błędu dla wysyłanych wiadomości