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

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

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:

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