Memulai Aplikasi Whapi
Panduan langkah-langkah awal setelah aplikasi Whapi berhasil diinstal yaitu: mengatur bahasa, mengaktifkan lisensi, mendaftar akun, login, dan mengenal dashboard utama.
Prasyarat
- Aplikasi Whapi sudah terinstal dan berjalan (lihat Cara Install WhatsApp API)
- License key sudah tersedia
- Browser modern (Chrome, Firefox, Edge)
Langkah 1: Akses Halaman Utama
Buka browser dan akses URL aplikasi:
| Skenario | URL |
|---|---|
| Lokal | http://localhost:3000 |
| VPS | http://ip-vps:3000 |
| Domain | http://domain.com:3000 |
Secara default aplikasi menggunakan bahasa Inggris.
Pilihan bahasa tersedia di halaman utama: Indonesia, Inggris, dan Portugis (Brasil).
Klik tombol Start untuk melanjutkan.
Langkah 2: Aktivasi Lisensi
Masukkan license key yang diperoleh saat pembelian.
Aturan penggunaan license:
| Aturan | Keterangan |
|---|---|
| Satu license, satu mesin | License tidak bisa digunakan di dua server sekaligus |
| Tidak bisa multi-port | Menjalankan 2 aplikasi di satu server membutuhkan 2 license terpisah |
| Pindah server | License harus diuninstall dari server lama sebelum diaktifkan di server baru |
Langkah 3: Pendaftaran Akun
Isi data diri yang diminta: nama, email, dan informasi lain yang diperlukan. Proses ini hanya dilakukan saat instalasi pertama kali. Pada instalasi berikutnya di server yang sama, sistem mengisi data secara otomatis.
Setelah data dilengkapi, centang kotak Syarat & Ketentuan, lalu klik Daftar Sekarang.
Langkah 4: Login ke Aplikasi
Masukkan username dan password yang sudah didaftarkan. Setelah login berhasil, dashboard utama akan tampil.
Jika password terlupa, klik Lupa Password di halaman login. Panduan reset password tersedia di Reset Password Akun.
Mengenal Dashboard Utama
Dashboard menampilkan informasi sistem secara real-time:
| Informasi | Keterangan |
|---|---|
| Penggunaan RAM | Konsumsi memori aplikasi saat ini |
| Jumlah perangkat | Berapa nomor WhatsApp yang terhubung |
| Tanggal kadaluarsa license | Kapan license perlu diperbarui |
| Jumlah add-on aktif | Fitur tambahan yang sedang aktif |
| Pemberitahuan update | Notifikasi jika ada versi terbaru |
Dari dashboard tersedia akses ke manajemen perangkat, laporan sistem, pengaturan webhook, dan pembaruan aplikasi.
Error Umum dan Solusinya
| Kondisi | Penyebab | Solusi |
|---|---|---|
| Halaman tidak bisa diakses | Aplikasi belum berjalan atau port salah | Jalankan pm2 start dan periksa port di .env |
| License tidak valid | License key salah atau sudah digunakan di server lain | Periksa email pembelian |
| Login gagal | Username atau password salah | Gunakan fitur Lupa Password untuk reset |
| Dashboard tidak menampilkan perangkat | Belum ada perangkat yang ditambahkan | Tambahkan perangkat pertama melalui menu Device |
Menambah dan Mengelola Perangkat
Panduan lengkap menambah nomor WhatsApp ke Whapi dan mengelola perangkat terhubung melalui dashboard, termasuk penambahan perangkat baru, pengaktifan/mematikan massal, batas perangkat, konfigurasi webhook, proxy, dan solusi error umum.
Menghubungkan Perangkat ke Aplikasi
Panduan menghubungkan nomor WhatsApp ke Whapi menggunakan scan QR atau kode manual 8 digit, beserta verifikasi koneksi, status perangkat, dan solusi error umum.
Mengganti Perangkat & API Key
Panduan mengganti perangkat yang terhubung dan memperbarui API Key di WHAPI, mencakup proses logout, penghapusan sesi, scan QR ulang, serta praktik keamanan dan langkah pemulihan layanan.
Integrasi Notifikasi Webhook
Webhook adalah mekanisme Whapi untuk mengirim notifikasi real-time ke endpoint Anda—panduan ini membahas aktivasi, tipe event, struktur payload, penerimaan media, dan pengujian dengan webhook.site atau Ngrok.
Integrasi Notifikasi Telegram
Panduan konfigurasi notifikasi Telegram di Whapi — mencakup metode bot resmi dan custom bot, langkah aktivasi, pengambilan Chat ID/Token, jenis notifikasi, serta solusi error umum.
Mengenal File Media
Fitur File Media Whapi memungkinkan upload, preview, dan pengiriman media melalui API atau dashboard; panduan ini menjelaskan format yang didukung, contoh upload via API, dan troubleshooting umum.
Fitur Log Aplikasi — Monitoring & Troubleshooting
Fitur log aplikasi mencatat aktivitas sistem otomatis (API, status perangkat, webhook) untuk monitoring dan troubleshooting; panduan ini menjelaskan aktivasi, jenis log, analisis error, dan pembersihan log.
Mengirim Pesan ke Grup
Panduan mengirim pesan ke grup WhatsApp menggunakan id_group. Meliputi cara mendapatkan id_group, contoh request (PHP/Python/Node.js), tipe pesan yang didukung, serta solusi error umum.
Fitur Broadcast Pesan di Aplikasi
Panduan lengkap Fitur Broadcast di Whapi — cara menyiapkan template Excel, mengunggah dan mengonfigurasi panel broadcast, memantau laporan, serta praktik pengiriman aman untuk mengurangi risiko pemblokiran.
Reset Password Akun
Panduan reset password akun Whapi melalui halaman login menggunakan license key sebagai verifikasi, termasuk langkah-langkah, prasyarat, tips keamanan, dan solusi untuk error umum.
Uninstall & Refresh License Aplikasi
Langkah lengkap untuk melakukan Uninstall dan Refresh License WHAPI saat migrasi, penambahan limit perangkat, atau troubleshooting—termasuk panduan, contoh kasus, dan solusi error umum.
Kustomisasi Homepage & Routes Login
Panduan mengubah tampilan halaman utama aplikasi Whapi dan mengganti URL default halaman login — berguna untuk kebutuhan white-label dan menambah lapisan keamanan akses.
Fitur Reboot Device Otomatis
Panduan lengkap penggunaan fitur Auto Reboot Device untuk menjaga kestabilan integrasi API, mencegah error jangka panjang, dan memastikan performa optimal pada perangkat yang terhubung.
Transfer Device antar Aplikasi
Fitur Transfer Device memungkinkan pemindahan perangkat dan sesi dari satu instalasi Whapi ke instalasi lain tanpa perlu scan QR ulang atau backup manual—panduan langkah, prasyarat, dan solusi error.
Maintenance & Update Aplikasi Whapi
Panduan memperbarui aplikasi Whapi secara manual maupun otomatis, termasuk perbedaan versi Engine dan WHAPI, langkah update, pengaturan auto-update, dan solusi error umum.
Menggunakan Proxy pada Whapi
Panduan penggunaan proxy pada WHAPI — alasan kebutuhan, cara mendapatkan, aktivasi, jenis proxy (rotator/media), error umum, dan langkah selanjutnya.
Auto Reply WhatsApp Chatbot
Fitur Auto Reply WHAPI untuk membuat balasan otomatis berbasis kata kunci; mencakup aktivasi, manajemen keyword, tipe pencocokan, integrasi webhook, dan manajemen via API.
Menjalankan WHAPI Lokal dengan Ngrok
Panduan menjalankan WHAPI lokal menggunakan Ngrok untuk menguji webhook dan integrasi tanpa server publik, termasuk langkah mendapatkan authtoken dan integrasi ke WHAPI.