Mengirim Pesan Interaktif (Interactive)

WhatsApp mendukung pengiriman pesan interaktif agar pelanggan dapat berinteraksi dengan mudah tanpa mengetik teks manual secara lengkap. Format interaktif yang paling populer adalah Pesan Tombol Cepat (Quick Reply Buttons) dan Daftar Pilihan Menu (List Messages).

🛜 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)

A. Mengirim Tombol Cepat (Quick Reply Buttons)

Menampilkan hingga maksimal 3 tombol klik cepat di bawah balon pesan obrolan.

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "62812345678",
  "type": "interactive",
  "interactive": {
    "type": "button",
    "header": {
      "type": "text",
      "text": "Konfirmasi Pendaftaran"
    },
    "body": {
      "text": "Apakah Anda bersedia melanjutkan pendaftaran?"
    },
    "footer": {
      "text": "Layanan Pendaftaran Otomatis"
    },
    "action": {
      "buttons": [
        {
          "type": "reply",
          "reply": {
            "id": "btn_yes",
            "title": "Ya, bersedia"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "btn_no",
            "title": "Tidak, batalkan"
          }
        }
      ]
    }
  }
}

B. Mengirim Daftar Menu Pilihan (List Messages)

Menampilkan tombol dropdown menu yang dapat memuat hingga maksimal 10 pilihan baris menu terorganisir.

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "62812345678",
  "type": "interactive",
  "interactive": {
    "type": "list",
    "header": {
      "type": "text",
      "text": "Pusat Layanan Kirem"
    },
    "body": {
      "text": "Silakan pilih menu bantuan di bawah ini untuk memulai interaksi."
    },
    "footer": {
      "text": "Kirem Bot Service"
    },
    "action": {
      "button": "Pilih Bantuan",
      "sections": [
        {
          "title": "Layanan Umum",
          "rows": [
            {
              "id": "menu_billing",
              "title": "Cek Tagihan",
              "description": "Melihat rincian tagihan bulanan Anda"
            },
            {
              "id": "menu_support",
              "title": "Hubungi Support",
              "description": "Hubungkan dengan tim developer support"
            }
          ]
        },
        {
          "title": "Layanan Teknis",
          "rows": [
            {
              "id": "menu_webhook_test",
              "title": "Uji Webhook",
              "description": "Kirim payload testing ke server Anda"
            }
          ]
        }
      ]
    }
  }
}

🚦 3. Penanganan Webhook Event Klik Pelanggan

Ketika pelanggan mengklik tombol Quick Reply atau memilih baris menu List Message di aplikasi WhatsApp mereka, server Anda akan menerima webhook callback berupa event messages.received dengan detail payload sebagai berikut:

Contoh Callback Webhook Klik Tombol (Quick Reply):

{
  "event": "messages.received",
  "data": {
    "from": "62812345678",
    "message_id": "wamid.HBgLN...",
    "type": "interactive",
    "interactive": {
      "type": "button_reply",
      "button_reply": {
        "id": "btn_yes",
        "title": "Ya, bersedia"
      }
    }
  }
}

• id: Nilai pengenal unik tombol (btn_yes) yang dapat Anda gunakan di server untuk mengeksekusi logika alur bot selanjutnya secara otomatis.