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

Alurnya

  1. Webhook menerima {"pesan":{"teks":"perpanjang"},"dari":"628…"}. Sistem Anda mencari akun dengan nomor itu.
  2. 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"}]}
  3. 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).
  4. 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."}
  5. 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.
Masih menemui kendala setelah mengikuti panduan ini? Hubungi kami dari dashboard — sertakan tangkapan layar bila ada, itu mempercepat semuanya.