Mengirim Pesan Gambar (Image)

Endpoint ini digunakan untuk mengirimkan berkas gambar (JPEG/PNG) ke pelanggan. WhatsApp mendukung dua metode pengiriman gambar: menggunakan Media ID (berkas yang telah diunggah sebelumnya di server Meta) atau menggunakan Tautan URL gambar eksternal secara langsung.

🛜 1. HTTP Endpoint

• Opsi A (Default): POST /v1/messages (Routing otomatis menggunakan saluran aktif pertama)
• Opsi B (Spesifik): POST /v1/:phone_number_id/messages (Routing melalui nomor tertentu)

Headers:

• Authorization: Bearer <API_KEY>
• Content-Type: application/json

📦 2. Payload Request (JSON)

Metode A: Menggunakan Media ID (Direkomendasikan)

Metode ini sangat andal karena berkas gambar disimpan langsung di infrastruktur Meta. Anda dapat memperoleh Media ID dengan mengunggah gambar terlebih dahulu via API Media.

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "62812345678",
  "type": "image",
  "image": {
    "id": "18471948194819",
    "caption": "Silakan lihat gambar brosur promo kami"
  }
}

Metode B: Menggunakan Tautan URL Langsung

Menggunakan URL gambar eksternal yang dapat diakses publik oleh server Meta.

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "62812345678",
  "type": "image",
  "image": {
    "link": "https://kirem.id/assets/promo-poster.png",
    "caption": "Brosur Promo Akhir Tahun Kirem"
  }
}

Penjelasan Parameter:

• type (String - Wajib): Set nilai ke "image".
• image.id (String - Wajib jika tidak memakai link): ID media gambar hasil unggahan.
• image.link (String - Wajib jika tidak memakai ID): Tautan HTTPS langsung ke file gambar yang dihosting di server Anda (harus berakhiran format gambar, misal .jpg/.png).
• image.caption (String - Opsional): Teks keterangan yang disematkan tepat di bawah pratinjau gambar di aplikasi pelanggan.

🚦 3. Format Respons API

Respons Sukses (201 Created)

{
  "status": 201,
  "message": "Message sent successfully",
  "data": {
    "messaging_product": "whatsapp",
    "contacts": [{"input": "62812345678", "wa_id": "62812345678"}],
    "messages": [{"id": "wamid.HBgLNjI4MTIzNDU2NzhGFgQ0NDMzMzc3RUQ1OEFG"}]
  }
}

• messages[0].id: ID pesan untuk memantau status pengantaran via webhook.