---
title: "Webhooki WhatsApp"
description: "Zdarzenia webhookowe WhatsApp, które Bird może wysyłać na Twój endpoint, koperta, w jakiej każde z nich przychodzi, oraz pola zawsze obecne w zdarzeniu wiadomości."
canonical: "https://bird.com/pl-pl/dokumentacja/guides/whatsapp/webhooks"
---

# Webhooki WhatsApp

Bird przesyła aktywność WhatsApp na Twój endpoint w czasie rzeczywistym, więc nie musisz odpytywać o nią cyklicznie. Subskrybuj ze strony [**Webhooks**](https://bird.com/dashboard/w/webhooks) lub za pomocą [`POST /v1/webhooks`](/docs/api/reference/create-webhook). [Przewodnik po webhookach](/docs/guides/webhooks) opisuje endpointy, weryfikację podpisów i ponowne próby.

## Zdarzenia, które możesz subskrybować

Każde zdarzenie zawiera link do swojego payloadu.

| Zdarzenie                                                                                           | Występuje, gdy                                          |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| [`whatsapp.accepted`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                | Bird akceptuje żądanie wysyłki wychodzącej              |
| [`whatsapp.sent`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                    | Bird przekazuje wiadomość do sieci WhatsApp             |
| [`whatsapp.delivered`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)               | WhatsApp potwierdza dostarczenie na urządzenie odbiorcy |
| [`whatsapp.read`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                    | Odbiorca otwiera wiadomość                              |
| [`whatsapp.failed`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                  | Dostarczenie wiadomości nie powiodło się                |
| [`whatsapp.rejected`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                | Bird odrzuca wiadomość przed jej wysłaniem              |
| [`whatsapp.received`](/docs/guides/whatsapp/webhooks/messages)                                      | Kontakt wysyła Ci wiadomość                             |
| [`whatsapp.reacted`](/docs/guides/whatsapp/webhooks/reactions)                                      | Kontakt dodaje, zmienia lub usuwa reakcję               |
| [`whatsapp_suppression.created`](/docs/guides/whatsapp/webhooks/suppressions)                       | W Twoim obszarze roboczym pojawia się blokada           |
| [`whatsapp.group.join_request_created`](/docs/guides/whatsapp/webhooks/groups#join-request-created) | Ktoś prosi o dołączenie do grupy                        |
| [`whatsapp.group.join_request_revoked`](/docs/guides/whatsapp/webhooks/groups#join-request-revoked) | Ktoś anuluje prośbę o dołączenie do grupy               |

Lista typów zdarzeń jest otwarta: nowe typy mogą być dodawane z czasem, więc traktuj nierozpoznaną wartość jako przyszłe zdarzenie, a nie jako błąd.

## Koperta zdarzenia

Każde zdarzenie WhatsApp używa standardowej [koperty webhooka](/docs/guides/webhooks): `type`, `timestamp` oraz obiekt `data` specyficzny dla danego typu.

```json
{
  "data": {
    "direction": "outbound",
    "from": { "phone_number": "+13124495569" },
    "metadata": { "session_id": "sess_4821" },
    "tags": [{ "name": "flow", "value": "login-otp" }],
    "to": { "phone_number": "+14155550100" },
    "whatsapp_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:51:39.913Z",
  "type": "whatsapp.delivered"
}
```

## Pola obecne w każdym zdarzeniu wiadomości

Każdy payload webhooka WhatsApp dla wiadomości zawiera `whatsapp_id`, `workspace_id`, `direction`, `from`, `to`, `tags` i `metadata`. Zdarzenia reakcji, blokady i grupy nie dotyczą wiadomości, więc każde ma własną strukturę opisaną na swojej stronie.

- **Adresy**: `from` i `to` mogą zawierać numer E.164 w `phone_number`, identyfikator [użytkownika w zakresie firmy](/docs/guides/whatsapp/business-scoped-user-ids) Meta w `bsuid` lub oba. Wiadomość odebrana od użytkownika WhatsApp zawiera także publikowany przez niego profil, w `username` i `display_name`.
- **`tags` i `metadata`** mają wartość `null`, gdy wysyłka nie zawierała żadnego z nich.
- **`in_reply_to_message_id`** pojawia się w każdym zdarzeniu wychodzącym wiadomości wysłanej jako odpowiedź, od `whatsapp.accepted` przez `whatsapp.read`, `whatsapp.failed` lub `whatsapp.rejected`, wskazując wiadomość, na którą odpowiada.

Payloady zdarzeń nie zawierają kosztu. Odczytaj wiadomość za pomocą [`GET /v1/whatsapp/messages/{message_id}`](/docs/api/reference/get-whatsapp-message), aby zobaczyć, ile kosztowała.

## Kolejne kroki

- [Webhooki statusu wiadomości](/docs/guides/whatsapp/webhooks/message-status): dane dostarczenia i niepowodzenia
- [Webhooki wiadomości przychodzących](/docs/guides/whatsapp/webhooks/messages): dane `whatsapp.received`
- [Webhooki reakcji](/docs/guides/whatsapp/webhooks/reactions): ładunek `whatsapp.reacted`
- [Przewodnik po webhookach](/docs/guides/webhooks): endpointy, sygnatury, ponowienia i pełny katalog zdarzeń

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