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

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

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:

{
  "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 ke salah satu pesan Anda bukan pesan masuk: reaksi tersebut dicatat di log reaksi pesan itu sendiri, dan cara membacanya dibahas di Reaction events.

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
• Webhook WhatsApp: semua event yang dapat Anda subscribe