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

Codevoorbeeld

{
  "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 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:

Codevoorbeeld

{
  "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.

Volgende stappen

Hoe ontvangen werkt: de inkomende envelope, media ophalen en de whatsapp.received-webhook
WhatsApp-stickerberichten: de verzendzijde van dezelfde arm
Niet-ondersteunde berichttypen: bestellingen, systeemmeldingen en de rest van wat ongemodelleerd binnenkomt
WhatsApp-events: de volledige eventlijst, via de API of webhooks

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsConnecting WhatsApp to Bird: from buying a number to a live channel Begrijp het conceptWhat is the 24-hour customer service window on WhatsApp?Gebruik de toolWhatsApp message builder Ontdek de mogelijkheidWhatsApp

Probeer de oefening en ontvang een implementatieoverzicht