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:

  1. Fitur WhatsApp Aktif: Saklar master notifikasi telah dinyalakan di menu RSVPKit > Settings > WhatsApp.
  2. Akses Administrator: Memiliki izin akses peran Administrator pada situs WordPress.
  3. Data Transmisi Nyata: Minimal telah terjadi 1 kali pengiriman pesan notifikasi (baik melalui pengisian form publik maupun tombol Live Test Diagnostic).

Tata Letak Panel Audit WDP RSVPKit WhatsApp Notification Logs dengan Statistik Metrik dan Tabel Riwayat Pengiriman
Tata Letak Panel Audit WDP RSVPKit WhatsApp Notification Logs dengan Statistik Metrik dan Tabel Riwayat Pengiriman

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 LogKode HTTPArti TeknisRekomendasi Solusi
SENT200Pesan sukses diterima dan diantrekan oleh server gatewayTidak memerlukan tindakan lebih lanjut
PENDING0Pesan sedang dalam antrean pemrosesan background queueTunggu eksekusi jadwal WP Cron (1 hingga 5 menit)
FAILED401Otentikasi ditolak akibat API Token salah atau kedaluwarsaPerbarui token di menu Settings > WhatsApp
FAILED400Format nomor telepon tujuan salah atau tidak terdaftarPerbaiki nomor telepon di menu Responses lalu klik Retry
FAILED429Batas kecepatan pengiriman (rate limit) gateway terlampauiNaikkan 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:

  1. Investigasi Cepat: Tim Andy & Zhea segera membuka menu RSVPKit > WhatsApp Logs dan memfilter baris log terakhir.
  2. 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).
  3. Koreksi Data: Tim membuka menu Responses, mengoreksi nomor telepon tamu menjadi format standar internasional +6591234567.
  4. Eksekusi Retry: Tim kembali ke halaman WhatsApp Logs dan menekan tombol Retry 1-Click.
  5. 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.

Pertanyaan yang Sering Diajukan (FAQ)

Mengapa sebuah pesan tercatat berstatus FAILED di halaman WA Logs? +
Status FAILED terjadi jika nomor tujuan tidak terdaftar di WhatsApp, server gateway mengalami down, saldo kuota habis, atau token API yang dipasang salah. Anda dapat mengklik tombol 'View Payload' untuk melihat pesan error spesifik dari server gateway.
Apakah pesan yang berstatus FAILED dapat dikirimkan ulang secara instan? +
Bisa. Anda cukup mengklik tombol 'Retry 1-Click' pada baris log bersangkutan atau tombol 'Retry Failed Messages' di pojok kanan atas untuk memproses ulang seluruh pesan yang gagal secara massal.
Apakah riwayat log notifikasi ini akan membuat ukuran database WordPress membengkak? +
Tidak. WDP RSVPKit dilengkapi kebijakan retensi otomatis (auto-purge) yang membersihkan rekaman log yang sudah berhasil terkirim lebih dari 30 hari secara berkala via WP Cron.
Bagaimana cara menyaring riwayat pesan khusus untuk satu acara undangan tertentu? +
Gunakan menu dropdown filter tipe notifikasi dan rentang tanggal di bagian atas tabel untuk menampilkan riwayat pesan yang Anda butuhkan.
Apakah rekaman log ini mencatat data sensitif tamu undangan? +
Log hanya mencatat nomor telepon tujuan, nama tamu, ringkasan status kehadiran, dan kode respon gateway untuk kebutuhan audit teknis tanpa mengekspos kata sandi atau data sensitif lainnya.