Sign inGet started

Pesan stiker WhatsApp

Pesan stiker membawa URL WebP publik yang diambil WhatsApp saat pengiriman. Ini adalah jenis media paling sederhana: tanpa caption, tanpa field opsional lain saat mengirim.

Mengirim stiker

Atur sticker.url; tidak ada yang perlu ditambahkan lagi:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  sticker: { url: "https://cdn.example.com/stickers/thumbs-up.webp" },
});
console.log(msg.id, msg.status);
sticker tidak memiliki field caption, dan animated bukan sesuatu yang Anda atur saat mengirim; Bird hanya melaporkannya kembali pada stiker masuk. from wajib ada di setiap pesan layanan: nomor milik workspace Anda, bukan nomor yang dikelola Bird.

Batas

FieldBatasDiterapkan oleh
Ukuran file, statis100 KBHanya WhatsApp, saat fetch (async)
Ukuran file, animasi500 KBHanya WhatsApp, saat fetch (async)
Tipe fileHanya WebPHanya WhatsApp, saat fetch (async)
captionbukan field yang validBird, saat accept (422, penolakan skema)
urlabsolut, https, memiliki host, tanpa spasi mentahBird, saat accept (422)
Bird memeriksa bentuk URL sebelum apa pun diantrikan; ia tidak memeriksa ukuran file sebenarnya, format, atau apakah file tersebut statis atau animasi. Hanya fetch WhatsApp sendiri saat pengiriman yang dapat melakukannya. Mengirim caption bukan error panjang; field tersebut tidak ada pada skema arm ini, sehingga gagal sebagai properti yang tidak dikenali. Lihat mengirim media melalui URL dan saat media gagal di hub.

Membaca stiker masuk

Stiker masuk membawa id, mime_type, dan animated yang dipelajari Bird dengan mengambil file tersebut. Ketiganya tidak ada pada pembacaan kembali pesan keluar, karena Bird tidak pernah mengambil atau memeriksa file yang dikirimnya. Lihat Menerima stiker WhatsApp untuk pembacaan masuk secara lengkap, payload whatsapp.received, dan hal-hal yang perlu diperhatikan.

Batas dan mode kegagalan

  • Jendela layanan pelanggan harus terbuka. Stiker adalah pesan layanan, hanya dapat dikirim di dalam jendela yang terbuka; lihat jendela layanan pelanggan di hub.
  • Bird menolak http; WhatsApp sendiri yang akan mengambilnya. Lihat mengirim media melalui URL di hub untuk pemeriksaan bentuk lengkap.
  • Fetch yang ditolak tetap dikenakan biaya. Lihat saat media gagal di hub. Teks penolakan stiker dari WhatsApp belum diukur secara independen, jadi perlakukan pemetaan tersebut sebagai kesimpulan berdasarkan simetri, bukan dikonfirmasi per penyebab.
  • animated bersifat read-only, dan hanya ada pada stiker masuk atau yang sudah di-fetch. Ini adalah penilaian WhatsApp sendiri terhadap file, bukan sesuatu yang dapat Anda deklarasikan. Apakah stiker statis atau animasi hanya memengaruhi batas ukurannya; WebP tetap wajib.
  • WhatsApp meng-cache URL yang di-fetch selama sekitar 10 menit. Mengirim ulang URL yang sama dalam jendela tersebut akan menyajikan kembali fetch pertama; ubah URL untuk memaksa fetch baru.

Langkah selanjutnya

  • Pesan layanan WhatsApp: jendela layanan pelanggan dan model yang digunakan bersama oleh setiap pesan layanan
  • Audio: jenis media lain tanpa field caption
  • Gambar: untuk foto atau grafis dengan caption
  • Mengirim pesan WhatsApp: envelope permintaan, model 202, dan coba lagi yang aman