CONNECTED<\/code> menjadi DISCONNECTED<\/code>, kemudian kembali terhubung beberapa saat kemudian.<\/p>\n![\"Cara](\"https:\/\/whapi.id\/blog\/wp-content\/uploads\/2026\/10\/Cara-Mengatasi-Device-WhatsApp-yang-Sering-Terputus.jpg\")
<\/p>\n
Bedakan Device Terputus dan Logout<\/h2>\n
Sebelum memperbaiki masalah, pastikan kondisi yang terjadi memang disconnect.<\/p>\n
Contoh device terputus:<\/p>\n
CONNECTED\r\n\u2193\r\nDISCONNECTED\r\n\u2193\r\nCONNECTED\r\n`\r\n<\/code><\/pre>\nPada kondisi ini, session masih dapat digunakan dan device dapat terhubung kembali.<\/p>\n
Sedangkan logout biasanya memiliki alur:<\/p>\n
CONNECTED\r\n\u2193\r\nLOGGED OUT<\/span>\r\n\u2193\r\nPairing ulang\r\n\u2193\r\nCONNECTED\r\n<\/code><\/pre>\nJika device hanya sering terputus, jangan langsung melakukan scan QR berulang kali.<\/p>\n
Fokus pemeriksaan sebaiknya diarahkan ke koneksi server, proses aplikasi, session, jaringan, dan konfigurasi device.<\/p>\n
1. Periksa Status Device<\/h2>\n
Langkah pertama adalah melihat status device ketika koneksi terputus.<\/p>\n
Whapi menyediakan status device melalui API sehingga aplikasi dapat memeriksa kondisi koneksi tanpa hanya mengandalkan kegagalan request pengiriman.<\/p>\n
Catat perubahan status seperti:<\/p>\n
CONNECTED\r\nDISCONNECTED\r\nCONNECTED\r\nDISCONNECTED<\/span>\r\n<\/code><\/pre>\nJika perubahan terjadi berulang, simpan waktu setiap event.<\/p>\n
Contoh:<\/p>\n
10:00<\/span>:01<\/span> CONNECTED<\/span>\r\n10:15<\/span>:22<\/span> DISCONNECTED<\/span>\r\n10:15<\/span>:27<\/span> CONNECTED<\/span>\r\n10:48<\/span>:10<\/span> DISCONNECTED<\/span>\r\n10:48<\/span>:15<\/span> CONNECTED<\/span>\r\n<\/code><\/pre>\nDari data tersebut dapat diketahui apakah disconnect terjadi sesekali atau terus berulang dalam interval tertentu.<\/p>\n
2. Periksa Koneksi Internet Server<\/h2>\n
Server membutuhkan koneksi internet yang stabil untuk mempertahankan komunikasi dengan layanan WhatsApp.<\/p>\n
Periksa koneksi dasar server:<\/p>\n
ping<\/span> 1.1<\/span>.1<\/span>.1<\/span>\r\n<\/code><\/pre>\nKemudian periksa DNS:<\/p>\n
nslookup<\/span> google<\/span>.com<\/span>\r\n<\/code><\/pre>\nJika koneksi mengalami packet loss, latency tinggi, atau DNS bermasalah, koneksi device dapat ikut terganggu.<\/p>\n
Masalah jaringan dapat berasal dari:<\/p>\n
\n- koneksi provider server,<\/li>\n
- firewall,<\/li>\n
- routing,<\/li>\n
- DNS,<\/li>\n
- proxy,<\/li>\n
- atau aturan outbound connection.<\/li>\n<\/ul>\n
Jangan hanya memastikan server masih dapat membuka website. Periksa kestabilan koneksi selama device aktif.<\/p>\n
3. Periksa Penggunaan RAM<\/h2>\n
RAM yang hampir penuh dapat membuat proses WhatsApp API tidak stabil.<\/p>\n
Periksa penggunaan RAM:<\/p>\n
free<\/span> -h\r\n<\/code><\/pre>\nUntuk melihat proses yang menggunakan banyak memory:<\/p>\n
top<\/span>\r\n<\/code><\/pre>\natau:<\/p>\n
htop<\/span>\r\n<\/code><\/pre>\nPerhatikan apakah penggunaan RAM meningkat terus:<\/p>\n
RAM 70<\/span>%<\/span>\r\n\u2193\r\nRAM 80<\/span>%<\/span>\r\n\u2193\r\nRAM 90<\/span>%<\/span>\r\n\u2193\r\nRAM 100<\/span>%<\/span>\r\n\u2193\r\nProcess berhenti\r\n\u2193\r\nDevice disconnected\r\n<\/code><\/pre>\nJika pola tersebut terjadi, masalah koneksi kemungkinan merupakan efek dari proses aplikasi yang dihentikan oleh sistem.<\/p>\n
Periksa juga jumlah device aktif karena semakin banyak device yang berjalan pada server, semakin besar kebutuhan resource.<\/p>\n
4. Pastikan Process API Tetap Berjalan<\/h2>\n
Jika process API berhenti sesaat, koneksi device juga dapat terputus.<\/p>\n
Pada server Linux, periksa service:<\/p>\n
systemctl status nama-service<\/span>\r\n<\/code><\/pre>\nJika menggunakan PM2:<\/p>\n
pm2 status<\/span>\r\n<\/code><\/pre>\nKemudian lihat log:<\/p>\n
pm2<\/span> logs\r\n<\/code><\/pre>\nCari pesan seperti:<\/p>\n
process exited\r\nuncaught exception<\/span>\r\nout<\/span> of<\/span> memory\r\nconnection closed\r\nrestart\r\n<\/code><\/pre>\nJika process restart setiap beberapa menit, perbaiki penyebab restart terlebih dahulu.<\/p>\n
Restart otomatis memang dapat membuat service kembali aktif, tetapi tidak menyelesaikan masalah jika process terus crash.<\/p>\n
5. Periksa Apakah Server Sering Restart<\/h2>\n
Server restart dapat memutus seluruh device yang sedang aktif.<\/p>\n
Contohnya:<\/p>\n
Server<\/span> aktif\r\n\u2193\r\n10<\/span> device CONNECTED\r\n\u2193\r\nServer<\/span> restart\r\n\u2193\r\nSemua device DISCONNECTED\r\n\u2193\r\nService aktif kembali\r\n\u2193\r\nDevice reconnect\r\n<\/code><\/pre>\nJika semua device terputus pada waktu yang sama, periksa aktivitas server.<\/p>\n
Cari:<\/p>\n
\n- reboot,<\/li>\n
- kernel error,<\/li>\n
- maintenance,<\/li>\n
- perubahan konfigurasi,<\/li>\n
- deploy,<\/li>\n
- restart Docker,<\/li>\n
- atau restart service.<\/li>\n<\/ul>\n
Jika hanya satu device yang terputus sedangkan device lain tetap normal, kemungkinan masalah tidak berada pada server secara keseluruhan.<\/p>\n
6. Periksa Session Device<\/h2>\n
Session yang tidak tersimpan dengan baik dapat membuat proses reconnect bermasalah.<\/p>\n
Pastikan data session tidak hilang ketika:<\/p>\n
\n- aplikasi restart,<\/li>\n
- server reboot,<\/li>\n
- container restart,<\/li>\n
- deploy,<\/li>\n
- atau process manager menjalankan ulang aplikasi.<\/li>\n<\/ul>\n
Struktur sederhana:<\/p>\n
Application<\/span>\r\n \u2193\r\nSession Storage\r\n \u2193\r\nDevice\r\n<\/code><\/pre>\nSession sebaiknya menggunakan storage yang tetap tersedia setelah proses aplikasi berhenti.<\/p>\n
Jika session hanya berada di memory, restart process dapat menyebabkan aplikasi kehilangan informasi yang dibutuhkan untuk mempertahankan koneksi.<\/p>\n
7. Periksa Docker Volume<\/h2>\n
Jika aplikasi dijalankan menggunakan Docker, pastikan session menggunakan volume persisten.<\/p>\n
Tanpa volume:<\/p>\n
Container<\/span>\r\n\u2193\r\nSession tersimpan di container<\/span>\r\n\u2193\r\nContainer<\/span> dihapus\r\n\u2193\r\nSession hilang\r\n<\/code><\/pre>\nDengan volume:<\/p>\n
Container\r\n\u2193\r\nSession\r\n\u2193\r\nPersistent Volume<\/span>\r\n\u2193\r\n<\/span>Container restart\r\n\u2193\r\nSession tetap tersedia\r\n<\/code><\/pre>\nContoh konfigurasi konsep:<\/p>\n
volumes:<\/span>\r\n - whatsapp_sessions:<\/span>\/app\/<\/span>sessions\r\n<\/code><\/pre>\nLokasi \/app\/sessions<\/code> harus disesuaikan dengan direktori session aplikasi.<\/p>\n8. Periksa Proxy<\/h2>\n
Jika device menggunakan proxy, periksa kestabilan proxy.<\/p>\n
Periksa:<\/p>\n
\n- host,<\/li>\n
- port,<\/li>\n
- username,<\/li>\n
- password,<\/li>\n
- latency,<\/li>\n
- timeout,<\/li>\n
- dan koneksi proxy.<\/li>\n<\/ul>\n
Jika hanya device yang menggunakan proxy tertentu yang sering disconnect, bandingkan dengan device lain.<\/p>\n
Contoh:<\/p>\n
Device 01<\/span> \u2192 Proxy<\/span> A \u2192 sering disconnect\r\nDevice 02<\/span> \u2192 Proxy<\/span> B \u2192 normal\r\nDevice 03<\/span> \u2192 Proxy<\/span> C \u2192 normal\r\n<\/code><\/pre>\nPola tersebut menunjukkan bahwa Proxy A layak diperiksa lebih lanjut.<\/p>\n
Jangan mengganti semua konfigurasi proxy sekaligus karena perubahan tersebut dapat menyulitkan pencarian sumber masalah.<\/p>\n
9. Periksa Firewall dan Outbound Connection<\/h2>\n
Firewall server dapat memengaruhi koneksi keluar.<\/p>\n
Periksa apakah terdapat aturan yang:<\/p>\n
\n- memblokir koneksi tertentu,<\/li>\n
- memutus koneksi idle,<\/li>\n
- membatasi port,<\/li>\n
- atau membatasi traffic keluar.<\/li>\n<\/ul>\n
Jika menggunakan cloud server, periksa juga firewall pada panel provider.<\/p>\n
Pastikan perubahan firewall tidak dilakukan tanpa mencatat konfigurasi sebelumnya.<\/p>\n
10. Periksa Timeout<\/h2>\n
Timeout yang terlalu pendek dapat menyebabkan aplikasi menganggap koneksi gagal sebelum proses selesai.<\/p>\n
Misalnya aplikasi memiliki timeout:<\/p>\n
5 <\/span>detik\r\n<\/code><\/pre>\nsementara koneksi membutuhkan waktu lebih lama.<\/p>\n
Aplikasi kemudian menganggap:<\/p>\n
Request timeout<\/span>\r\n\u2193\r\nConnection dianggap gagal\r\n<\/code><\/pre>\nGunakan timeout yang sesuai dengan karakteristik server dan jaringan.<\/p>\n
Namun jangan menaikkan timeout secara berlebihan tanpa mengetahui penyebab keterlambatan.<\/p>\n
Timeout yang terlalu panjang juga dapat membuat koneksi bermasalah sulit terdeteksi.<\/p>\n
11. Periksa Log Saat Disconnect Terjadi<\/h2>\n
Log harus diperiksa beberapa saat sebelum dan sesudah device terputus.<\/p>\n
Contoh:<\/p>\n
14:20<\/span>:01<\/span> Device<\/span> CONNECTED<\/span>\r\n14:25<\/span>:10<\/span> Message<\/span> sent<\/span>\r\n14:25<\/span>:12<\/span> Network<\/span> warning<\/span>\r\n14:25<\/span>:15<\/span> Connection<\/span> closed<\/span>\r\n14:25<\/span>:16<\/span> Device<\/span> DISCONNECTED<\/span>\r\n14:25<\/span>:22<\/span> Device<\/span> CONNECTED<\/span>\r\n<\/code><\/pre>\nDari urutan tersebut, pemeriksaan dapat diarahkan ke network warning.<\/p>\n
Jika log menunjukkan:<\/p>\n
14:25<\/span>:10<\/span> Process<\/span> restart<\/span>\r\n14:25<\/span>:11<\/span> Device<\/span> DISCONNECTED<\/span>\r\n14:25<\/span>:20<\/span> Device<\/span> CONNECTED<\/span>\r\n<\/code><\/pre>\nmaka pemeriksaan lebih tepat diarahkan ke process aplikasi.<\/p>\n
Jangan hanya mengambil log:<\/p>\n
Device DISCONNECTED<\/span>\r\n<\/code><\/pre>\nCari event yang muncul tepat sebelum disconnect.<\/p>\n
12. Pantau Status Device melalui Webhook<\/h2>\n
Webhook dapat digunakan untuk mencatat perubahan status secara otomatis.<\/p>\n
Contoh receiver:<\/p>\n
app.post('\/webhook\/whapi'<\/span>, (req, res)<\/span> =><\/span> {\r\n const payload = req.body;\r\n\r\n console<\/span>.log('Webhook event:'<\/span>, payload);\r\n\r\n \/\/<\/span> Simpan event status device\r\n\r\n res.sendStatus(200<\/span>);\r\n});\r\n<\/code><\/pre>\nSimpan data seperti:<\/p>\n
device_id\r\nevent<\/span>\r\nstatus\r\ntimestamp\r\n<\/code><\/pre>\nContoh riwayat:<\/p>\n
device-001<\/span>\r\n17:00<\/span> CONNECTED<\/span>\r\n17:32<\/span> DISCONNECTED<\/span>\r\n17:33<\/span> CONNECTED<\/span>\r\n18:10<\/span> DISCONNECTED<\/span>\r\n18:11<\/span> CONNECTED<\/span>\r\n<\/code><\/pre>\nRiwayat tersebut dapat digunakan untuk menghitung frekuensi disconnect.<\/p>\n
13. Cari Pola Disconnect<\/h2>\n
Device yang terputus sekali belum tentu mengalami masalah serius.<\/p>\n
Masalah lebih jelas jika terdapat pola:<\/p>\n
Setiap 10<\/span> menit\r\n\u2193\r\nDISCONNECTED\r\n\u2193\r\n5<\/span> detik kemudian\r\n\u2193\r\nCONNECTED\r\n<\/code><\/pre>\nAtau:<\/p>\n
Setiap server restart\r\n\u2193\r\nSemua device disconnect<\/span>\r\n<\/code><\/pre>\nAtau:<\/p>\n
Device tertentu\r\n\u2193\r\nDisconnect lebih sering\r\n\u2193\r\nDevice lain normal<\/span>\r\n<\/code><\/pre>\nSetiap pola membutuhkan pemeriksaan yang berbeda.<\/p>\n
Karena itu, monitoring status lebih berguna daripada hanya melihat kondisi device saat ini.<\/p>\n
14. Bandingkan Beberapa Device<\/h2>\n
Jika server menjalankan beberapa device, gunakan device lain sebagai pembanding.<\/p>\n
Contoh:<\/p>\n
\n\n\nDevice<\/th>\n Kondisi<\/th>\n<\/tr>\n<\/thead>\n \n\nDevice 01<\/td>\n Sering disconnect<\/td>\n<\/tr>\n \nDevice 02<\/td>\n Normal<\/td>\n<\/tr>\n \nDevice 03<\/td>\n Normal<\/td>\n<\/tr>\n \nDevice 04<\/td>\n Normal<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nJika hanya Device 01 yang bermasalah, periksa konfigurasi device tersebut.<\/p>\n
Sebaliknya:<\/p>\n
\n\n\nDevice<\/th>\n Kondisi<\/th>\n<\/tr>\n<\/thead>\n \n\nDevice 01<\/td>\n Disconnect<\/td>\n<\/tr>\n \nDevice 02<\/td>\n Disconnect<\/td>\n<\/tr>\n \nDevice 03<\/td>\n Disconnect<\/td>\n<\/tr>\n \nDevice 04<\/td>\n Disconnect<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nJika semuanya terputus pada waktu yang sama, periksa server atau koneksi global.<\/p>\n
15. Jangan Langsung Scan QR<\/h2>\n
Scan QR digunakan untuk menghubungkan device, bukan untuk memperbaiki koneksi server yang tidak stabil.<\/p>\n
Jika device hanya mengalami:<\/p>\n
CONNECTED\r\n\u2193\r\nDISCONNECTED\r\n<\/span>\u2193\r\nCONNECTED\r\n<\/code><\/pre>\nmaka scan QR tidak diperlukan.<\/p>\n
Scan QR berulang kali justru dapat membuat troubleshooting lebih sulit karena kondisi session berubah selama pemeriksaan.<\/p>\n
Gunakan pairing ulang hanya ketika device memang membutuhkan proses pairing kembali.<\/p>\n
16. Periksa Deployment<\/h2>\n
Jika device mulai sering disconnect setelah deployment, bandingkan konfigurasi sebelum dan sesudah deployment.<\/p>\n
Periksa:<\/p>\n
Environment variable<\/span>\r\nSession storage<\/span>\r\nDocker volume<\/span>\r\nProxy\r\nFirewall\r\nDependency\r\nProcess manager<\/span>\r\n<\/code><\/pre>\nContoh:<\/p>\n
Sebelum <\/span>deploy \u2192 device stabil\r\n\u2193\r\nDeploy versi baru\r\n<\/span>\u2193\r\nDevice sering disconnect<\/span>\r\n<\/code><\/pre>\nVersi baru perlu diperiksa sebelum melakukan perubahan lain pada server.<\/p>\n
17. Pastikan Service Tidak Kehabisan Resource<\/h2>\n
Selain RAM, periksa resource lain seperti:<\/p>\n
\n- CPU,<\/li>\n
- disk,<\/li>\n
- network,<\/li>\n
- file descriptor,<\/li>\n
- dan jumlah process.<\/li>\n<\/ul>\n
CPU yang terlalu tinggi:<\/p>\n
CPU 100<\/span>%\r\n\u2193\r\nProcess lambat\r\n\u2193\r\nConnection timeout<\/span>\r\n\u2193\r\nDevice disconnected\r\n<\/code><\/pre>\nDisk yang penuh juga dapat menyebabkan aplikasi gagal menulis log, database, atau session.<\/p>\n
Periksa:<\/p>\n
df -h<\/span>\r\n<\/code><\/pre>\nJika disk hampir penuh, bersihkan data yang tidak diperlukan sesuai kebijakan penyimpanan aplikasi.<\/p>\n
18. Buat Monitoring Sederhana<\/h2>\n
Untuk sistem dengan banyak device, buat tabel monitoring:<\/p>\n
\n\n\nDevice<\/th>\n Status<\/th>\n Last Connected<\/th>\n Last Disconnect<\/th>\n Frekuensi<\/th>\n<\/tr>\n<\/thead>\n \n\ndevice-001<\/td>\n CONNECTED<\/td>\n 17:50<\/td>\n 17:20<\/td>\n 2<\/td>\n<\/tr>\n \ndevice-002<\/td>\n CONNECTED<\/td>\n 17:51<\/td>\n 15:10<\/td>\n 1<\/td>\n<\/tr>\n \ndevice-003<\/td>\n DISCONNECTED<\/td>\n 16:30<\/td>\n 17:45<\/td>\n 5<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nData tersebut membantu menemukan device yang paling sering bermasalah.<\/p>\n
Monitoring juga dapat digunakan untuk membuat notifikasi ketika:<\/p>\n
Device disconnect<\/span>\r\n\u2193\r\nTidak reconnect dalam X menit\r\n\u2193\r\nKirim alert\r\n<\/code><\/pre>\nDengan begitu, masalah dapat diketahui sebelum pengiriman pesan bisnis terganggu terlalu lama.<\/p>\n
19. Urutan Troubleshooting yang Disarankan<\/h2>\n
Gunakan urutan berikut agar pemeriksaan tidak melebar:<\/p>\n
1. <\/span>Cek status device\r\n \u2193<\/span>\r\n2. <\/span>Cek waktu disconnect\r\n \u2193<\/span>\r\n3. <\/span>Bandingkan dengan device lain\r\n \u2193<\/span>\r\n4. <\/span>Cek process aplikasi\r\n \u2193<\/span>\r\n5. <\/span>Cek RAM dan CPU\r\n \u2193<\/span>\r\n6. <\/span>Cek restart server\r\n \u2193<\/span>\r\n7. <\/span>Cek session storage\r\n \u2193<\/span>\r\n8. <\/span>Cek jaringan\r\n \u2193<\/span>\r\n