Untuk menguji koneksi webhook Papo (https://papo.global/) sebelum mengaktifkan otomasi, Anda dapat menggunakan alat eksternal seperti Webhook.site untuk memvalidasi URL tujuan, memeriksa format payload JSON, dan memperbaiki error pengiriman tanpa memengaruhi kontak nyata. Proses ini berlaku untuk webhook bawaan akun maupun aksi “Kirim Webhook” di dalam Flows Otomasi.
Validasi awal mencegah integrasi yang rusak kehilangan data atau menghentikan perjalanan pelanggan. Dengan URL uji sementara, Anda dapat memeriksa persis apa yang dikirim Papo — header, body, dan kode respons — lalu melakukan penyesuaian sebelum mengarahkannya ke sistem final.
Ringkasan proses pengujian
| Tahap | Tindakan | Alat / lokasi |
|---|---|---|
| 1. Dapatkan URL uji | Buka webhook.site dan salin URL yang dihasilkan. | Webhook.site |
| 2. Konfigurasikan webhook di Papo dengan URL uji | Masukkan URL di kolom tujuan webhook (di bagian Integrasi atau di aksi Flow). | Panel Papo |
| 3. Picu webhook | Untuk webhook akun, kirim pesan WhatsApp ke kotak masuk yang terhubung. Untuk webhook di Flow, daftarkan kontak uji ke flow. | Kotak masuk atau Flow |
| 4. Analisis payload yang diterima | Di panel Webhook.site, lihat permintaan yang masuk: metode, header, dan JSON body. | Webhook.site |
| 5. Perbaiki dan ganti dengan URL produksi | Jika payload sudah benar, ganti URL uji dengan URL sistem Anda yang sebenarnya dan aktifkan otomasi. | Panel Papo |
Cara menguji webhook akun (Integrasi)
Webhook bawaan Papo terpicu setiap kali ada pesan baru yang diterima di kotak masuk. Untuk memvalidasinya tanpa risiko:
- Di panel Papo, buka Pengaturan > Integrasi > Webhook dan buat webhook baru.
- Tentukan pemicu — misalnya, Semua pesan — dan di kolom URL, tempel alamat sementara dari Webhook.site.
- Simpan webhook.
- Kirim pesan uji (melalui WhatsApp atau kanal lain yang terhubung) ke kotak masuk yang dipantau.
- Di Webhook.site, segarkan panel dan temukan permintaan yang baru masuk. Periksa body JSON: harus berisi data seperti nomor pengirim, isi pesan, dan ID percakapan.
- Jika JSON kosong atau tidak terbentuk dengan baik, tinjau pemicu yang dipilih dan pastikan pesan benar-benar diterima oleh kotak masuk.
- Setelah validasi, edit webhook dan ganti URL dengan URL sistem tujuan Anda.
Cara menguji aksi “Kirim Webhook” di Flows Otomasi
Di dalam editor Flows, aksi Kirim Webhook memungkinkan pengiriman data pada tahap tertentu dalam perjalanan. Pengujian dilakukan dengan flow yang aktif sementara dan kontak kontrol:
- Bangun Flow dan tambahkan node Kirim Webhook di titik yang diinginkan.
- Di panel konfigurasi node, isi URL dengan alamat Webhook.site, pilih metode POST, dan susun body JSON menggunakan variabel Papo, seperti
{{contact.name}}dan{{contact.phone}}. - Aktifkan Flow.
- Di CRM, daftarkan secara manual kontak uji ke flow tersebut (mengikuti prosedur yang sama untuk menguji Flow otomasi).
- Pantau riwayat eksekusi Flow dan, pada saat yang sama, amati Webhook.site.
- Permintaan yang diterima harus menunjukkan JSON dengan nilai nyata dari kontak uji, menggantikan variabel. Jika tidak, periksa body (gunakan
"nama": "{{contact.name}}"dan pastikan kontak memiliki kolom yang terisi). - Jika permintaan mengembalikan error 4xx atau 5xx, periksa apakah metode sudah benar (biasanya POST) dan apakah header
Content-Type: application/jsontelah disertakan. - Setelah validasi, nonaktifkan Flow, ganti URL tujuan dengan URL produksi, dan aktifkan kembali.
Untuk siapa proses ini cocok
- Administrator dan analis sistem yang perlu memastikan integritas integrasi sebelum merilisnya.
- Tim yang membangun Flow dengan webhook untuk CRM, spreadsheet, atau alat otomasi dan ingin men-debug payload tanpa memengaruhi lead nyata.
- Pengguna mana pun yang menyesuaikan webhook akun dan ingin memastikan bahwa event dikirim dengan benar.
Pertanyaan umum
Bisakah saya menguji webhook tanpa mengirim pesan nyata?
Tidak bisa untuk webhook akun, karena webhook tersebut dipicu oleh pesan masuk. Gunakan nomor WhatsApp uji (milik sendiri atau rekan) untuk menghasilkan event. Untuk Flow, pendaftaran manual kontak kontrol memungkinkan pengujian tanpa lead menjadi pelanggan sungguhan.
Apakah Webhook.site gratis? Haruskah saya menggunakannya di produksi?
Ya, Webhook.site menghasilkan URL publik sementara dan menampilkan traffic secara real time, ideal untuk debugging. Jangan pernah menggunakan URL tersebut di produksi — setelah pengujian, ganti dengan URL sistem tujuan.
Webhook terpicu tetapi payload kosong. Apa yang harus diperiksa?
Untuk webhook akun, periksa pemicu (apakah sudah menangkap jenis pesan yang benar) dan izin kotak masuk. Untuk aksi Flow, tinjau variabel di body — kolom seperti {{contact.name}} hanya akan terisi jika kontak memiliki kolom nama yang terdaftar. Uji dengan kontak yang datanya lengkap.
Bagaimana memperbaiki error 401 (tidak diizinkan) atau 403 (dilarang)?
Error ini menunjukkan bahwa sistem tujuan menolak permintaan. Tambahkan header autentikasi (misalnya, Authorization: Bearer token-anda) di kolom Headers pada konfigurasi webhook, sesuai panduan dokumentasi alat eksternal tersebut.
Bisakah saya menguji webhook Kanban dengan cara yang sama?
Ya. Webhook yang dikonfigurasi di modul Kanban dapat diuji dengan URL sementara dari Webhook.site — cukup pindahkan kartu dari satu kolom ke kolom lain (aksi yang memicu event) dan periksa payload di panel pengujian.
Apakah Flow harus tetap aktif untuk menguji webhook?
Ya. Hanya Flow dengan status Aktif yang memproses node webhook. Aktifkan flow, lakukan pengujian, lalu nonaktifkan lagi jika perlu.
Baca juga
- Cara menguji Flow otomasi sebelum mengaktifkannya
- Cara mengirim data kontak baru ke Google Sheets via webhook
Dengan pengguna pertama gratis, Anda sudah dapat membuat webhook dan menguji integrasi tanpa komitmen.