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:

Przykład kodu

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

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikConnecting WhatsApp to Bird: from buying a number to a live channel Zrozum koncepcjęWhat is the 24-hour customer service window on WhatsApp?Użyj narzędziaWhatsApp message builder Poznaj możliwościWhatsApp

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy