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
Przykład kodu
{
"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 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:
Przykład kodu
{
"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.
Następne kroki
- Jak działa odbieranie: koperta wiadomości przychodzącej, pobieranie mediów i webhook whatsapp.received
- Wiadomości z naklejkami WhatsApp: strona wysyłania tej samej gałęzi
- Nieobsługiwane typy wiadomości: zamówienia, powiadomienia systemowe i pozostałe wiadomości przychodzące bez modelu
- Zdarzenia WhatsApp: pełna lista zdarzeń, przez API lub webhooki
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 channelZrozum koncepcjęWhat is the 24-hour customer service window on WhatsApp?Użyj narzędziaWhatsApp message builderPoznaj możliwościWhatsApp
Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy