Panduan Install WhatsApp API Whapi di Semua Sistem Operasi

Panduan instalasi Whapi di Windows, Linux, dan macOS, mulai dari persiapan software hingga aplikasi siap diakses melalui browser.

Prasyarat

Pastikan software berikut sudah terinstal, cek di terminal/CMD sebelum memulai:

Software	Versi Minimum	Cara Cek
NodeJS	Versi 20	node --version
GIT	Terbaru	git --version

Instal PM2 secara global:

npm install pm2 -g

PM2 adalah pengelola proses untuk Node.js yang memastikan aplikasi tetap aktif meski terminal ditutup.

Langkah 1: Unduh Aplikasi Whapi

Kunjungi halaman berikut, masukkan license key, nama, dan email. Setelah data tervalidasi, tombol unduh akan aktif:

Download Aplikasi Whapi

Setelah file .zip diunduh, ekstrak ke folder yang diinginkan, lalu buka terminal atau command prompt di dalam folder hasil ekstraksi.

Langkah 2: Instal Dependensi

Jalankan perintah berikut di dalam folder hasil ekstraksi:

npm install

Pastikan koneksi internet stabil selama proses ini. Instalasi membutuhkan beberapa menit tergantung kecepatan koneksi.

info

Pastikan koneksi internet Anda stabil dan cepat selama proses ini. Kestabilan jaringan sangat berpengaruh pada kelancaran instalasi dependensi.

Langkah 3: Konfigurasi File .env

File .env berisi pengaturan dasar aplikasi dan berada di folder root hasil ekstraksi.

Parameter Wajib

Parameter	Default	Keterangan
PORT	3000	Port aplikasi. Pastikan tidak konflik dengan layanan lain
LANGUAGE	en_US	Bahasa aplikasi: id_ID, en_US, pt_BR
SESSION_SECRET	WHAPI-WHATSAPP-GATEAWAY	Kunci sesi. Ganti dengan string unik yang kuat
DIR_SESSION	./session/	Direktori penyimpanan sesi WhatsApp. Jangan diubah
FILE_LICENSE	license.json	Nama file lisensi. Jangan diubah

Contoh konfigurasi:

PORT=3000
LANGUAGE=en_US
SESSION_SECRET=KunciRahasiaUnikSaya123
DIR_SESSION=./session/
FILE_LICENSE=license.json

Parameter Opsional

Parameter	Contoh Nilai	Keterangan
WHATSAPP_CONN_DEVICENAME	Brand_Anda	Nama perangkat yang tampil di WhatsApp
WHATSAPP_CONN_IDMSG	WHPI	ID pesan kustom, maksimal 4 karakter uppercase
DELAY_AUTOSTART_DEVICE	5000	Delay memulai perangkat ketika aplikasi berjalan dalam milidetik

Konfigurasi Proxy Otomatis (Opsional)

Parameter	Nilai	Keterangan
PROXY_ENABLE_ALL	true / false	Aktifkan proxy untuk semua perangkat
PROXY_DISABLE_ALL	true / false	Nonaktifkan proxy untuk semua perangkat
PROXY_WEBSHARE_DOWNLOADLINK	URL proxy	URL proxy dari webshare.io
PROXY_WEBSHARE_MODE	random / fixed	Mode penggunaan proxy: acak atau tetap

Panduan lengkap konfigurasi proxy tersedia di Menggunakan Proxy pada Whapi

Langkah 4: Jalankan Aplikasi

Mulai Aplikasi

Ketik perintah:

pm2 start

Saat pertama kali dijalankan, aplikasi membutuhkan waktu 1 hingga 20 detik untuk aktif sepenuhnya. Penggunaan CPU bisa mencapai 100% dalam beberapa detik — ini normal dan hanya terjadi saat inisialisasi.

Akses Aplikasi via Browser

Setelah aplikasi berjalan, buka browser dan akses:

Skenario	URL
Lokal	http://localhost:3000
VPS	http://ip-vps:3000
Domain	http://domain.com:3000

Perintah PM2 yang Sering Digunakan

Perintah	Fungsi
pm2 start	Menjalankan aplikasi
pm2 restart whapi	Restart aplikasi
pm2 stop whapi	Menghentikan aplikasi
pm2 delete whapi	Menghapus aplikasi dari PM2
pm2 logs	Melihat log real-time
pm2 flush	Membersihkan log
pm2 monit	Monitor performa CPU dan RAM

Error Umum dan Solusinya

Kondisi	Penyebab	Solusi
Aplikasi tidak bisa diakses di port 3000	Port sudah digunakan proses lain	Ganti nilai PORT di .env atau hentikan proses yang menggunakan port tersebut
Error saat npm install	Koneksi tidak stabil atau Node.js versi lama	Periksa koneksi internet dan pastikan Node.js v20 terinstal
Aplikasi berhenti sendiri	PM2 tidak aktif	Jalankan pm2 start dan periksa log dengan pm2 logs
License tidak valid	License key salah atau sudah digunakan di server lain	Periksa license key di email pembelian