> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesan interaktif eksperimental

> Kirim tombol balasan, ajakan bertindak, daftar pilihan, permintaan lokasi, dan carousel gambar.

`POST /send/interactive` mengirim pesan native-flow WhatsApp melalui perangkat yang dipilih. Gunakan Basic Auth, `X-Device-Id`, dan body JSON. Endpoint ini mendukung pengiriman langsung melalui REST. Pengiriman terjadwal dan MCP tidak menyediakan fitur ini.

> [!WARNING]
>
> Endpoint eksperimental ini menggunakan protokol WhatsApp tidak resmi. Tampilan di sisi penerima berbeda menurut klien dan dapat berubah tanpa pemberitahuan. Uji pada klien tujuan sebelum digunakan. Respons API yang berhasil mengonfirmasi bahwa permintaan pengiriman diterima, bukan bahwa pesan telah terkirim atau ditampilkan.

Atur URL server dan kredensial sebelum menjalankan contoh curl. Gunakan URL HTTPS publik untuk server jarak jauh dan sertakan `APP_BASE_PATH` jika dikonfigurasi.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Mengirim tombol

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H 'Content-Type: application/json' -H "X-Device-Id: $DEVICE_ID" \
  "$GOWA_URL/send/interactive" --data '{
    "phone": "628123456789",
    "body": "Confirm your order?",
    "footer": "Order 123",
    "buttons": [
      {"name": "quick_reply", "params": {"display_text": "Confirm", "id": "confirm"}},
      {"name": "quick_reply", "params": {"display_text": "Cancel", "id": "cancel"}}
    ]
  }'
```

`phone` menerima nomor telepon atau JID lengkap pengguna maupun grup. Pengiriman ke grup memerlukan keanggotaan dan izin mengirim pesan. Penerima newsletter dan broadcast tidak didukung.

Sediakan `buttons` atau `cards` pada tingkat teratas. Menyertakan keduanya, atau tidak menyertakan keduanya, akan gagal dalam validasi.

| Nama tombol | Parameter wajib |
| - | - |
| `quick_reply` | String `display_text` dan `id` yang tidak kosong. |
| `cta_url` | `display_text` yang tidak kosong dan `url` HTTP atau HTTPS absolut. |
| `cta_copy` | String `display_text` dan `copy_code` yang tidak kosong. |
| `cta_call` | String `display_text` dan `phone_number` yang tidak kosong. |
| `single_select` | `title` dan `sections` yang tidak kosong. Setiap bagian memerlukan `rows` yang tidak kosong; setiap baris memerlukan string `id` dan `title` yang tidak kosong. |
| `send_location` | Objek JSON seperti `{}`. Harus menjadi satu-satunya tombol dalam pesan tanpa kartu. |

Untuk daftar pilihan, gunakan parameter berikut:

```json theme={null}
{
  "name": "single_select",
  "params": {
    "title": "Choose a size",
    "sections": [{
      "title": "Sizes",
      "rows": [
        {"id": "small", "title": "Small"},
        {"id": "large", "title": "Large"}
      ]
    }]
  }
}
```

## Meminta lokasi

```json theme={null}
{
  "phone": "628123456789",
  "body": "Share your delivery location",
  "buttons": [{"name": "send_location", "params": {}}]
}
```

Kirim JSON ini ke `/send/interactive`. Penerima harus memilih untuk membagikan lokasi. Endpoint ini tidak mengambil lokasi tanpa tindakan penerima.

## Mengirim carousel gambar

```json theme={null}
{
  "phone": "628123456789",
  "body": "Choose a product",
  "cards": [
    {
      "title": "Product A",
      "body": "Available in blue",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose A", "id": "choose_a"}}]
    },
    {
      "title": "Product B",
      "body": "Available in green",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose B", "id": "choose_b"}}]
    }
  ]
}
```

Ganti placeholder gambar dengan base64 standar mentah, tanpa awalan data URL. Gambar bersifat opsional pada setiap kartu. GOWA menyesuaikan ukuran gambar agar muat dalam 1280 piksel, mengonversinya ke JPEG, membuat thumbnail, lalu mengunggahnya ke WhatsApp. URL gambar jarak jauh tidak diterima.

## Batas permintaan

| Kolom | Batas |
| - | - |
| `body` pesan | Wajib diisi dan tidak boleh hanya berisi spasi, maksimum 4096 byte. |
| `footer` pesan | Maksimum 256 byte. |
| `buttons` | 1–10 per pesan atau kartu. |
| `params` tombol | Objek JSON, maksimum 16,384 byte. |
| `cards` | 2–10 kartu. |
| `body` kartu | Wajib diisi dan tidak boleh hanya berisi spasi, maksimum 4096 byte. |
| `title` dan `footer` kartu | Masing-masing maksimum 256 byte. |
| `image_base64` kartu | Maksimum 2,800,000 karakter terenkode dan 2,000,000 byte setelah didekode, serta tunduk pada batas ukuran gambar yang dikonfigurasi di server. |
| Gambar setelah didekode | JPEG atau PNG, maksimum 4096 piksel per sisi. |

Batas keseluruhan body permintaan HTTP server juga berlaku. Gunakan gambar kecil saat mengirim beberapa kartu. Pilihan atau ukuran yang tidak valid menghasilkan kesalahan validasi sebelum pengiriman.

## Menangani balasan dan tanda terima

Pengiriman yang berhasil mengembalikan struktur respons sukses biasa dengan `results.message_id` dan status yang menyatakan bahwa tampilan di sisi penerima belum diverifikasi. Gunakan [webhook masuk](https://gowa-docs.mintlify.site/id/concepts/webhooks.md) untuk balasan dan event `message.ack` untuk tanda terima. Percobaan ulang setelah timeout dengan hasil yang tidak pasti dapat menggandakan pesan.

Pengujian Android oleh pihak pengguna melaporkan bahwa tindakan balasan, URL, salin, panggilan, pilihan, lokasi, dan carousel berfungsi. Laporan tersebut tidak membuktikan kompatibilitas di seluruh akun, iOS, atau WhatsApp Web. Setiap kartu carousel dapat menampilkan ikon tertunda meskipun pesan induknya sudah memiliki tanda centang dan penerima dapat membalas. Masalah tersebut belum terselesaikan.

Endpoint ini tidak mendaftarkan template resmi maupun mendukung Flows inline, katalog, atau pembayaran native.


## Related topics

- [Kirim pesan interaktif eksperimental](https://gowa-docs.mintlify.site/id/api-reference/send/kirim-pesan-interaktif-eksperimental.md)
- [Mengirim Pesan](https://gowa-docs.mintlify.site/id/examples/sending-messages.md)
- [Referensi API](https://gowa-docs.mintlify.site/id/api-reference/introduction.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/id/index.md)
- [Tarik Pesan](https://gowa-docs.mintlify.site/id/api-reference/message/tarik-pesan.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.