Panduan Menu WP Admin: WA Notification Logs & Audit Status Pengiriman
Menu RSVPKit > WhatsApp Logs adalah panel audit forensik pengiriman pesan instan yang mencatat setiap aktivitas transmisi data ke tabel database
wp_rsvpkit_notification_logs, menampilkan status pengiriman (Pending, Sent, Failed), rincian payload data, serta tombol aksi kirim ulang (retry) instan untuk menjaga reliabilitas notifikasi undangan.
Memahami Kebutuhan Audit Pengiriman WhatsApp
Ketika ratusan tamu mengisi formulir kehadiran secara serentak menjelang hari pernikahan, kepastian bahwa notifikasi telah sampai ke nomor tujuan menjadi hal yang sangat penting bagi kredibilitas vendor. Tanpa adanya sistem pencatatan yang transparan, vendor sering kali kebingungan saat klien mengklaim bahwa mereka belum menerima pesan konfirmasi.
Kegagalan transmisi pesan dapat terjadi karena berbagai faktor di luar kendali website: kuota bulanan gateway yang mendadak habis, koneksi nomor WhatsApp gateway yang terputus (disconnected), atau tamu yang salah memasukkan digit nomor ponsel. Jika kegagalan ini tidak terdeteksi sejak dini, alur komunikasi keluarga pengantin menjadi terganggu dan menimbulkan kepanikan operasional.
WDP RSVPKit mengatasi kekhawatiran tersebut melalui panel WhatsApp Notification Logs. Seluruh aktivitas transmisi dicatat detik per detik beserta respon mentah dari server gateway, memberikan bukti otentik dan kemudahan diagnosis teknis langsung dari WP Admin.
Prasyarat Sebelum Melakukan Audit
Pastikan hal-hal berikut sebelum membaca log notifikasi:
- Fitur WhatsApp Aktif: Saklar master notifikasi telah dinyalakan di menu
RSVPKit > Settings > WhatsApp. - Akses Administrator: Memiliki izin akses peran Administrator pada situs WordPress.
- Data Transmisi Nyata: Minimal telah terjadi 1 kali pengiriman pesan notifikasi (baik melalui pengisian form publik maupun tombol Live Test Diagnostic).
Bedah Mendalam Fitur WhatsApp Notification Logs
Untuk membuka panel ini, klik submenu RSVPKit > WhatsApp Logs pada bilah navigasi utama WP Admin:
1. Kartu Ringkasan Statistik Transmisi
Di bagian atas halaman, Anda disuguhkan 3 kartu metrik pemantauan instan:
- Total Pesan Diproses: Akumulasi seluruh antrean pengiriman pesan yang dibuat oleh sistem.
- Terkirim Berhasil (Sent): Persentase dan jumlah total pesan yang sukses diterima oleh server gateway dengan respon status HTTP 200.
- Gagal Kirim (Failed): Jumlah pesan yang mengalami kendala transmisi dan memerlukan perhatian teknis.
- Tombol Retry Failed Messages: Tombol aksi cepat untuk memproses ulang seluruh pesan yang gagal dalam 1 kali klik.
2. Struktur Kolom Tabel Audit
Tabel riwayat menyajikan 6 parameter data forensik secara rinci:
- Waktu: Stempel waktu (tanggal, jam, menit) saat permintaan pengiriman dipicu.
- Nomor Tujuan: Nomor telepon penerima dalam format standar internasional (
+62...). - Gateway: Identitas penyedia antarmuka API yang memproses pesan (Fonnte, StarSender, atau OneSender).
- Tipe Notifikasi: Kategori pesan yang dikirimkan (Admin New RSVP Alert, Guest Confirmation Receipt, atau Test Diagnostic).
- Status Transmisi: Lencana penanda kondisi pesan (SENT, FAILED, atau PENDING).
- Aksi Audit: Pilihan tindakan teknis untuk menginspeksi atau mengulang proses pengiriman.
3. Modal Inspeksi Payload Mentah (View Payload)
Mengklik tombol View Payload akan membuka jendela modal interaktif yang menampilkan data teknis mendalam:
- Request Body JSON: Teks mentah parameter yang dikirimkan oleh plugin ke endpoint gateway.
- API Response Code: Kode status HTTP yang dikembalikan oleh penyedia gateway (contoh: 200 untuk sukses, 401 untuk token salah, 400 untuk nomor tidak valid).
- Gateway Error Message: Pesan penjelasan langsung dari server penyedia (contoh:
"device_disconnected"atau"insufficient_quota").
4. Tombol 1-Click Retry Manual
Jika sebuah pesan berstatus FAILED akibat kendala sesaat (seperti lonjakan beban server gateway), Anda tidak perlu meminta tamu mengisi formulir ulang. Cukup klik tombol Retry 1-Click pada baris pesan tersebut. Sistem akan mengambil ulang payload yang tersimpan dan menembakkannya kembali ke gateway secara instan.
5. Kebijakan Retensi & Pembersihan Otomatis (Auto-Purge)
Untuk menjaga agar kapasitas penyimpanan database hosting tetap ringan, WDP RSVPKit menerapkan aturan retensi berkala:
- Log berstatus SENT yang telah berusia lebih dari 30 hari akan dihapus secara otomatis melalui jadwal rutin WP Cron.
- Log berstatus FAILED akan tetap dipertahankan hingga Anda mengambil tindakan perbaikan atau menghapusnya secara manual.
Tabel Referensi Status & Kode Transmisi
| Status Log | Kode HTTP | Arti Teknis | Rekomendasi Solusi |
|---|---|---|---|
| SENT | 200 | Pesan sukses diterima dan diantrekan oleh server gateway | Tidak memerlukan tindakan lebih lanjut |
| PENDING | 0 | Pesan sedang dalam antrean pemrosesan background queue | Tunggu eksekusi jadwal WP Cron (1 hingga 5 menit) |
| FAILED | 401 | Otentikasi ditolak akibat API Token salah atau kedaluwarsa | Perbarui token di menu Settings > WhatsApp |
| FAILED | 400 | Format nomor telepon tujuan salah atau tidak terdaftar | Perbaiki nomor telepon di menu Responses lalu klik Retry |
| FAILED | 429 | Batas kecepatan pengiriman (rate limit) gateway terlampaui | Naikkan paket langganan gateway atau beri jeda pengiriman |
Skenario Praktik Lapangan: Andy & Zhea
Calon pengantin Zhea menghubungi tim Andy & Zhea menanyakan mengapa kerabatnya yang berdomisili di Singapura belum menerima pesan konfirmasi WhatsApp:
- Investigasi Cepat: Tim Andy & Zhea segera membuka menu RSVPKit > WhatsApp Logs dan memfilter baris log terakhir.
- Menemukan Masalah: Ditemukan 1 baris berstatus FAILED menuju nomor luar negeri tersebut. Saat tombol View Payload diklik, terlihat respon gateway:
"invalid_country_code". Tamu tersebut salah mengetikkan awalan nomor ponsel tanpa kode negara Singapura (+65). - Koreksi Data: Tim membuka menu Responses, mengoreksi nomor telepon tamu menjadi format standar internasional
+6591234567. - Eksekusi Retry: Tim kembali ke halaman WhatsApp Logs dan menekan tombol Retry 1-Click.
- Konfirmasi Sukses: Status baris berubah menjadi hijau (SENT) dan tamu langsung menerima notifikasi tanda terima dalam waktu 2 detik.
Tips & Praktik Terbaik Pemantauan Log
- Audit Rutin Saat Hari Penyebaran Undangan: Buka halaman WA Logs secara berkala saat pengantin mulai menyebarkan undangan massal untuk memastikan rasio keberhasilan tetap di atas 98%.
- Manfaatkan Respon Payload untuk Klarifikasi: Jika ada komplain dari pihak keluarga pengantin, jadikan data stempel waktu dan ID respon gateway pada modal payload sebagai bukti profesional bahwa sistem website telah bekerja sebagaimana mestinya.
- Jangan Biarkan Pesan Failed Menumpuk: Segera lakukan evaluasi pada pesan gagal untuk mengetahui apakah ada kesalahan konfigurasi global atau kendala akun gateway.