Gejala Masalah #
Pesan notifikasi pesanan baru tidak masuk ke WhatsApp pelanggan, atau antrean Blast WhatsApp di Customer Area tertahan pada status Gagal dikirim (failed) atau Menunggu dikirim (queued) tanpa kunjung jalan.
Kemungkinan Penyebab #
- Kredensial Provider Salah / Kedaluwarsa: API Key atau Token pada StarSender, OneSender, atau Fonnte tidak valid atau masa berlangganan provider telah habis.
- Format Nomor WhatsApp Tidak Valid: Nomor pelanggan dimasukkan dengan awalan yang salah (sistem memerlukan format standar internasional seperti
628...). - WP-Cron Macet: Sistem penjadwalan WordPress Cron di hosting tidak berjalan sehingga antrean latar belakang tidak terpanggil.
- Kuota Blast Pelanggan Habis: Sisa kuota blast pelanggan bernilai 0 atau masa berlaku paket telah habis.
Cara Pengecekan #
- Buka
wp-admin -> Folkthemes -> Tab Commerce, periksa provider aktif dan pastikan API Key terisi benar. - Buka detail pesanan di Folkthemes admin, periksa kolom Timeline Audit untuk melihat log error pengiriman WhatsApp (contoh event:
whatsapp_failed). - Periksa apakah WP-Cron berjalan dengan menginstal plugin WP Crontrol atau memeriksa jadwal event
folkthemes_every_minute.
Solusi #
- Verifikasi status perangkat WhatsApp di dashboard resmi provider (StarSender/OneSender/Fonnte) Anda dan pastikan perangkat dalam status terhubung (Connected).
- Jika WP-Cron hosting sering tertidur akibat sepinya traffic pengunjung, aktifkan Real Cron Server (crontab) melalui cPanel untuk mengeksekusi
wp-cron.phpsetiap menit. - Buka halaman detail pesanan lalu klik tombol Kirim Ulang WhatsApp untuk mencoba kembali transmisi pesan yang sempat tertunda.
