Skip to main content

Menjalankan WHAPI Lokal dengan Ngrok

WHAPI dapat dijalankan secara lokal di perangkat seperti PC, laptop, atau bahkan Raspberry Pi. Namun, ketika membangun sistem otomatisasi berbasis WhatsApp, source code WHAPI perlu menjadi bagian dari aplikasi utama dan tidak dapat dijalankan sebagai layanan yang benar-benar terpisah.

Jika ingin mengakses aplikasi WHAPI secara online tanpa menyewa VPS, hosting, atau Remote Desktop (RDP), solusi yang umum digunakan adalah Ngrok.

Ngrok berfungsi sebagai jembatan (tunnel) antara aplikasi lokal dan internet, sehingga server lokal bisa diakses secara publik melalui URL aman.

Apa Itu Ngrok?​

Ngrok adalah layanan tunneling yang memungkinkan port lokal terbuka ke internet dengan aman. Dengan Ngrok, aplikasi yang berjalan di localhost bisa diakses menggunakan URL publik yang bersifat sementara atau permanen, tergantung paket yang digunakan.

Kunjungi situs resmi Ngrok untuk informasi lebih lengkap:

ngrok | API Gateway, Kubernetes Ingress, Webhook Gateway

Kapan Perlu Menggunakan Ngrok?​

Penggunaan Ngrok sangat bermanfaat dalam skenario berikut:

  • Pengujian dan debugging WhatsApp automation secara real-time
  • Pengembangan aplikasi di lingkungan lokal tanpa server publik
  • Mendistribusikan URL sementara untuk keperluan demo atau uji coba
  • Menghindari biaya sewa VPS atau cloud hosting saat tahap pengembangan

Dengan kata lain, Ngrok cocok untuk pengembang, QA engineer, atau tim teknis yang ingin menjalankan WhatsApp API lokal namun tetap bisa mengaksesnya dari luar jaringan internal.

Cara Mendapatkan Authtoken Ngrok​

Authtoken diperlukan agar Ngrok bisa dijalankan secara resmi dan stabil.
Berikut langkah-langkah mendapatkan authtoken:

1. Registrasi Akun Ngrok​

  1. Buka situs resmi Ngrok: https://ngrok.com
  2. Daftar menggunakan email aktif
  3. Setelah verifikasi, login ke dashboard Ngrok

2. Salin Authtoken​

  1. Buka menu Getting Started ➝ Your Authtoken
  2. Salin token yang tertera di halaman dashboard
  3. Simpan token ini karena akan digunakan dalam konfigurasi WHAPI

Integrasi Ngrok dengan WHAPI​

Setelah memiliki authtoken, lanjutkan dengan integrasi ke dalam aplikasi WHAPI lokal:

  1. Login ke aplikasi WHAPI
  2. Masuk ke menu Tentang ➝ Pengaturan Aplikasi
  3. Temukan kolom untuk memasukkan Ngrok Authtoken
  4. Tempel token yang sudah disalin
  5. Klik tombol Aktifkan

Integrasi Ngrok dengan WHAPI

Setelah aktivasi berhasil, sistem akan menampilkan URL publik (misalnya https://random-id.ngrok-free.app) yang dapat digunakan untuk mengakses API secara online.

Best Practice Penggunaan Ngrok​

Untuk hasil lebih stabil dan aman, berikut beberapa rekomendasi teknis:

  • Gunakan koneksi internet yang stabil saat menjalankan WHAPI lokal
  • Hindari mematikan PC/laptop saat sedang testing dengan Ngrok
  • Jika URL berubah setiap restart, pertimbangkan upgrade ke paket berbayar agar mendapatkan subdomain tetap
  • Selalu periksa status tunnel Ngrok sebelum mengirim request ke API

Kesimpulan​

Integrasi Ngrok dengan WHAPI memungkinkan pengembangan dan pengujian WhatsApp automation secara lokal tanpa harus menyewa server publik. Dengan konfigurasi yang sederhana dan fleksibel, aplikasi lokal bisa diakses dari mana saja secara aman dan sementara.

Solusi ini sangat berguna pada tahap pengembangan awal, proof of concept (PoC), atau ketika ingin melakukan demo kepada klien