Panduan/Untuk developer
Pelanggan tanya "pesanan saya sudah sampai mana?" atau "tagihan saya berapa?" — bisa dijawab otomatis dari sistem kami sendiri?
Aksi "Panggil API Anda" di menu interaktif: WACO memanggil endpoint HTTPS milik Anda dengan nomor pelanggan (dan jawaban pelanggan bila bertanya dulu), lalu membalas isi "teks" dari jawaban endpoint. Kontrak, contoh n8n, dan endpoint uji.
3 menit baca
Pertanyaan "sudah sampai mana", "tagihan saya berapa", "tiket saya sudah ditangani?" jawabannya ada di sistem Anda, bukan di kepala staf. Dengan aksi Panggil API Anda di menu interaktif, pelanggan memilih satu baris menu, WACO memanggil endpoint Anda, dan jawabannya terkirim ke pelanggan dalam hitungan detik — tanpa AI, tanpa staf.
Cara memasangnya
- Buka Formulir → Atur menu interaktif, tambah pilihan, pilih aksi Panggil API Anda.
- Isi URL API (wajib HTTPS) dan, bila endpoint Anda dilindungi,
Kunci rahasia — dikirim sebagai
Authorization: Bearer …. - Kolom teks opsional: bila diisi, WACO mengirimnya sebagai pertanyaan dulu
(mis. "Ketik nomor pesanan Anda"), dan balasan pelanggan berikutnya ikut dikirim ke API sebagai
jawaban. Kosongkan bila cukup nomor WhatsApp-nya (mis. cek tagihan pelanggan ISP). - Simpan, lalu coba dari kartu Kirim uji.
Belum punya endpoint? Pakai URL contoh
https://waco.id/api/v1/menu/contoh-api — ia menjawab dengan teks contoh berisi nomor dan jawaban yang Anda ketik, supaya alurnya terlihat dulu.Kontrak: yang WACO kirim
POST {URL Anda}
Content-Type: application/json
Authorization: Bearer {kunci rahasia} ← hanya bila diisi
{
"nomor": "628111222333",
"nama": "Budi",
"pilihan": { "id": "m2", "judul": "Cek pesanan" },
"jawaban": "INV-2026-0912", ← null bila pilihan tidak bertanya dulu
"waktu": "2026-09-05T03:20:11.000Z"
}
Kontrak: yang Anda jawab
HTTP 200
Content-Type: application/json
{ "teks": "Pesanan INV-2026-0912: DIKIRIM 4 Sep, estimasi tiba besok. Resi JNE 123456." }
teksmaksimal 4096 huruf, boleh beberapa baris. Emoji boleh.- Batas waktu 8 detik. Lewat itu, atau status bukan 200, atau tanpa medan
teks, pelanggan menerima teks cadangan ("Maaf, sistem kami sedang tidak bisa dihubungi…") dan percakapan tetap terbuka untuk staf. - Jangan mengembalikan data sensitif lebih dari yang perlu dilihat pelanggan; yang Anda kembalikan langsung tampil di WhatsApp mereka.
Contoh: n8n dalam 3 node
- Webhook (POST, Respond: "Using Respond to Webhook node") — URL-nya yang Anda tempel di WACO.
- HTTP Request atau Postgres/MySQL: cari pesanan berdasarkan
{{$json.body.jawaban}}atau tagihan berdasarkan{{$json.body.nomor}}. - Respond to Webhook: JSON
{"teks": "Pesanan {{...}}: {{...}}"}.
Pola yang sama berlaku untuk Make, Zapier, atau satu route kecil di aplikasi Anda sendiri.
Yang perlu diketahui
- Operator AI diam saat pelanggan menjawab pertanyaan pilihan API, supaya tidak ada dua balasan.
- Jawaban pertanyaan ditunggu 10 menit; setelah itu pesan pelanggan diperlakukan biasa.
- Kunci rahasia tersimpan di pengaturan menu tenant Anda. Pakai kunci khusus untuk WACO, bukan kunci utama sistem Anda, supaya mudah dicabut.
← SebelumnyaReservasi dari formulir chat sampai pengingat & ucapan ulang tahun — bagaimana alurnya?
Berikutnya →Pelanggan chat "halo" lalu bingung harus tanya apa. Bisa langsung dikasih menu pilihan seperti bot rumah sakit?
Masih menemui kendala setelah mengikuti panduan ini?
Hubungi kami dari dashboard — sertakan tangkapan layar bila ada, itu mempercepat
semuanya.