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.