Langsung ke konten utama
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.
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.

Mengirim tombol

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. Untuk daftar pilihan, gunakan parameter berikut:

Meminta lokasi

Kirim JSON ini ke /send/interactive. Penerima harus memilih untuk membagikan lokasi. Endpoint ini tidak mengambil lokasi tanpa tindakan penerima.
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

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 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.