Menerima gambar WhatsApp

Foto atau grafik yang dikirim kontak tiba sebagai pesan masuk yang membawa image: referensi ke file yang disimpan Bird untuk Anda, beserta caption apa pun yang mereka ketik di bawahnya.

Isi pesan gambar masuk

Contoh kode

{
  "id": "wam_01kya19eknftrs2s6p82asmvnh",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "image": {
    "id": "waf_01kyb2m4xq7whs0d8n3prv6tez",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kya19eknftrs2s6p82asmvnh/media/waf_01kyb2m4xq7whs0d8n3prv6tez",
    "mime_type": "image/jpeg",
    "caption": "Is this the right part?"
  },
  "created_at": "2026-08-25T09:04:11Z"
}

Field	Isinya
id	File tersimpan, dikirim sebagai media_id saat mengambil byte
url	URL Bird, diambil dengan kunci API Anda
mime_type	Tipe media yang dilaporkan WhatsApp untuk file tersebut, misalnya image/jpeg
caption	Teks yang diketik kontak di bawah gambar; tidak ada jika mereka tidak mengirimnya

id dan mime_type hanya muncul pada gambar masuk: Bird mempelajari keduanya dengan mengambil file, dan tidak pernah menyimpan yang Anda kirim. Gambar keluar terbaca kembali dengan url yang Anda berikan dan tanpa id.

Perlakukan mime_type sebagai laporan WhatsApp, bukan jaminan, dan gunakan nilainya untuk percabangan alih-alih ekstensi file di url, yang tidak memiliki ekstensi.

Mengambil byte

url dan id keduanya menunjuk ke file tersimpan yang sama: kirim ID pesan dan id media ke metode media channel, dalam SDK mana pun, CLI, atau cURL. Halaman mengambil media masuk di hub memuat panggilan tersebut dalam setiap bahasa, beserta aturan redirect dan header yang diikutinya.

Pesan dan medianya kedaluwarsa bersamaan, 30 hari setelah pesan tiba; halaman mengambil media masuk di hub mengatur jendela waktu tersebut dan apa yang dikembalikan pembacaan setelah melewatinya. Simpan gambar yang Anda butuhkan lebih lama selagi pesan masih dapat dibaca.

Payload webhook

whatsapp.received membawa arm image pada envelope event, termasuk referensi media:

Contoh kode

{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:04:11.118Z",
  "data": {
    "whatsapp_id": "wam_01kya19eknftrs2s6p82asmvnh",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "image": {
      "id": "waf_01kyb2m4xq7whs0d8n3prv6tez",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kya19eknftrs2s6p82asmvnh/media/waf_01kyb2m4xq7whs0d8n3prv6tez",
      "mime_type": "image/jpeg",
      "caption": "Is this the right part?"
    },
    "tags": null,
    "metadata": null
  }
}

Webhook aktif saat pesan tiba, yang juga merupakan awal jendela retensi, sehingga endpoint yang mengantre pengambilan alih-alih langsung mengambilnya memiliki seluruh jendela waktu untuk mengejar.

Hal yang perlu diperhatikan

Caption milik kontak. Caption tiba sebagai teks biasa tanpa format atau informasi entitas, jadi tampilkan sebagai teks.
Satu gambar per pesan. Kontak yang mengirim beberapa foto menghasilkan beberapa pesan masuk, masing-masing dengan id dan referensi media sendiri. Kelompokkan berdasarkan from dan waktu tiba; tidak ada array yang mengumpulkannya.

Langkah selanjutnya

Cara kerja penerimaan: envelope masuk, pengambilan media, dan webhook whatsapp.received
Pesan gambar WhatsApp: sisi kirim dari arm yang sama
Menerima dokumen: bentuk media yang sama, dengan nama file pengirim
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 channel Pahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builder Jelajahi kemampuannyaWhatsApp

Coba praktiknya dan dapatkan ringkasan implementasi