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
Contoh kode
{
"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 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:
Contoh kode
{
"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.
Langkah selanjutnya
- Cara kerja penerimaan: envelope masuk, pengambilan media, dan webhook whatsapp.received
- Pesan stiker WhatsApp: sisi kirim dari arm yang sama
- Tipe pesan yang tidak didukung: pesanan, notifikasi sistem, dan sisanya yang tiba tanpa model
- Event WhatsApp: daftar event lengkap, melalui API atau webhook
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Tonton panduannyaConnecting WhatsApp to Bird: from buying a number to a live channelPahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builderJelajahi kemampuannyaWhatsApp
Coba praktiknya dan dapatkan ringkasan implementasi