Sign inGet started

Pesan gambar WhatsApp

Pesan gambar membawa URL publik yang diambil WhatsApp saat pengiriman, dengan caption opsional di bawahnya.

Mengirim gambar

Atur image.url:
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  image: { url: "https://cdn.example.com/receipt.png" },
});
console.log(msg.id, msg.status);
Bentuk lengkapnya menambahkan caption opsional:
Contoh kode
{
  "to": "+16505551234",
  "from": "+13124495648",
  "image": {
    "url": "https://cdn.example.com/receipts/a1b2c3.png",
    "caption": "Your receipt for order A1B2C3"
  }
}
image tidak memiliki field filename. from wajib ada di setiap pesan layanan: nomor yang dimiliki workspace Anda, bukan nomor yang dikelola Bird.

Batas

FieldBatasDiterapkan oleh
Ukuran file5 MBWhatsApp saja, saat fetch (async)
Tipe fileJPEG atau PNGWhatsApp saja, saat fetch (async)
captionmaksimal 1.024 karakterBird, saat accept (422)
urlabsolut, https, memiliki host, tanpa spasi mentahBird, saat accept (422)
Bird memeriksa bentuk URL dan panjang caption sebelum apa pun diantrikan. Pemeriksaan ini tidak mencakup ukuran atau tipe file yang sebenarnya; hanya fetch WhatsApp sendiri saat pengiriman yang dapat melakukannya. Lihat halaman hub mengirim media melalui URL untuk cakupan pemeriksaan bentuk tersebut, dan ketika media gagal untuk apa yang terjadi saat fetch WhatsApp menolak file.

Membaca gambar masuk

Gambar masuk membawa objek image yang sama, ditambah id dan mime_type yang dipelajari Bird dengan mengambil file tersebut. Keduanya tidak ada pada pembacaan ulang pesan keluar, karena Bird tidak pernah mengambil file yang dikirimnya. Lihat Menerima gambar WhatsApp untuk pembacaan masuk secara lengkap, payload whatsapp.received, dan hal-hal yang perlu diperhatikan.

Batas dan mode kegagalan

  • Jendela layanan pelanggan harus terbuka. Gambar adalah pesan layanan, hanya dapat dikirim dalam jendela yang terbuka; lihat halaman hub jendela layanan pelanggan.
  • Bird menolak http; WhatsApp sendiri yang akan mengambilnya. Perbedaan tersebut, beserta sisa pemeriksaan bentuk URL, ada di halaman hub mengirim media melalui URL.
  • File terlalu besar, tipe MIME salah, atau URL tidak dapat dijangkau, semuanya gagal dengan cara yang sama, dan setelah Anda dikenakan biaya. Lihat halaman hub ketika media gagal untuk media_rejected dan fakta penagihan saat gagal.
  • WhatsApp menyimpan cache URL yang telah diambil selama sekitar 10 menit. Mengirim ulang URL yang sama dalam jendela tersebut akan menyajikan hasil fetch pertama alih-alih mengambil ulang; variasikan URL (misalnya dengan query parameter) untuk memaksa pengambilan baru.

Langkah selanjutnya