Tombol Interaktif & List

https://dash.ngirimwa.com/api/v1

x-api-key: API_KEY_ANDA
Content-Type: application/json
Idempotency-Key: <uuid-unik-per-request>

POST /messages/quick-reply

{
  "to": "628123456789",
  "text": "Mau lanjut order?",
  "footer": "Tim NgirimWA",
  "buttons": [
    { "kind": "reply", "text": "Ya, lanjut", "id": "yes" },
    { "kind": "reply", "text": "Tidak", "id": "no" }
  ]
}

{
  "to": "628123456789",
  "title": "Konfirmasi Pesanan",
  "text": "Pesanan ORD-12345 sudah kami siapkan.",
  "footer": "Toko XYZ",
  "image": { "url": "https://domain-anda.com/banner.jpg" },
  "buttons": [
    { "kind": "reply", "text": "Konfirmasi", "id": "confirm_12345" },
    { "kind": "url",   "text": "Lihat invoice", "url": "https://domain-anda.com/inv/12345" },
    { "kind": "call",  "text": "Telepon CS",    "phone": "62811223344" }
  ]
}

{
  "to": "628123456789",
  "text": "Selamat! Voucher diskon 20% untuk Anda.",
  "buttons": [
    { "kind": "copy", "text": "Salin kode", "code": "PROMO20" }
  ]
}

{
  "success": true,
  "message": "Quick-reply message sent successfully"
}

curl -X POST https://dash.ngirimwa.com/api/v1/messages/quick-reply \
  -H "x-api-key: API_KEY_ANDA" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "628123456789",
    "text": "Pilih jenis pengiriman:",
    "buttons": [
      { "kind": "reply", "text": "Reguler",  "id": "ship_reg" },
      { "kind": "reply", "text": "Express",  "id": "ship_exp" },
      { "kind": "url",   "text": "Tarif",    "url": "https://domain-anda.com/tarif" }
    ]
  }'

POST /messages/buttons

{
  "to": "628123456789",
  "text": "Apakah Anda puas dengan layanan kami?",
  "footer": "Berikan rating dengan menekan tombol",
  "buttons": [
    { "buttonId": "rate_5", "displayText": "⭐⭐⭐⭐⭐ Sangat Puas" },
    { "buttonId": "rate_3", "displayText": "⭐⭐⭐ Cukup" },
    { "buttonId": "rate_1", "displayText": "⭐ Kurang" }
  ]
}

POST /messages/interactive

{
  "to": "628123456789",
  "text": "Ada yang bisa kami bantu?",
  "footer": "NgirimWA Support",
  "image": { "url": "https://domain-anda.com/logo.png" },
  "buttons": [
    { "name": "quick_reply", "params": { "display_text": "Tanya", "id": "ask" } },
    { "name": "cta_url",     "params": { "display_text": "Web",   "url": "https://ngirimwa.com", "merchant_url": "https://ngirimwa.com" } }
  ]
}

POST /messages/list

{
  "to": "628123456789",
  "text": "Pilih kategori produk yang Anda cari:",
  "title": "Katalog Toko",
  "footer": "Tim NgirimWA",
  "buttonText": "Pilih kategori",
  "sections": [
    {
      "title": "Elektronik",
      "rows": [
        { "title": "Laptop",      "rowId": "cat_laptop",  "description": "Laptop & aksesoris" },
        { "title": "Smartphone",  "rowId": "cat_phone",   "description": "HP & aksesoris" }
      ]
    },
    {
      "title": "Fashion",
      "rows": [
        { "title": "Pakaian Pria", "rowId": "cat_male",   "description": "Kemeja, kaos, celana" },
        { "title": "Pakaian Wanita", "rowId": "cat_female", "description": "Dress, blouse, rok" }
      ]
    }
  ]
}

POST /messages/carousel

{
  "to": "628123456789",
  "text": "Cek produk terbaru kami:",
  "cards": [
    {
      "image": { "url": "https://domain-anda.com/produk1.jpg" },
      "title": "Sepatu Sport",
      "body":  "Ringan, nyaman, harga Rp 350.000",
      "buttons": [
        { "name": "cta_url", "params": { "display_text": "Beli", "url": "https://domain-anda.com/p/1", "merchant_url": "https://domain-anda.com/p/1" } }
      ]
    },
    {
      "image": { "url": "https://domain-anda.com/produk2.jpg" },
      "title": "Tas Ransel",
      "body":  "Tahan air, kapasitas 30L",
      "buttons": [
        { "name": "quick_reply", "params": { "display_text": "Info detail", "id": "info_bag_2" } }
      ]
    }
  ]
}