Mengirim Pesan Video

Endpoint ini digunakan untuk mengirimkan berkas video (MP4/3GP) ke pelanggan. Layaknya gambar, pengiriman video mendukung dua metode: menggunakan Media ID Meta atau menggunakan Tautan URL video 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 dianjurkan karena berkas video disimpan langsung di infrastruktur Meta untuk pemutaran video yang lebih cepat.

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "62812345678",
  "type": "video",
  "video": {
    "id": "18471948194820",
    "caption": "Silakan tonton video demo produk kami"
  }
}

Metode B: Menggunakan Tautan URL Langsung

Menggunakan URL video eksternal yang dihosting publik di server Anda.

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "62812345678",
  "type": "video",
  "video": {
    "link": "https://kirem.id/assets/demo-video.mp4",
    "caption": "Video Tutorial Penggunaan Kirem API"
  }
}

Penjelasan Parameter:

• type (String - Wajib): Set nilai ke "video".
• video.id (String - Wajib jika tidak memakai link): ID media video hasil unggahan.
• video.link (String - Wajib jika tidak memakai ID): Tautan HTTPS langsung ke file video (harus berakhiran format video, misal .mp4/.3gp).
• video.caption (String - Opsional): Teks keterangan yang disematkan tepat di bawah pratinjau video 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 unik untuk melacak status pengantaran via webhook.