Menjalankan WHAPI Lokal dengan Ngrok
Ngrok adalah layanan tunneling yang membuat server lokal bisa diakses melalui internet menggunakan URL publik. Berguna saat mengembangkan atau menguji integrasi Whapi di komputer lokal tanpa perlu menyewa VPS atau server publik.
Prasyarat
- Aplikasi Whapi sudah terinstal dan berjalan di lokal.
- Akun Ngrok sudah terdaftar dan authtoken tersedia.
Kapan Menggunakan Ngrok?
Ngrok paling berguna dalam hal berikut:
- Pengujian dan debugging webhook secara real-time di environment lokal
- Pengembangan aplikasi sebelum deploy ke server produksi
- Demo atau proof of concept tanpa biaya server
- Menghindari biaya VPS selama tahap pengembangan awal
Mendapatkan Authtoken Ngrok
Langkah 1: Daftar Akun Ngrok
- Buka ngrok.com
- Daftar menggunakan email aktif
- Verifikasi email dan login ke dashboard Ngrok
Langkah 2: Salin Authtoken
- Buka menu Getting Started > Your Authtoken di dashboard Ngrok
- Salin token yang ditampilkan
- Simpan token ini — akan digunakan di langkah berikutnya
Mengintegrasikan Ngrok dengan Whapi
- Login ke aplikasi Whapi
- Masuk ke menu Tentang > Pengaturan Aplikasi
- Temukan kolom Ngrok Authtoken
- Tempel authtoken yang sudah disalin
- Klik tombol Aktifkan
Setelah aktivasi berhasil, sistem menampilkan URL publik seperti https://random-id.ngrok-free.app. URL ini digunakan untuk mengakses API Whapi dari luar jaringan lokal.
Hal yang Perlu Diperhatikan
| Kondisi | Rekomendasi |
|---|---|
| URL berubah setiap kali Ngrok direstart | Upgrade ke paket berbayar untuk mendapatkan subdomain tetap |
| Koneksi tidak stabil | Gunakan koneksi internet yang stabil, hindari Wi-Fi publik |
| Komputer mati saat testing | Pastikan komputer tidak sleep atau mati selama sesi Ngrok aktif |
| Produksi | Ngrok tidak disarankan untuk environment produksi — gunakan VPS atau server dedicated |
Error Umum dan Solusinya
| Kondisi | Penyebab | Solusi |
|---|---|---|
| Authtoken tidak valid | Token salah atau sudah kedaluwarsa | Salin ulang authtoken dari dashboard Ngrok |
| URL publik tidak bisa diakses | Tunnel Ngrok tidak aktif | Periksa status tunnel di dashboard Ngrok dan aktifkan kembali jika perlu |
| Webhook tidak menerima data meskipun URL sudah dimasukkan | URL webhook di dashboard Whapi belum diperbarui dengan URL Ngrok | Perbarui URL webhook dengan URL Ngrok yang baru setiap kali URL berubah |