Pesan Interaktif WhatsApp

Tipe yang tersedia

whatsGo mendukung tiga jenis pesan interaktif yang bisa kamu kirim melalui API:

Quick Reply (tombol balas cepat)

Quick Reply menampilkan hingga 3 tombol di bawah pesan. Pelanggan cukup mengetuk satu tombol untuk merespons. Tidak perlu mengetik pesan secara manual.

Endpoint

POST /external-api/v1/whatsapp/interactiveCopy

Contoh request

{
  "to": "+628123456789",
  "type": "interactive",
  "interactive": {
    "type": "button",
    "body": {
      "text": "Apakah kamu puas dengan layanan kami?"
    },
    "action": {
      "buttons": [
        {
          "type": "reply",
          "reply": {
            "id": "puas_1",
            "title": "Puas"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "tidak_puas_1",
            "title": "Tidak Puas"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "lainnya_1",
            "title": "Lainnya"
          }
        }
      ]
    }
  }
}Copy

Batas

CTA URL (tombol membuka link)

CTA URL menampilkan satu tombol yang, saat diketuk, akan membuka URL yang kamu tentukan. Cocok untuk mengarahkan pelanggan ke halaman pemesanan, formulir survei, atau katalog produk.

Endpoint

POST /external-api/v1/whatsapp/interactiveCopy

Contoh request

{
  "to": "+628123456789",
  "type": "interactive",
  "interactive": {
    "type": "cta_url",
    "header": {
      "type": "text",
      "text": "Lihat Katalog Kami"
    },
    "body": {
      "text": "Temukan produk terbaru kami dengan harga spesial. Klik tombol di bawah untuk melihat katalog lengkap."
    },
    "footer": {
      "text": "Berlaku hingga 31 Desember 2026"
    },
    "action": {
      "display_text": "Lihat Katalog",
      "url": "https://example.com/katalog"
    }
  }
}Copy

Batas

List (daftar pilihan)

List menampilkan daftar pilihan yang terorganisir dalam kategori. Pelanggan mengetuk tombol untuk membuka daftar, lalu memilih salah satu opsi. Cocok untuk menu layanan, opsi pembayaran, atau daftar lokasi.

Endpoint

POST /external-api/v1/whatsapp/interactiveCopy

Contoh request

{
  "to": "+628123456789",
  "type": "interactive",
  "interactive": {
    "type": "list",
    "header": {
      "type": "text",
      "text": "Menu Layanan"
    },
    "body": {
      "text": "Pilih layanan yang ingin kamu gunakan:"
    },
    "footer": {
      "text": "Ketuk untuk melihat opsi"
    },
    "action": {
      "button": "Pilih Layanan",
      "sections": [
        {
          "title": "Layanan Utama",
          "rows": [
            {
              "id": "konsultasi",
              "title": "Konsultasi",
              "description": "Konsultasi dengan tim ahli kami"
            },
            {
              "id": "perbaikan",
              "title": "Perbaikan",
              "description": "Layanan perbaikan perangkat"
            }
          ]
        },
        {
          "title": "Layanan Tambahan",
          "rows": [
            {
              "id": "pengiriman",
              "title": "Cek Pengiriman",
              "description": "Lacak status pengiriman kamu"
            },
            {
              "id": "pembayaran",
              "title": "Cek Pembayaran",
              "description": "Lihat detail tagihan dan riwayat pembayaran"
            }
          ]
        }
      ]
    }
  }
}Copy

Batas

Pesan error pesan interaktif

Ketika request gagal, API akan mengembalikan respons error dalam format berikut:

Contoh respons error

{
  "success": false,
  "error": {
    "code": "INTERACTIVE_INVALID_BUTTON",
    "message": "Jumlah tombol melebihi batas maksimum. Quick Reply maksimal 3 tombol.",
    "details": {
      "field": "interactive.action.buttons",
      "max": 3,
      "received": 5
    }
  }
}Copy

Error umum pesan interaktif

Menerima jawaban user

Ketika pelanggan mengetuk tombol atau memilih opsi dari pesan interaktif, whatsGo akan mengirimkan event ke webhook yang sudah kamu konfigurasi.

Format webhook event

{
  "event": "message.interactive_reply",
  "data": {
    "message_id": "wamid.HBgLMjEyMzQ1Njc4OQ==",
    "from": "+628123456789",
    "timestamp": 1719820800,
    "interactive": {
      "type": "button",
      "button": {
        "id": "puas_1",
        "title": "Puas"
      }
    }
  }
}Copy

Untuk pesan list, format jawabannya akan berisi list_reply dengan field id dan title dari opsi yang dipilih pelanggan:

{
  "event": "message.interactive_reply",
  "data": {
    "message_id": "wamid.HBgLMjEyMzQ1Njc4OQ==",
    "from": "+628123456789",
    "timestamp": 1719820800,
    "interactive": {
      "type": "list",
      "list_reply": {
        "id": "konsultasi",
        "title": "Konsultasi"
      }
    }
  }
}Copy