# WhatsApp-stickers ontvangen

Een sticker die een contact uit de stickerlade kiest, komt binnen als een inkomend bericht met `sticker`: een WebP-bestandsreferentie plus een `animated`-vlag.

## Wat een inkomende sticker bevat

```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"
}
```

| Veld        | Wat het bevat                                                                    |
| ----------- | -------------------------------------------------------------------------------- |
| `id`        | Het opgeslagen bestand, mee te geven als `media_id` bij het ophalen van de bytes |
| `url`       | Een Bird-URL, op te halen met je API-sleutel                                     |
| `mime_type` | Het mediatype dat WhatsApp rapporteert, `image/webp` voor een sticker            |
| `animated`  | Of de sticker animeert; alleen aanwezig bij een inkomende sticker                |

De arm bevat geen bijschrift in beide richtingen, en geen naam voor de sticker of het pakket waar hij uit komt. Een sticker is het volledige bericht.

`animated` onderscheidt een geanimeerde WebP van een statische, wat uitmaakt als je het bestand zelf rendert: een geanimeerde sticker is een WebP met meerdere frames die een renderer voor stilstaande beelden plat slaat naar het eerste frame.

## De bytes ophalen

Geef het bericht-ID en de media-`id` door aan de mediamethode van het kanaal. De hub's [inkomende media ophalen](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) bevat die aanroep in elke taal, samen met de redirect- en headerregels die hij volgt, en beheert het bewaarvenster waarin het bestand leeft.

De meeste integraties halen nooit een sticker op. Hij drukt meestal sentiment uit in plaats van informatie, dus een agent-inbox kan een placeholder tonen en een geautomatiseerde flow kan het bericht behandelen als een venster-verlengende bevestiging zonder iets te downloaden.

## De webhook-payload

`whatsapp.received` bevat de `sticker`-arm op de event-envelope:

```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
  }
}
```

## Waar je op moet letten

- **Een sticker reset nog steeds het servicevenster.** Het is een inkomend bericht als elk ander, dus het koopt weer 24 uur vrije antwoorden, ook al bevat het geen tekst om op te reageren.
- **Een sticker is geen reactie.** Een emojireactie die een contact aan een van je berichten toevoegt, is helemaal geen inkomend bericht: het wordt vastgelegd in het reactielog van dat bericht, en het uitlezen ervan wordt behandeld in [WhatsApp-events](/docs/guides/whatsapp/events#reaction-events).

## Volgende stappen

- [Hoe ontvangen werkt](/docs/guides/whatsapp/receiving-whatsapp): de inkomende envelope, media ophalen en de `whatsapp.received`-webhook
- [WhatsApp-stickerberichten](/docs/guides/whatsapp/message-types/stickers): de verzendzijde van dezelfde arm
- [Niet-ondersteunde berichttypen](/docs/guides/whatsapp/receiving-whatsapp/unsupported): bestellingen, systeemmeldingen en de rest van wat ongemodelleerd binnenkomt
- [WhatsApp-events](/docs/guides/whatsapp/events): de volledige eventlijst, via de API of webhooks

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