# Menerima stiker WhatsApp

Stiker yang diketuk kontak dari baki mereka tiba sebagai pesan masuk yang membawa `sticker`: referensi file WebP, ditambah flag `animated`.

## Isi stiker masuk

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

| Field       | Isi                                                                    |
| ----------- | ---------------------------------------------------------------------- |
| `id`        | File yang tersimpan, diteruskan sebagai `media_id` saat mengambil byte |
| `url`       | URL Bird, diambil dengan kunci API Anda                                |
| `mime_type` | Tipe media yang dilaporkan WhatsApp, `image/webp` untuk stiker         |
| `animated`  | Apakah stiker beranimasi; hanya ada pada stiker masuk                  |

Arm ini tidak membawa caption di kedua arah, dan tidak ada nama untuk stiker maupun paket asalnya. Stiker adalah keseluruhan pesan.

`animated` membedakan WebP animasi dari yang statis, yang penting saat Anda merender file sendiri: stiker animasi adalah WebP multi-frame yang diratakan oleh renderer gambar diam ke frame pertamanya.

## Mengambil byte

Teruskan ID pesan dan `id` media ke metode media channel. Halaman [mengambil media masuk](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) di hub memuat panggilan tersebut dalam setiap bahasa, beserta aturan redirect dan header yang diikutinya, dan menentukan jendela retensi tempat file berada.

Kebanyakan integrasi tidak pernah mengambil stiker. Stiker biasanya membawa sentimen, bukan informasi, jadi inbox agen dapat menampilkan placeholder dan alur otomatis dapat memperlakukan pesan tersebut sebagai tanda terima yang mereset jendela tanpa mengunduh apa pun.

## Payload webhook

`whatsapp.received` membawa arm `sticker` pada envelope event:

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

## Hal yang perlu diperhatikan

- **Stiker tetap mereset jendela layanan.** Stiker adalah pesan masuk seperti yang lain, sehingga memberikan 24 jam tambahan untuk balasan bebas meskipun tidak membawa teks untuk ditindaklanjuti.
- **Stiker bukan reaksi.** Reaksi emoji yang ditambahkan kontak pada salah satu pesan Anda bukan pesan masuk sama sekali: reaksi tersebut dicatat di log reaksi pesan itu sendiri, dan cara membacanya dibahas di [event WhatsApp](/docs/guides/whatsapp/events#reaction-events).

## Langkah selanjutnya

- [Cara kerja penerimaan](/docs/guides/whatsapp/receiving-whatsapp): envelope masuk, pengambilan media, dan webhook `whatsapp.received`
- [Pesan stiker WhatsApp](/docs/guides/whatsapp/message-types/stickers): sisi kirim dari arm yang sama
- [Tipe pesan yang tidak didukung](/docs/guides/whatsapp/receiving-whatsapp/unsupported): pesanan, notifikasi sistem, dan sisanya yang tiba tanpa model
- [Event WhatsApp](/docs/guides/whatsapp/events): daftar event lengkap, melalui API atau webhook

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