# Odbieranie naklejek WhatsApp

Naklejka, którą kontakt wybiera z panelu, dociera jako wiadomość przychodząca zawierająca `sticker`: referencję do pliku WebP oraz flagę `animated`.

## Co zawiera przychodząca naklejka

```json
{
  "id": "wam_01kye7t1rgyw9u5l8p2zaf7sid",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "sticker": {
    "id": "waf_01kye6r7as0zkv3g1q6suy9whc",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kye7t1rgyw9u5l8p2zaf7sid/media/waf_01kye6r7as0zkv3g1q6suy9whc",
    "mime_type": "image/webp",
    "animated": false
  },
  "created_at": "2026-08-25T09:19:37Z"
}
```

| Pole        | Co zawiera                                                             |
| ----------- | ---------------------------------------------------------------------- |
| `id`        | Zapisany plik, przekazywany jako `media_id` przy pobieraniu bajtów     |
| `url`       | URL Bird, pobierany z użyciem klucza API                               |
| `mime_type` | Typ mediów zgłoszony przez WhatsApp, `image/webp` w przypadku naklejki |
| `animated`  | Czy naklejka jest animowana; obecne tylko w przychodzących naklejkach  |

Gałąź nie zawiera podpisu w żadnym kierunku ani nazwy naklejki czy paczki, z której pochodzi. Naklejka stanowi całą wiadomość.

`animated` rozróżnia animowany WebP od statycznego, co ma znaczenie, gdy sam renderujesz plik: animowana naklejka to wieloklatkowy WebP, który renderer obrazów statycznych spłaszcza do pierwszej klatki.

## Pobieranie bajtów

Przekaż identyfikator wiadomości i `id` mediów do metody media kanału. Sekcja [pobieranie przychodzących mediów](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) w hubie zawiera to wywołanie w każdym języku, wraz z regułami przekierowań i nagłówków, które stosuje, oraz oknem retencji, w którym plik jest dostępny.

Większość integracji nigdy nie pobiera naklejki. Zwykle niesie ona emocję, nie informację, więc skrzynka agenta może wyświetlić placeholder, a zautomatyzowany przepływ może potraktować wiadomość jako potwierdzenie resetujące okno bez pobierania czegokolwiek.

## Payload webhooka

`whatsapp.received` zawiera gałąź `sticker` w kopercie zdarzenia:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:19:37.882Z",
  "data": {
    "whatsapp_id": "wam_01kye7t1rgyw9u5l8p2zaf7sid",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "sticker": {
      "id": "waf_01kye6r7as0zkv3g1q6suy9whc",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kye7t1rgyw9u5l8p2zaf7sid/media/waf_01kye6r7as0zkv3g1q6suy9whc",
      "mime_type": "image/webp",
      "animated": false
    },
    "tags": null,
    "metadata": null
  }
}
```

## Na co uważać

- **Naklejka wciąż resetuje okno serwisowe.** Jest wiadomością przychodzącą jak każda inna, więc daje kolejne 24 godziny na swobodne odpowiedzi, mimo że nie zawiera tekstu do przetworzenia.
- **Naklejka to nie reakcja.** Reakcja emoji dodana przez kontakt do jednej z Twoich wiadomości nie jest wiadomością przychodzącą: jest zapisana w logu reakcji tej wiadomości, a jej odczytywanie opisano w sekcji [zdarzenia WhatsApp](/docs/guides/whatsapp/events#reaction-events).

## Następne kroki

- [Jak działa odbieranie](/docs/guides/whatsapp/receiving-whatsapp): koperta wiadomości przychodzącej, pobieranie mediów i webhook `whatsapp.received`
- [Wiadomości z naklejkami WhatsApp](/docs/guides/whatsapp/message-types/stickers): strona wysyłania tej samej gałęzi
- [Nieobsługiwane typy wiadomości](/docs/guides/whatsapp/receiving-whatsapp/unsupported): zamówienia, powiadomienia systemowe i pozostałe wiadomości przychodzące bez modelu
- [Zdarzenia WhatsApp](/docs/guides/whatsapp/events): pełna lista zdarzeń, przez API lub webhooki

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

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