Chatbot AI WhatsApp dimulai dari webhook

Untuk membangun chatbot AI WhatsApp resmi bagi layanan pelanggan, hubungkan nomor bisnis ke WhatsApp Cloud API, terima pesan lewat webhook, verifikasi permintaan masuk, lalu kirim balasan melalui API. Dokumentasi WhatsApp Cloud API milik Meta menjelaskan kebutuhan akun bisnis, nomor telepon bisnis, token akses, dan pengiriman pesan. Model AI ditambahkan setelah jalur penerimaan dan balasan itu bekerja.

Urutan tersebut menentukan apakah layanan dapat menerima pesan yang tepat, menghindari balasan ganda, dan menjaga kredensial tetap di server. Mulailah dari pertanyaan yang jawabannya tersedia dalam data bisnis, seperti jam operasional. Dengan cakupan sempit, Anda dapat membedakan masalah pengiriman pesan dari masalah kualitas jawaban sebelum memperluas tugas model.

Siapkan akun, nomor, dan token

Buat aplikasi yang terhubung dengan WhatsApp Business Platform, lalu siapkan WhatsApp Business Account dan nomor yang akan melayani pelanggan. Catat ID nomor telepon untuk pengiriman melalui API. Gunakan token akses dengan izin yang sesuai, dan pisahkan kredensial percobaan dari kredensial server yang menjalankan layanan.

Simpan token dan App Secret dalam penyimpanan rahasia atau konfigurasi server yang terlindungi. Jangan menaruhnya di kode yang dikirim ke peramban, parameter URL, atau log. Kirim pesan percobaan dari server melalui endpoint nomor bisnis sebelum menghubungkan model: bila token, izin, atau ID nomor keliru, jawaban yang dihasilkan model tetap tidak akan sampai kepada pelanggan.

Terima webhook, lalu periksa asal pesannya

Permintaan melalui WhatsApp melewati pemeriksaan sebelum diproses oleh layanan pelanggan.

Sediakan endpoint HTTPS yang dapat dijangkau untuk menerima webhook. Pada tahap konfigurasi, permintaan GET membawa token verifikasi dan nilai challenge; cocokkan token dengan nilai yang Anda simpan, lalu kembalikan challenge hanya jika cocok. Setelah langganan notifikasi pesan diaktifkan, endpoint menerima POST untuk pesan masuk dan perubahan status pengiriman.

GET tersebut memeriksa konfigurasi endpoint, sedangkan setiap POST memerlukan pemeriksaan tersendiri. Pedoman keamanan aplikasi contoh Meta mensyaratkan pemeriksaan header X-Hub-Signature-256 dengan HMAC-SHA256, App Secret, dan isi permintaan asli sebelum webhook diproses. Tolak tanda tangan yang hilang atau tidak cocok; bandingkan hasil perhitungan secara aman dan jangan mencatat rahasia aplikasi dalam log.

Sesudah verifikasi, baca jenis notifikasi sebelum membuat jawaban. Perubahan status seperti pesan terkirim atau terbaca bukan pertanyaan pelanggan. Simpan ID pesan yang telah diproses agar notifikasi yang datang kembali tidak memicu balasan kedua; terima pekerjaan ke antrean dan kirim respons HTTP sukses setelah pekerjaan tersimpan, sehingga waktu tunggu model tidak menahan webhook.

Berikan model konteks secukupnya

Alur setelah webhook dapat dibuat sederhana: ambil teks pesan dan identitas percakapan, tentukan apakah jenis pesannya didukung, ambil informasi bisnis yang relevan, lalu minta model menyusun jawaban. Periksa hasilnya sebelum mengirim melalui Cloud API. Pesan suara atau gambar yang belum dapat diproses perlu mendapat respons yang jelas atau diteruskan kepada petugas, bukan diperlakukan sebagai teks kosong.

Simpan konteks minimum yang dibutuhkan untuk melanjutkan layanan: identitas percakapan, ID pesan terakhir, waktu pesan pelanggan terakhir, dan status apakah agen manusia sedang menangani percakapan. Riwayat panjang tidak perlu otomatis dikirim ke penyedia model setiap kali ada pesan baru. Tetapkan pula sumber yang boleh dipakai untuk menjawab, misalnya jam operasional atau status pesanan yang diambil dari sistem bisnis; jika data tidak tersedia, jawaban harus menyatakan keterbatasan itu atau meminta bantuan agen.

Pembatasan tersebut perlu diterapkan di server, bukan hanya ditulis dalam prompt. Sebagai contoh bersyarat, jika model menyusun janji pengembalian dana padahal sistem bisnis tidak menyediakan keputusan itu, tahan balasan otomatis dan arahkan kasusnya ke petugas. Pemeriksaan yang sama berlaku ketika jawaban menyebut perubahan pesanan atau informasi pelanggan yang tidak ditemukan dalam sumber yang diizinkan.

Atur template, persetujuan, dan bantuan manusia

Percakapan pelanggan WhatsApp dialihkan kepada agen manusia saat bantuan otomatis tidak cukup.

Dalam kebijakan berkirim pesan WhatsApp Business, bisnis dapat membalas tanpa template selama 24 jam sejak pesan terakhir pengguna; di luar periode itu, pesan harus memakai template yang disetujui. Kebijakan yang sama mengizinkan balasan otomatis selama periode layanan tersebut jika tersedia jalur eskalasi yang cepat, jelas, dan langsung. Simpan waktu pesan masuk terakhir agar sistem dapat memilih jenis balasan yang sesuai.

Jalur eskalasi dapat berupa transfer ke agen dalam percakapan, nomor telepon, email, atau saluran dukungan lain yang benar-benar dilayani. Beri pelanggan cara yang mudah dikenali untuk meminta manusia, dan hentikan balasan otomatis ketika agen mengambil alih. Sertakan ringkasan pertanyaan serta status penanganan agar pelanggan tidak perlu mengulang seluruh masalahnya.

Sebelum bisnis memulai komunikasi, catat persetujuan pelanggan, identitas bisnis yang mereka setujui, dan cara persetujuan diperoleh. Hormati permintaan untuk berhenti menerima pesan. Batasi pula data yang dikirim ke model dan yang disimpan dalam log: jangan meminta atau membagikan nomor kartu pembayaran, rekening, dokumen identitas, atau pengenal sensitif secara lengkap melalui percakapan.

Uji alur layanan sebelum memperluas cakupan

Gunakan nomor penguji untuk menjalankan alur dari awal sampai akhir: verifikasi GET, POST dengan tanda tangan valid dan tidak valid, pesan teks masuk, notifikasi status, serta pengiriman ulang ID pesan yang sama. Periksa apakah hanya pesan pelanggan yang menghasilkan satu balasan dan apakah kegagalan pengiriman tercatat tanpa membocorkan token atau isi percakapan yang tidak diperlukan. Uji juga pertanyaan di luar cakupan dan gangguan pada penyedia model; keduanya harus menghasilkan penjelasan yang jujur atau pengalihan yang dapat ditangani petugas.

Terakhir, uji template yang telah disetujui setelah periode balasan tanpa template berakhir, termasuk keadaan ketika pelanggan meminta berhenti menerima pesan. Catatan pengujian sebaiknya memisahkan kegagalan webhook, keputusan model, kegagalan API pengiriman, dan serah terima ke agen. Pemisahan ini membantu menemukan bagian yang perlu diperbaiki tanpa menjadikan prompt sebagai tempat menambal masalah pada jalur pesan.