Jawaban singkat: 90% error/offline berasal dari 5 penyebab — (1) VPS/n8n mati, (2) WhatsApp QR expired/token invalid, (3) API AI habis saldo/error, (4) Workflow error (node merah), (5) Resource VPS penuh. Artikel ini memberikan flowchart diagnosa 5 menit, perbaikan tiap penyebab, dan sistem monitoring biar tahu dulu sebelum pelanggan komplain.
Flowchart Diagnosa 5 Menit (Ikuti Berurutan)
5 Penyebab Utama & Cara Perbaiki
| Penyebab | Gejala | Perbaikan Cepat | Pencegahan Jangka Panjang |
|---|---|---|---|
| 1. VPS/n8n Mati | n8n tidak kebuka, executions kosong, test chat tidak balas | SSH ke VPS → systemctl restart n8n / docker restart n8n |
Setup systemd auto-restart; UptimeRobot monitor n8n webhook URL; notif Telegram kalau down |
| 2. WhatsApp Putus (QR Expired / Token Invalid) | Executions ada tapi node WhatsApp error “unauthorized” / “session closed” | Re-scan QR di n8n / dashboard gateway; API resmi: generate token baru | Pilih gateway keep-alive; monitor status QR harian; API resmi: System User token + auto-refresh |
| 3. API AI Error (Saldo Habis / Rate Limit / Model Down) | Node AI error “insufficient_quota” / “rate_limit_exceeded” / “model_unavailable” | Topup kredit; ganti ke model fallback (OpenRouter dll); tunggu reset limit | Auto-topup; dual provider (primary + fallback); alert saldo rendah ke Telegram; cache FAQ statis |
| 4. Workflow Error (Node Merah / Logic Salah) | Execution merah di node tertentu: IF salah, expression error, credential missing | Buka execution merah → baca error → perbaiki node → re-run / aktifkan ulang | Test 5 skenario sebelum aktifkan; staging workflow terpisah; backup sebelum update |
| 5. Resource VPS Penuh (RAM/CPU/Disk) | VPS lemot, n8n crash, “no space left on device”, OOM killer | Restart n8n; bersihkan log lama (journalctl --vacuum-time=7d); upgrade VPS |
Monitor Netdata/Uptime Kuma; alert RAM >80% / Disk >85%; log rotation otomatis |
Sistem Monitoring Otomatis (Gratis, Setup 10 Menit)
- UptimeRobot (gratis 50 monitor): tambah monitor → HTTP(s) → URL webhook n8n Anda → interval 5 menit → notif email/Telegram (via webhook ke bot notif).
- n8n Error Trigger → Telegram: buat workflow terpisah “Error Notif” → trigger “Error Trigger” → node Telegram Send Message ke admin → aktifkan. Setiap error workflow lain → notif instan ke HP.
- Telegram Bot Notif Sederhana: buat bot via @BotFather → dapatkan token & chat ID → gunakan untuk notif error & uptime.
Setup lengkap: jaga bot nyala 24 jam tanpa PC.
Checklist Darurat (Print / Simpan di HP)
🚨 BOT OFFLINE / ERROR – LANGKAH DARURAT
- Buka n8n Executions → ada merah? → baca error → perbaiki node → re-run
- Test chat sendiri → balas? → kalau ya, selesai (cuma error lalu)
- Cek gateway WhatsApp → QR valid? → re-scan kalau tidak
- Cek saldo API AI → habis? → topup / ganti model fallback
- SSH VPS →
systemctl status n8n→ restart kalau mati - Cek disk VPS →
df -h→ bersihkan log kalau penuh - Masih error? → matikan workflow → notif admin manual → pakai auto-reply manual sementara
FAQ: Mengatasi Bot WhatsApp AI Error/Offline
Bot tiba-tiba diam tidak balas chat — cek apa dulu?
Urutan: (1) n8n Executions ada error merah? (2) Test chat sendiri. (3) Status WhatsApp di gateway/n8n. (4) Saldo API AI. (5) VPS resource. 90% ketemu di 1-4.
Error “Session closed” / “QR expired” berarti apa?
Koneksi WhatsApp putus. Gateway praktis: QR expired (biasanya 30-90 hari) → re-scan di n8n. API resmi: token invalid → generate token baru. Setup monitoring supaya tahu sebelum pelanggan komplain.
API AI error “rate_limit_exceeded” — solusi cepat?
(1) Tunggu reset (biasanya 1 menit – 1 jam). (2) Ganti ke model fallback via node “If” cek error. (3) Kurangi token per request (pendekkan prompt, batas history). (4) Upgrade plan / beli quota tambahan.
VPS RAM penuh 95% — bisa diatasi tanpa upgrade?
Bisa: (1) Restart n8n (bebaskan RAM), (2) Bersihkan journal log (journalctl --vacuum-time=3d), (3) Kurangi concurrency n8n (env EXECUTIONS_PROCESS=main), (4) Matikan service tidak perlu. Tapi kalau sering penuh → upgrade VPS (RAM 2GB→4GB ~Rp 50-100rb tambahan).
Bisa nggak bot auto-restart kalau error?
Workflow level: n8n “Error Trigger” workflow terpisah bisa coba re-run workflow yang error (advanced). VPS level: systemd Restart=always sudah auto-restart proses n8n kalau crash. Untuk logic error (node merah) butuh intervensi manual — itu bagus, biar tidak loop error.
Baca juga: Bagaimana Cara Mengatasi Bot WhatsApp AI yang Sering Error atau Offline? untuk panduan lengkapnya.
