Troubleshooting: Masalah Umum dan Cara Mengatasinya

Hampir semua masalah di Neromatic punya penyebab yang sederhana, dan sebagian besar sering muncul berulang. Artikel ini disusun berdasarkan gejala, jadi kamu bisa langsung mencari yang sedang kamu alami.

Bot tidak merespons sama sekali

Mulai dari yang paling mungkin. Pertama, cek apakah bot sedang dalam mode self dengan mengirim .menu dari nomor owner. Mode self membuat bot hanya merespons owner, dan pembeli akan merasa bot mati. Kembalikan dengan .public.

Kedua, mungkin chat itu ada di daftar ban. Bot tidak merespons chat yang di-ban, kecuali owner. Cek dengan .listban, dan keluarkan dengan .unban. Ketiga, pengirimnya mungkin sedang terkena cooldown antispam. Dalam kasus ini bot membalas dengan pesan bahwa ia sedang dalam cooldown, dan cukup ditunggu sekitar satu menit.

Kalau ternyata tidak satu pun penyebab di atas, lihat terminalnya. Bila prosesnya berhenti atau menampilkan pesan terputus, bot memang sedang tidak berjalan. Jalankan ulang dengan npm start.

Owner tidak bisa memakai perintah owner

Bot mengenali owner dari nomor yang tersimpan di daftar owner. Cek dengan .listowner dari nomor lain yang sudah menjadi owner, atau buka config.js dan lihat global.owners. Nomor harus ditulis dalam format internasional tanpa plus, spasi, atau nol di depan, contohnya 6281234567890. Kalau kamu baru saja mengubah daftar owner lewat config.js, mulai ulang bot supaya terbaca.

QR tidak muncul atau lama sekali

Setelah memilih metode QR, tunggulah beberapa detik. Teks "Loading qr code, tunggu sebentar" dengan titik yang bergerak menandakan bot masih menunggu QR dari WhatsApp. Kalau lebih dari setengah menit tidak ada hasil, penyebab paling umum adalah koneksi internet server yang lambat atau terputus. Periksa koneksinya, lalu jalankan ulang bot.

Kalau QR yang tampil tidak bisa dipindai, kemungkinan sudah kedaluwarsa. QR berganti sekitar tiap 20 detik, jadi tunggu gambar berikutnya muncul. Kalau layar terminal terlalu sempit sehingga QR terpotong atau berantakan, perlebar jendela terminal atau kecilkan ukuran fontnya. Jika tetap bermasalah, pakai pairing code sebagai gantinya.

Bot terputus lalu tidak tersambung lagi

Kalau terminal menampilkan koneksi terputus dengan kode logout, artinya nomor bot dikeluarkan dari Perangkat tertaut. Pada kasus ini bot sengaja tidak menyambung ulang karena sesinya sudah tidak sah. Hapus folder session, jalankan npm start, lalu tautkan ulang. Data toko di folder database tidak terpengaruh.

Tombol tidak muncul atau tampil aneh

Beberapa versi WhatsApp atau varian aplikasi tidak menampilkan tombol interaktif dengan baik. Ganti ke tema classic dengan .theme classic. Dengan tema ini bot menampilkan pilihan bernomor, dan pembeli cukup membalas pesan itu dengan angkanya. Perlu diingat bahwa angkanya harus dikirim sambil membalas (reply) pesan pilihan dari bot, bukan sebagai pesan baru.

Form .addproduk tidak terbuka

Form dibuat dengan cara bot mengunggah halamannya, lalu mengirim tautannya kepadamu. Kalau bot tidak berhasil mengunggah, form tidak akan terkirim. Penyebab paling umum adalah koneksi server yang bermasalah atau layanan penyimpanan yang sedang gangguan. Coba lagi setelah beberapa saat.

Masalah lain muncul di sisi sebaliknya. Kalau setelah mengisi form kamu mengirim perintahnya dan bot membalas "Gagal memproses data", biasanya perintah itu terpotong atau diedit. Salin ulang dari form dan kirim utuh. Hal yang sama berlaku untuk .addvoucher, yang menolak perintah tidak lengkap dengan pesan bahwa kode voucher tidak valid.

.addstok ditolak

Perintah .addstok hanya bisa dipakai di chat pribadi dengan bot, bukan di grup, karena isinya data rahasia. Buka chat pribadi dengan bot lalu ulangi.

Kalau pratinjau stok menunjukkan jumlah item nol atau lebih sedikit dari yang kamu harapkan, periksa format file. Setiap baris data harus punya tanda : antara nama kolom dan isinya, dan setiap item stok dipisahkan oleh koma. Ingat juga bahwa koma di dalam isi akan memecah item menjadi dua. Artikel stok menjelaskan formatnya lengkap dengan contoh.

Pembeli bilang stok kosong, padahal sudah diisi

Stok disimpan per varian. Pastikan kamu mengisi stok pada varian yang tepat. Mengisi stok varian "1 Bulan" tidak membuat varian "1 Tahun" terisi. Gunakan .delstok untuk melihat jumlah stok tiap varian dalam satu daftar.

Bukti transfer tidak muncul di chat owner

Hampir selalu penyebabnya sama: pembeli mengirim gambar tanpa membalas pesan invoice. Bot mengenali pesanan lewat pesan yang dibalas, jadi gambar yang dikirim sebagai pesan biasa tidak terhubung ke pesanan apa pun. Minta pembeli mengirim ulang dengan menekan dan menahan pesan invoice, lalu memilih Balas.

Kemungkinan lain adalah invoice sudah kedaluwarsa, yang terjadi 15 menit setelah invoice diterbitkan. Pembeli perlu membuat pesanan baru.

Data produk tidak sampai ke pembeli

Setelah kamu menekan Terima pada produk dinamis, data dikirim ke chat pribadi pembeli. Kalau pembeli memblokir bot atau pengiriman gagal karena alasan lain, bot memberi tahu dan stok tidak berkurang, sementara pesanan tetap menunggu. Minta pembeli membuka blokir atau mengirim pesan ke bot terlebih dahulu, lalu tekan Terima lagi. Kalau terpaksa, kamu juga bisa mengirimkan data secara manual dengan .kirim 628xxx|pesan.

.backup tidak sampai

Backup dikirim ke chat pribadimu, termasuk kalau kamu mengetik perintahnya dari grup. Kalau bot memberi tahu bahwa backup tidak bisa dikirim, buka chat pribadi dengan bot, kirim satu pesan, lalu ulangi .backup.

Pesan "toko sedang tutup" padahal sudah buka

Ketik .toko tanpa tambahan untuk melihat status saat ini. Kalau masih tertulis tutup, jalankan .toko buka. Statusnya tersimpan di config.js, jadi tidak akan kembali sendiri sesudah bot dimulai ulang.

Saat .toko buka dijalankan dan banyak pelanggan menunggu notifikasi, prosesnya memang berlangsung beberapa menit karena bot memberi jeda 5 detik antar pesan untuk menghindari pembatasan WhatsApp. Kamu akan menerima laporan hasilnya setelah selesai.

Bot error saat dijalankan setelah edit config.js

Satu tanda kutip atau koma yang hilang di config.js cukup untuk membuat bot gagal mulai. Cek isinya dengan perintah ini di terminal:

node --check config.js

Perintah itu menunjukkan baris yang bermasalah. Kalau sulit diperbaiki, kembalikan dari backup terakhir. Itu alasan kenapa sebaiknya selalu menyimpan salinan sebelum mengedit manual, dan memakai perintah bot untuk perubahan yang tersedia.

Perintah baru tidak jalan setelah memperbarui script

Jalankan npm install lagi di folder script. Pembaruan sering menambah atau mengganti dependensi, dan bot tidak akan berjalan benar bila paketnya belum terpasang.

Masih belum ketemu?

Kumpulkan pesan error dari terminal, versi script (ada di config.js pada global.versi), dan langkah yang kamu lakukan sebelum masalah muncul. Sampaikan lewat halaman repository Neromatic di situs ini. Jangan sertakan isi folder session dalam laporan apa pun.