Oleh Avi
Dipublikasikan pada 20 Nov 2026
Node API Chatbot WhatsApp: Cara Memanggil Backend, CRM, atau Mesin AI Anda Saat Percakapan Berlangsung
Chatbot yang hanya mengirim pesan tetap akan cepat menemui batasnya. Node API memungkinkan bot WhatsApp Anda memanggil backend, CRM, gerbang pembayaran, atau mesin AI saat percakapan berlangsung, menyimpan respons, lalu menentukan alur berdasarkan keberhasilan atau kegagalan. Pelajari cara menyiapkan, menguji, dan menggunakannya, serta praktik terbaiknya.
Ringkasan
- Node API memungkinkan chatbot WhatsApp Anda memanggil sistem eksternal (backend, CRM, gerbang pembayaran, atau mesin AI Anda) saat pelanggan masih mengobrol.
- Bot mengirim permintaan, menunggu respons, lalu menentukan tindakan selanjutnya.
- Di Chakra Chat, Anda mengonfigurasi API, menyimpan respons dalam variabel, memilih nilainya dengan jalur JSON, lalu mengarahkan respons 2xx ke alur keberhasilan dan respons non-2xx ke alur kegagalan.
- Gunakan fitur ini saat balasan membutuhkan data terkini, bukan pesan tetap.
- Anda hanya perlu membuat endpoint sederhana. Chakra menangani sisi WhatsApp.
Pelanggan mengirim pesan ke nomor WhatsApp Anda: "Di mana pesanan saya?"
Chatbot dasar hanya bisa menjawab, "Silakan kirim ID pesanan Anda dan tim kami akan menghubungi Anda." Setelah itu, seseorang harus masuk ke dasbor, mencari pesanan, lalu mengetik balasan.
Cara ini berhasil untuk 20 obrolan sehari. Namun, cara ini tidak lagi efektif untuk 2,000 obrolan.
Solusinya bukan skrip yang lebih canggih. Solusinya adalah membiarkan bot bertanya kepada sistem Anda sendiri untuk mendapatkan jawaban. Itulah fungsi node API.
Apa itu node API dalam chatbot?
Alur chatbot terdiri dari serangkaian langkah (node): mengirim pesan, mengajukan pertanyaan, meneruskan ke staf, dan seterusnya. Node API adalah langkah yang menghubungkan chatbot dengan sistem di luar.
Menurut Chakra, node ini memungkinkan chatbot Anda memanggil API langsung dari chatbot, lalu menggunakan responsnya di langkah berikutnya dalam alur.
Bayangkan node ini seperti panggilan telepon yang dilakukan bot di tengah percakapan:
- Siapa yang dihubungi: backend Anda, CRM, gerbang pembayaran, mesin AI, atau layanan pihak ketiga apa pun yang memiliki API
- Apa yang ditanyakan: "Bagaimana status pesanan 4821?" atau "Apakah kupon DIWALI20 berlaku?"
- Apa yang dilakukan dengan jawabannya: menampilkannya kepada pelanggan, menyimpannya, atau menentukan langkah selanjutnya
Gunakan fitur ini setiap kali sebuah langkah membutuhkan data eksternal terkini , bukan pesan tetap.
Bagaimana cara kerjanya?
Konsepnya sederhana: permintaan, respons, keputusan.
- Pelanggan membalas. Bot mengumpulkan informasi yang dibutuhkan, misalnya ID pesanan, melalui node Pertanyaan.
- Node API dijalankan. Node ini mengirim permintaan ke URL Anda beserta data yang telah dikumpulkan.
- Sistem Anda merespons. Sistem mengembalikan data (status pesanan, hasil pemeriksaan kupon, balasan AI) dan kode status.
- Bot menentukan langkah selanjutnya. Respons 2xx akan mengikuti alur keberhasilan . Respons lainnya akan mengikuti alur kegagalan .
- Pelanggan melihat hasilnya. Node Pesan menampilkan nilai yang tersimpan, atau alur berlanjut ke langkah berikutnya.
Pesan pelanggan
|
Node Pertanyaan (mengumpulkan ID pesanan)
|
Node API ---> Backend / CRM / mesin AI Anda
| |
|<------ respons ---+
|
2xx? ---- ya ---> Pesan: "Pesanan Anda {{status}}"
|
tidak ----------> Pesan cadangan: "Saya akan menghubungkan Anda dengan tim kami"
Percakapan tetap berlangsung di WhatsApp. Pelanggan hanya melihat jawaban yang cepat dan spesifik.
Untuk apa saja fitur ini bisa digunakan?
Untuk situasi apa pun ketika balasan bergantung pada data yang tersimpan di sistem lain.
| Kasus penggunaan | Sistem yang dihubungi bot | Informasi yang diterima pelanggan |
|---|---|---|
| Status pesanan | Sistem pesanan Anda | "Pesanan Anda sedang diantar dan akan tiba hari ini" |
| Pemeriksaan kupon | Sistem promosi Anda | "Kode berlaku. Anda mendapat diskon 20%" |
| Pencarian data pelanggan | CRM Anda | Sapaan yang dipersonalisasi dan detail akun |
| Status pembayaran | Gerbang pembayaran | "Pembayaran diterima, terima kasih" |
| Pemesanan janji temu | Kalender atau sistem pemesanan Anda | Jadwal yang tersedia, lalu konfirmasi |
| Pengumpulan prospek | CRM atau Google Sheets | Prospek baru yang dibuat dari obrolan |
| Jawaban AI | Mesin AI atau layanan RAG Anda | Jawaban yang didukung sumber tepercaya untuk pertanyaan teks bebas |
| KYC atau pemeriksaan kelayakan | Layanan internal atau pihak ketiga | "Anda memenuhi syarat. Berikut langkah selanjutnya" |
Contoh berdasarkan industri
- D2C dan e-commerce: pelacakan pesanan, retur, pengecekan stok
- Pendidikan: status biaya, jadwal kelas, pencarian hasil
- Properti: ambil data proyek dan ketersediaan unit dari CRM Anda
- Layanan kesehatan dan klinik: cek slot janji temu dan konfirmasi pemesanan
- Logistik: pelacakan pengiriman berdasarkan nomor AWB
- Keuangan dan asuransi: status polis, tanggal jatuh tempo premi
Memanggil mesin AI Anda sendiri
Jika Anda telah membangun lapisan AI sendiri (pipeline RAG, model yang disesuaikan, copilot dukungan), node API menjadi penghubungnya.
Alurnya:
- Ajukan pertanyaan kepada pelanggan dengan node Question
- Kirim teks ke endpoint AI Anda melalui node API
- Simpan jawaban dalam variabel
- Tampilkan dalam node Message
- Jika panggilan gagal, arahkan ke staf
Beberapa tips:
- Kembalikan kolom jawaban yang singkat dan jelas. Output yang panjang sulit dibaca di WhatsApp.
- Jaga agar waktu respons tetap singkat. Pelanggan sedang melihat jendela chat.
- Selalu siapkan alur cadangan, karena endpoint AI dapat mengalami time-out atau error.
Chakra juga menyediakan AI Node bawaan dan fitur AI percakapan. Gunakan fitur tersebut jika Anda ingin memakai AI tanpa menulis kode. Gunakan node API jika Anda ingin membawa mesin, data, atau logika bisnis Anda sendiri .
Menyiapkannya di Chakra Chat
Berikut alur dari panduan Call API nodeChakra, dijelaskan dengan langkah-langkah sederhana.
1. Konfigurasikan API yang akan dipanggil
- Seret node Call API ke kanvas, di sebelah kanan node yang mengumpulkan input
- Klik Show Editor untuk membuka konfigurasi API
- Masukkan URL Anda dan pilih metode HTTP
- Pilih jenis body: form url encoded atau form multipart
- Tambahkan pasangan key/value, misalnya
order_idyang dipetakan ke jawaban pelanggan - Klik Save API
2. Masukkan data chat ke dalam permintaan
Ketik {{ di payload untuk melihat variabel yang dapat Anda sisipkan. Anda dapat menggunakan teks pesan chat terakhir dan semua informasi yang dikumpulkan sebelumnya di chatbot.
Dengan cara inilah ID pesanan atau email pelanggan disertakan dalam permintaan Anda.
3. Simpan respons API sebagai variabel
Di bagian Store response in variable?, masukkan nama seperti api_response.
4. Pilih nilai yang tepat dengan JSON path
Di bagian JSON path of value to store?, masukkan path ke nilai yang Anda inginkan. Respons dibaca melalui key response.data.
Contoh respons dari server Anda:
{
"order": {
"id": "4821",
"status": "Out for delivery",
"eta": "Today, 6 PM"
}
}
Untuk menyimpan status saja, gunakan:
response.data.order.status
Gunakan path untuk mengambil hanya nilai yang Anda perlukan agar pesan tetap ringkas, bukan menampilkan seluruh respons.
5. Buat percabangan untuk keberhasilan dan kegagalan
Node ini memiliki dua output:
- Berhasil: respons 2xx
- Gagal: respons non-2xx
Hubungkan masing-masing ke node berikutnya yang Anda inginkan.
6. Gunakan variabel dalam balasan Anda
Tambahkan node Message setelah output berhasil. Ketik @ lalu pilih variabel Anda, misalnya:
Kabar baik! Status pesanan Anda: @order_status.
Simpan node, lalu simpan chatbot.
Contoh endpoint sederhana
Di sisi Anda, endpoint hanya perlu mengembalikan JSON. Berikut contoh minimal Node.js (implementasi Anda mungkin berbeda):
app.use(express.urlencoded({ extended: true }));
app.post("/order-status", async (req, res) => {
const order = await db.findOrder(req.body.order_id);
if (!order) {
return res.status(404).json({ error: "Order not found" });
}
res.json({
order: { id: order.id, status: order.status, eta: order.eta }
});
});
Respons 404 akan masuk ke cabang kegagalan , sehingga bot Anda dapat mengatakan "Pesanan tersebut tidak dapat saya temukan" alih-alih tidak menampilkan apa pun.
Menguji sebelum mulai digunakan
Lakukan pengujian secara bertahap.
- Uji endpoint Anda secara terpisah. Gunakan alat seperti cURL atau Postman terlebih dahulu. Pastikan endpoint mengembalikan kode status dan JSON yang Anda harapkan.
- Uji alur dalam mode pratinjau builder. Builder chatbot Chakra memungkinkan Anda menyimulasikan percakapan WhatsApp sebelum diluncurkan.
- Uji skenario yang tidak berjalan sesuai harapan. ID pesanan salah, balasan kosong, server Anda tidak aktif.
- Periksa JSON path. Jika pesan tampil kosong, biasanya path tidak cocok dengan respons.
- Uji di ponsel sungguhan dengan nomor uji sebelum mengaktifkannya untuk pelanggan.
Apa yang terjadi setelah respons?
Anggap respons sebagai persimpangan jalan.
Jika berhasil (2xx):
- Tampilkan jawaban di node Message
- Gunakan nilai yang tersimpan nanti dalam alur
- Lanjutkan ke pertanyaan berikutnya atau akhiri chat dengan sopan
Jika gagal (non-2xx):
- Kirim pesan cadangan yang ramah
- Tawarkan opsi untuk mencoba lagi
- Teruskan chat ke staf dengan node Assign to Human
Menangani kegagalan dengan baik
API Anda terkadang akan gagal. Antisipasi hal ini.
- Jangan pernah membiarkan pelanggan menunggu tanpa kepastian. Setiap node API harus memiliki jalur penanganan kegagalan.
- Gunakan pesan yang spesifik. "Pesanan tersebut tidak ditemukan. Periksa ID-nya" lebih baik daripada "Terjadi kesalahan."
- Tawarkan bantuan staf. Justru saat terjadi kegagalan, bantuan seseorang paling dibutuhkan.
- Gunakan kode status yang bermakna. Kode 404 untuk "tidak ditemukan" dan 500 untuk "masalah server" memungkinkan Anda menangani setiap kasus dengan tepat.
- Pastikan panggilan berlangsung cepat. Chat menunggu jawaban, jadi endpoint yang lambat membuat balasan terasa lambat.
- Jangan gunakan untuk tugas yang berjalan lama. Untuk pekerjaan yang memerlukan waktu beberapa menit, mulai tugasnya lalu kirim hasilnya nanti sebagai pesan terpisah.
Keunggulan utama
- Jawaban langsung, bukan balasan siap pakai. Pelanggan mendapatkan data aktual di chat.
- Lebih sedikit tiket untuk tim Anda. Pertanyaan berulang ditangani dari awal hingga selesai.
- Terintegrasi dengan sistem yang sudah Anda gunakan. Anda tidak perlu memindahkan data ke chatbot.
- Gunakan logika Anda sendiri. Aturan bisnis, harga, kelayakan, dan AI tetap berada dalam kode Anda.
- Alur low-code, kode hanya jika diperlukan. Tim operasional mengelola percakapan. Developer mengelola endpoint.
- Dapat digunakan kembali. Satu endpoint dapat digunakan oleh banyak alur.
Mengapa tidak membangun semuanya di sistem sendiri?
Anda bisa. Beberapa tim melakukannya. Berikut hal-hal yang perlu dilakukan:
| Tugas | Bangun sendiri | Gunakan Chakra dengan node API |
|---|---|---|
| Hubungkan ke WhatsApp Business Platform | Anda yang membangun dan memeliharanya | Sudah disediakan untuk Anda |
| Terima dan arahkan webhook | Anda yang membangunnya | Ditangani di platform |
| Status percakapan dan logika alur | Anda yang membuat kode dan menyimpannya | Pembuat alur visual |
| Pengelolaan template | Anda yang membangunnya | Pengelolaan template bawaan |
| Kotak masuk tim dan pengalihan ke staf | Anda yang membangunnya | Sudah tersedia |
| Logika bisnis dan data | Kode Anda | Kode Anda, dipanggil melalui node API |
| Mengubah alur | Ubah kode dan lakukan deploy | Edit di pembuat alur |
Pilihan sebenarnya bukan "bangun atau beli." Pilihannya adalah apa yang ingin Anda lakukan dengan waktu developer Anda.
- Gunakan waktu untuk logika bisnis: pencarian pesanan, harga, kelayakan, AI
- Bukan untuk infrastruktur pendukung: koneksi WhatsApp, webhook, kotak masuk, dan alat alur
Kapan sebaiknya Anda membangun sendiri? Jika logika bot Anda sangat khusus, atau Anda harus menjalankan semuanya di infrastruktur sendiri. Bagi sebagian besar tim, pendekatan hibrida lebih cepat: platform menjalankan percakapan, sementara sistem Anda menyediakan jawabannya.
Praktik terbaik
- Lindungi endpoint Anda. Gunakan HTTPS dan metode autentikasi. Jangan pernah membiarkan endpoint data terbuka.
- Kembalikan JSON yang ringkas dan datar. JSON seperti ini lebih mudah dipetakan dan kecil kemungkinannya menimbulkan masalah.
- Pastikan nama kolom tetap konsisten. Perubahan struktur respons dapat membuat jalur JSON Anda diam-diam tidak berfungsi.
- Gunakan nama variabel yang jelas seperti
order_status, bukandata1. - Validasi input terlebih dahulu. Periksa format ID pesanan di alur sebelum memanggil server Anda.
- Selalu siapkan alur kegagalan.
- Jaga privasi. Tampilkan hanya informasi yang boleh dilihat pelanggan, dan verifikasi identitas sebelum menampilkan detail akun.
- Catat permintaan di sisi Anda agar Anda dapat menelusuri masalah.
Batasan yang perlu diketahui
- Chat menunggu respons, sehingga endpoint yang lambat dapat mengganggu pengalaman.
- Anda memerlukan developer untuk membuat dan mengamankan endpoint.
- Kesalahan pada jalur JSON akan menampilkan nilai kosong.
- Periksa paket mana yang mencakup node Chatbot API di halaman harga. Akses Developer API dan webhook tersedia di paket berbayar mulai dari Starter.
Alasan tim menggunakan fitur ini di Chakra Chat
Chakra melayani 2,500+ pelanggan di 65+ negara, dan chatbot builder dirancang agar mudah digunakan oleh tim bisnis serta fleksibel bagi developer.
- Builder visual dengan mode pratinjau untuk menguji alur sebelum diluncurkan
- Dukungan coexistence agar Anda dapat tetap menggunakan nomor aplikasi WhatsApp Business. Lihat cara kerjanya
- Tanpa markup pada pesan template
- Bantuan penyiapan dan dukungan berkelanjutan
- Aplikasi seluler untuk iOS dan Android
- Developer API di apidocs.chakrahq.com untuk integrasi yang lebih mendalam
Ingin melihat builder-nya? Jelajahi chatbot builder WhatsApp.
Pertanyaan umum
Apa itu node API dalam chatbot WhatsApp? Ini adalah langkah dalam alur Anda yang mengirim permintaan ke sistem eksternal dan menggunakan responsnya dalam percakapan.
Bisakah node API memanggil mesin AI saya sendiri? Ya. Kirim pesan pelanggan ke endpoint AI Anda, simpan jawabannya dalam variabel, lalu tampilkan dalam node Message.
Apa yang menentukan keberhasilan atau kegagalan? Kode status HTTP. Respons 2xx akan mengikuti cabang keberhasilan. Respons lainnya akan mengikuti cabang kegagalan.
Bagaimana cara memilih satu nilai dari respons yang panjang? Gunakan kolom jalur JSON. Respons dibaca melalui response.data, sehingga kolom status dapat ditulis sebagai response.data.order.status.
Bisakah saya meneruskan detail pelanggan ke API saya? Ya. Ketik {{ di payload untuk menyisipkan pesan chat terakhir atau variabel apa pun yang dikumpulkan sebelumnya.
Bagaimana jika server saya tidak aktif? Alur akan mengikuti cabang kegagalan. Gunakan cabang ini untuk mengirim pesan alternatif yang sopan dan mengalihkan percakapan ke staf.
Apakah saya perlu menulis kode? Anda tidak perlu menulis kode untuk alur chatbot. Namun, Anda memerlukan developer untuk membuat endpoint yang dipanggil oleh node tersebut.
Paket apa yang saya perlukan? Akses Developer API dan webhook tersedia di paket berbayar mulai dari Starter. Periksa halaman harga untuk mengetahui paket yang mencakup node Chatbot API.
Kesimpulan
Chatbot yang hanya mengirim pesan tetap adalah menu. Chatbot yang dapat meminta informasi akurat dari sistem Anda adalah asisten.
Node API adalah langkah kecil yang membuat perbedaan: kumpulkan input, hubungi sistem Anda, simpan jawabannya, lalu tentukan cabang berdasarkan keberhasilan atau kegagalan. Mulailah dengan satu kasus penggunaan sederhana, seperti status pesanan atau pemeriksaan kupon, lalu kembangkan dari sana.
Referensi
- Chakra Help: Menggunakan node Call API di chatbot
- Chakra Chat: Chatbot builder WhatsApp
- Chakra Chat: Developer API
- Dokumentasi Chakra API
- Harga Chakra Chat