Panduan/Untuk developer
Ingin pelanggan bisa memilih paket dan membayar dari WhatsApp tanpa membuka aplikasi lain, seperti perpanjang WACO.
Resep menirukan "perpanjang lewat WhatsApp" milik WACO untuk tagihan Anda: webhook pesan masuk → tawarkan paket dengan /api/v1/tombol → jawaban pilihan lewat webhook → buat tagihan + QR di sistem Anda → kirim gambar QR dengan /api/v1/kirim-media → kabari lunas dengan /api/v1/balas.
2 menit baca
WACO memperpanjang langganannya sendiri lewat WhatsApp (lihat panduannya). Alur itu dibangun dari empat bahan yang semuanya tersedia untuk Anda lewat API, tidak ada yang khusus.
Bahan
- Webhook
message.received: pesan pelanggan masuk ke sistem Anda, berisi nomor pengirim (kunci untuk mengenali akunnya) dan, untuk balasan tombol/daftar,pesan.pilihan = {id, judul}. POST /api/v1/tombol: pesan dengan 1–3 tombol balas (judul ≤20 huruf, id bebas).POST /api/v1/daftar: pesan daftar pilihan hingga 10 baris, untuk paket yang lebih banyak atau memilih akun.POST /api/v1/kirim-mediadengantipe: "image"dan URL gambar QR yang Anda buat (QRIS dari payment gateway Anda, atau kode pembayaran apa pun), laluPOST /api/v1/balasuntuk teks bebas seperti kabar lunas. Semuanya pesan sesi: berlaku 24 jam sejak pesan terakhir pelanggan.
Alurnya
- Webhook menerima
{"pesan":{"teks":"perpanjang"},"dari":"628…"}. Sistem Anda mencari akun dengan nomor itu. - Tawarkan paket:
POST /api/v1/tombol {"nomor":"628111222333", "judul":"Perpanjang langganan", "teks":"Akun: Toko Maju Aktif sampai 30 September 2026 Pilih paket:", "tombol":[{"id":"paket:1","judul":"1 bulan Rp200rb"}, {"id":"paket:6","judul":"6 bulan Rp1,1jt"}, {"id":"paket:12","judul":"12 bulan Rp2jt"}]} - Webhook menerima balasan:
"pesan":{"tipe":"interactive","pilihan":{"id":"paket:6","judul":"6 bulan Rp1,1jt"}}. Sistem Anda membuat invoice dan QR di payment gateway, lalu menaruh gambar QR di URL https publik (boleh ber-token, boleh kedaluwarsa). - Kirim QR-nya:
POST /api/v1/kirim-media {"nomor":"628111222333","tipe":"image", "url":"https://app.anda.id/qr/inv-2026-0912.png", "caption":"Paket 6 bulan. Rp 1.221.000 termasuk PPN. Berlaku 30 menit."} - Saat payment gateway Anda melapor lunas, kabari pelanggan:
POST /api/v1/balas {"nomor":"628111222333","teks":"Pembayaran diterima. Langganan aktif sampai 31 Maret 2027. Terima kasih!"}
Di n8n: satu Webhook node menerima pesan, satu IF memisahkan teks "perpanjang" dan balasan pilihan, dua HTTP Request node memanggil /api/v1/tombol dan /api/v1/kirim-media. Simpan id pilihan sebagai "paket:" supaya tidak perlu mencocokkan judul.
Semua pesan di atas adalah pesan sesi, hanya sah dalam 24 jam sejak pesan terakhir pelanggan. Untuk mengingatkan pelanggan yang diam, mulai dengan template (misalnya pengingat masa aktif) lalu lanjutkan alur ini begitu ia membalas.
← SebelumnyaIngin mengirim blast, mengecek laporan, atau membalas pelanggan cukup dengan mengobrol ke asisten AI Anda sendiri (Claude, ChatGPT, Cursor), tanpa membuka portal.
Berikutnya →Pelanggan bertanya harga lalu memesan lewat chat dengan format bebas, staf mencatat ulang, salah jumlah, lupa total, bukti bayar tak ketemu pesanannya.
Masih menemui kendala setelah mengikuti panduan ini?
Hubungi kami dari dashboard, sertakan tangkapan layar bila ada, itu mempercepat
semuanya.