# 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](/docs/guides/whatsapp/webhooks#the-event-envelope) i zawiera [pola wspólne dla każdego zdarzenia wiadomości](/docs/guides/whatsapp/webhooks#fields-every-message-event-carries).

## 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:

```json
{
  "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}`](/docs/api/reference/get-whatsapp-message) opisuje każdy z nich.

## Następne kroki

- [Odbieranie wiadomości WhatsApp](/docs/guides/whatsapp/receiving-whatsapp): wszystkie warianty treści i pobieranie mediów przychodzących
- [Webhooki reakcji](/docs/guides/whatsapp/webhooks/reactions): reakcje kontaktu przychodzą osobno
- [Webhooki statusu wiadomości](/docs/guides/whatsapp/webhooks/message-status): payloady dostarczenia i błędu dla wysyłanych wiadomości

## 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](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)