AgenWebsite WhatsApp Notification

Instalasi Plugin

Langkah 1: Unduh dan Pasang Plugin

1. Masuk ke Dashboard WordPress Anda
2. Navigasi ke Plugins > Add New (Plugin > Tambah Baru)
3. Klik tombol Upload Plugin di bagian atas halaman
4. Pilih file plugin agenwebsite-whatsapp-notification.zip yang telah Anda unduh
5. Klik Install Now (Pasang Sekarang)
6. Setelah instalasi selesai, klik Activate Plugin (Aktifkan Plugin)

Langkah 2: Verifikasi Instalasi

Setelah plugin diaktifkan, Anda akan melihat menu baru di sidebar admin WordPress:

• AgenWebsite WhatsApp Notification – Menu utama plugin

Anda juga akan melihat link Settings (Pengaturan) di halaman daftar plugin.

---

Aktivasi Lisensi

Mengapa Lisensi Diperlukan?

Plugin ini memerlukan lisensi aktif untuk menggunakan semua fitur. Lisensi memastikan Anda mendapatkan akses ke server WhatsApp API dan dukungan teknis dari AgenWebsite.

Metode 1: Melalui Setup Wizard (Direkomendasikan)

Saat pertama kali mengakses plugin tanpa lisensi, Anda akan secara otomatis diarahkan ke Setup Wizard.

Langkah 1: Halaman Selamat Datang

1. Buka menu AgenWebsite WhatsApp Notification di sidebar admin
2. Anda akan diarahkan ke halaman Setup Wizard
3. Klik Mulai Konfigurasi untuk melanjutkan

Langkah 2: Masukkan Kode Lisensi

1. Masukkan Kode Lisensi yang Anda dapatkan dari halaman akun AgenWebsite
2. Klik tombol Aktifkan Lisensi
3. Tunggu proses validasi lisensi

Langkah 3: Konfirmasi Aktivasi

Jika lisensi valid, Anda akan melihat pesan sukses dan secara otomatis diarahkan ke langkah selanjutnya (Menghubungkan WhatsApp).

Metode 2: Melalui Halaman Pengaturan

1. Navigasi ke AgenWebsite WhatsApp Notification di menu admin
2. Anda akan melihat halaman Kode Lisensi
3. Masukkan kode lisensi Anda pada field yang tersedia
4. Klik tombol Aktifkan Lisensi

Mendapatkan Kode Lisensi

1. Kunjungi https://agenwebsite.com/account
2. Login ke akun Anda
3. Cari produk AgenWebsite WhatsApp Notification
4. Salin kode lisensi yang tersedia

Deaktivasi Lisensi

Jika Anda perlu memindahkan lisensi ke website lain:

1. Navigasi ke halaman pengaturan plugin
2. Klik tombol Deaktivasi di samping field lisensi
3. Konfirmasi deaktivasi pada modal yang muncul
4. Lisensi Anda sekarang dapat digunakan di website lain

---

Menghubungkan WhatsApp

Tujuan Koneksi WhatsApp

Koneksi WhatsApp diperlukan agar plugin dapat mengirimkan pesan notifikasi ke nomor WhatsApp pelanggan dan admin. Plugin menggunakan teknologi WhatsApp Web untuk mengirimkan pesan.

Langkah-Langkah Menghubungkan WhatsApp

Langkah 1: Akses Halaman Device

1. Navigasi ke AgenWebsite WhatsApp Notification > Device
2. Atau jika melalui Setup Wizard, Anda akan diarahkan secara otomatis

Langkah 2: Generate QR Code

1. Pada bagian Connect WhatsApp, klik tombol Connect WhatsApp Account
2. Sistem akan menghasilkan QR Code untuk dipindai

Langkah 3: Pindai QR Code

1. Buka aplikasi WhatsApp di ponsel Anda
2. Masuk ke Settings > Linked Devices (Pengaturan > Perangkat Tertaut)
3. Ketuk Link a Device (Tautkan Perangkat)
4. Arahkan kamera ponsel ke QR Code yang ditampilkan di layar
5. Tunggu proses verifikasi selesai

Langkah 4: Verifikasi Koneksi

Setelah berhasil terhubung, Anda akan melihat:

• Status: Connected (Terhubung)
• Nomor telepon yang terhubung
• Waktu terakhir koneksi

Memutuskan Koneksi WhatsApp

Jika Anda perlu memutuskan koneksi:

1. Navigasi ke Device > Connection
2. Klik tombol Disconnect WhatsApp
3. Konfirmasi pemutusan koneksi

Refresh Status Koneksi

Untuk memperbarui status koneksi secara manual:

• Klik tombol Refresh Status pada halaman Device

---

Fitur-Fitur Plugin

1. Pengaturan Umum (General)

Navigasi: AgenWebsite WhatsApp Notification > General

Tujuan: Mengkonfigurasi pengaturan dasar plugin termasuk aktivasi/nonaktifasi notifikasi dan pengaturan checkout.

Opsi yang Tersedia:

Pengaturan	Deskripsi	Default
Aktifkan/Nonaktifkan	Mengaktifkan atau menonaktifkan fitur WhatsApp Notification secara keseluruhan	Aktif
Nomor WhatsApp Admin	Nomor WhatsApp yang akan menerima notifikasi pesanan baru	–
Enable Confirmation	Mengaktifkan halaman konfirmasi pada checkout	Aktif
Confirmation Message	Pesan konfirmasi yang ditampilkan di halaman checkout	“Kirimkan saya notifikasi via WhatsApp”

Cara Mengkonfigurasi:

1. Buka menu AgenWebsite WhatsApp Notification
2. Pilih tab General di navigasi atas
3. Pada sidebar kiri, pilih General
4. Konfigurasi setiap opsi sesuai kebutuhan:
   • Centang Aktifkan WhatsApp Notification untuk mengaktifkan plugin
   • Masukkan Nomor WhatsApp Admin dalam format internasional (contoh: 628123456789)
   • Konfigurasi pengaturan checkout sesuai kebutuhan
5. Klik Save Changes untuk menyimpan pengaturan

---

2. Template Notifikasi

Navigasi: AgenWebsite WhatsApp Notification > General > [Nama Template]

Tujuan: Mengkustomisasi pesan notifikasi WhatsApp yang dikirim untuk setiap status pesanan.

Template yang Tersedia:

Template	Ikon	Deskripsi	Penerima
New Order	Cart	Notifikasi saat ada pesanan baru	Admin
Pending	Clock	Notifikasi menunggu pembayaran	Pelanggan
On-Hold	Pause	Notifikasi pesanan ditahan	Pelanggan
Processing	Sync	Notifikasi pesanan sedang diproses	Pelanggan
Completed	Check	Notifikasi pesanan selesai	Pelanggan
Cancelled	Times	Notifikasi pesanan dibatalkan	Pelanggan
Refunded	Undo	Notifikasi dana dikembalikan	Pelanggan

Cara Mengedit Template:

1. Navigasi ke General > [Nama Template] (contoh: Processing)
2. Anda akan melihat:
   • Enable/Disable – Checkbox untuk mengaktifkan template ini
   • Content – Area teks untuk isi pesan

3. Untuk mengaktifkan template, centang Enable whatsapp notification
4. Edit isi pesan pada area Content
5. Gunakan Shortcode yang tersedia untuk memasukkan data dinamis
6. Klik Save Changes untuk menyimpan

Menggunakan Shortcode (Variabel Dinamis):

Klik pada bagian Available Shortcodes untuk melihat daftar variabel yang tersedia.

Kategori Shortcode:

Order Information (Informasi Pesanan):
| Shortcode | Deskripsi |
|———–|———–|
| {order_id} | Nomor ID pesanan |
| {total_amount} | Total jumlah pembayaran (terformat) |
| {order_status} | Status pesanan saat ini |
| {order_date_created} | Tanggal pembuatan pesanan |
| {payment_method} | Metode pembayaran yang digunakan |
| {currency} | Kode mata uang |
| {payment_detail} | Detail dan instruksi pembayaran |

Customer Information (Informasi Pelanggan):
| Shortcode | Deskripsi |
|———–|———–|
| {billing_first_name} | Nama depan pelanggan |
| {billing_last_name} | Nama belakang pelanggan |
| {billing_email} | Alamat email pelanggan |
| {billing_phone} | Nomor telepon pelanggan |
| {billing_company} | Nama perusahaan pelanggan |

Site Information (Informasi Website):
| Shortcode | Deskripsi |
|———–|———–|
| {site_name} | Nama website |
| {site_url} | URL website |
| {admin_email} | Email admin website |

Product Information (Informasi Produk):
| Shortcode | Deskripsi |
|———–|———–|
| {product_name} | Daftar nama produk yang dipesan |
| {order_shipping_title} | Nama metode pengiriman |

Address Information (Informasi Alamat):
| Shortcode | Deskripsi |
|———–|———–|
| {billing_address_1} | Alamat billing baris 1 |
| {billing_address_2} | Alamat billing baris 2 |
| {billing_city} | Kota billing |
| {billing_state} | Provinsi/Negara bagian billing |
| {billing_postcode} | Kode pos billing |
| {shipping_address_1} | Alamat pengiriman baris 1 |
| {shipping_address_2} | Alamat pengiriman baris 2 |
| {shipping_city} | Kota pengiriman |
| {shipping_state} | Provinsi/Negara bagian pengiriman |
| {shipping_postcode} | Kode pos pengiriman |

Menyalin Shortcode:

1. Buka panel Available Shortcodes
2. Klik pada shortcode yang diinginkan
3. Shortcode akan tersalin ke clipboard
4. Tempelkan (paste) pada area Content template

Contoh Template Processing:

=� *Order Processing*

Hi {billing_first_name},
Thank you! Your payment has been received.

Your order #{order_id} is now being processed and will be shipped soon. You can track your order status on our website.

=� *Items Being Processed*
Products: {product_name}

We will notify you when your order ships. Please contact us if you need assistance.

Thank you,
{site_name} - {site_url}

Format Teks WhatsApp:

• *teks* – Teks tebal (bold)
• _teks_ – Teks miring (italic)
• ~teks~ – Teks dicoret (strikethrough)

---

3. Koneksi Perangkat (Device)

Navigasi: AgenWebsite WhatsApp Notification > Device

Tujuan: Mengelola koneksi WhatsApp dan melihat status perangkat yang terhubung.

Submenu Device:

a. Connection (Koneksi)

Tujuan: Mengelola koneksi akun WhatsApp dengan plugin.

Informasi yang Ditampilkan:

Field	Deskripsi
Connection Status	Status koneksi (Connected/Disconnected)
Phone Number	Nomor telepon yang terhubung
Last Connected	Waktu terakhir koneksi diverifikasi
Session Status	Status sesi WhatsApp Web
Message Capabilities	Kemampuan pengiriman pesan yang didukung

Kapabilitas Pesan:

•  Text Messages – Pesan teks
•  Order Notifications – Notifikasi pesanan
•  Status Updates – Pembaruan status
• � Media Messages – Pesan media (segera hadir)

Tombol Aksi:

• Refresh Status – Memperbarui status koneksi
• Disconnect WhatsApp – Memutuskan koneksi

b. Test Message (Pesan Uji Coba)

Tujuan: Mengirimkan pesan uji coba untuk memastikan koneksi WhatsApp berfungsi dengan benar.

Catatan: Menu Test Message hanya aktif jika WhatsApp sudah terhubung.

---

4. Kirim Pesan Uji Coba (Test Message)

Navigasi: AgenWebsite WhatsApp Notification > Device > Test Message

Tujuan: Memverifikasi bahwa integrasi WhatsApp berfungsi dengan benar sebelum digunakan secara live.

Cara Mengirim Pesan Uji Coba:

1. Pastikan WhatsApp sudah terhubung (lihat status di tab Connection)
2. Navigasi ke Device > Test Message
3. Isi field yang diperlukan:

Field	Deskripsi	Contoh
Phone Number	Nomor tujuan dalam format internasional	628123456789
Message Template	Pilih template yang ingin diuji	Custom Message / Processing
Order ID (Optional)	ID pesanan untuk data real (opsional)	12345
Message	Isi pesan yang akan dikirim	[isi pesan]

4. Untuk melihat pratinjau dengan data contoh, klik Preview Template
5. Klik Send Test Message untuk mengirim

Menggunakan Template yang Ada:

1. Pilih template dari dropdown Message Template
2. Isi pesan akan otomatis terisi dengan template yang dipilih
3. Field Order ID akan muncul untuk template status pesanan
4. Masukkan Order ID jika ingin menguji dengan data pesanan real

Pratinjau Template:

Klik Preview Template untuk melihat:

• Pesan dengan variabel yang sudah diganti dengan data contoh
• Sumber data yang digunakan (sample data atau real order)

Hasil Pengiriman:

Setelah mengirim, Anda akan melihat notifikasi:

• Sukses: “Test message sent successfully” (hijau)
• Gagal: Pesan error dengan alasan kegagalan (merah)

---

5. Riwayat Pesan (History)

Navigasi: AgenWebsite WhatsApp Notification > History

Tujuan: Melihat log semua pesan WhatsApp yang telah dikirim, memantau status pengiriman, dan mengelola pesan yang gagal.

Statistik Pengiriman (30 Hari Terakhir):

Dashboard statistik menampilkan empat kartu informasi:

Statistik	Ikon	Deskripsi
Total Messages	Email	Jumlah total pesan yang dikirim
Sent	Check	Jumlah pesan berhasil terkirim
Failed	X	Jumlah pesan gagal terkirim
Success Rate	Chart	Persentase keberhasilan pengiriman

Tabel Riwayat Pesan:

Kolom yang ditampilkan:

Kolom	Deskripsi
Recipient	Nomor telepon penerima
Message	Pratinjau isi pesan
Status	Status pengiriman (Sent/Failed/Queued)
Type	Tipe pesan (customer/admin)
Order	Nomor pesanan terkait
Created	Waktu pembuatan pesan

Status Pesan:

Status	Warna	Deskripsi
Sent	Hijau	Pesan berhasil terkirim
Failed	Merah	Pesan gagal terkirim
Queued	Kuning	Pesan dalam antrian

Fitur Pencarian dan Filter:

1. Gunakan kotak Search Messages untuk mencari pesan
2. Filter berdasarkan status, tanggal, atau tipe pesan

Melihat Detail Pesan:

1. Klik pada baris pesan atau ikon View
2. Modal detail akan muncul menampilkan:
   • Nomor penerima
   • Status pengiriman
   • Tipe pesan
   • Nomor pesanan
   • Waktu pembuatan dan pengiriman
   • Isi pesan lengkap
   • Pesan error (jika gagal)

Mengirim Ulang Pesan Gagal:

1. Cari pesan dengan status Failed
2. Klik tombol Retry pada pesan tersebut
3. Konfirmasi pengiriman ulang
4. Pesan akan dikirim ulang dan status akan diperbarui

---

Perspektif Pengguna Akhir

Pengalaman Pelanggan di Checkout

Jika fitur konfirmasi diaktifkan, pelanggan akan melihat opsi di halaman checkout:

1. Pelanggan mengisi informasi checkout seperti biasa
2. Di bagian bawah form, terdapat checkbox: “Kirimkan saya notifikasi via WhatsApp”
3. Jika pelanggan mencentang, mereka akan menerima notifikasi WhatsApp untuk update pesanan

Notifikasi yang Diterima Pelanggan

Pelanggan akan menerima notifikasi WhatsApp pada saat:

1. Pesanan Tertunda (Pending Payment)

Ketika pelanggan membuat pesanan dan menunggu pembayaran:

• Informasi pesanan lengkap
• Detail pembayaran
• Instruksi cara bayar

2. Pesanan Ditahan (On Hold)

Ketika pesanan memerlukan konfirmasi manual:

• Pemberitahuan pesanan ditahan
• Alasan penahanan
• Langkah selanjutnya

3. Pesanan Diproses (Processing)

Ketika pembayaran dikonfirmasi:

• Konfirmasi pembayaran diterima
• Status pesanan sedang diproses
• Estimasi pengiriman

4. Pesanan Selesai (Completed)

Ketika pesanan telah dikirim/diterima:

• Konfirmasi pesanan selesai
• Ucapan terima kasih
• Permintaan review

5. Pesanan Dibatalkan (Cancelled)

Ketika pesanan dibatalkan:

• Pemberitahuan pembatalan
• Informasi kontak untuk pertanyaan

6. Refund Diproses (Refunded)

Ketika dana dikembalikan:

• Konfirmasi refund diproses
• Estimasi waktu pengembalian dana

Notifikasi yang Diterima Admin

Admin toko akan menerima notifikasi WhatsApp:

Pesanan Baru (New Order)

Setiap ada pesanan baru:

• Ringkasan pesanan
• Informasi pelanggan
• Detail produk yang dipesan
• Total pembayaran

---

Pemecahan Masalah (Troubleshooting)

Masalah Umum dan Solusi

1. QR Code Tidak Muncul

Gejala: Tombol “Connect WhatsApp Account” diklik tapi QR Code tidak muncul.

Solusi:

1. Periksa koneksi internet website Anda
2. Pastikan lisensi sudah diaktifkan dan valid
3. Coba refresh halaman browser
4. Periksa console browser untuk error JavaScript (tekan F12)

2. WhatsApp Tidak Terhubung Setelah Scan QR

Gejala: QR Code berhasil dipindai tapi status tetap “Disconnected”.

Solusi:

1. Klik tombol Refresh Status untuk memperbarui status
2. Pastikan ponsel Anda terhubung ke internet
3. Tunggu beberapa detik karena proses koneksi memerlukan waktu
4. Jika gagal, generate QR Code baru dan pindai ulang

3. Pesan Tidak Terkirim

Gejala: Status pesanan berubah tapi pelanggan tidak menerima WhatsApp.

Solusi:

1. Periksa Device > Connection – pastikan status “Connected”
2. Periksa History untuk melihat status pengiriman
3. Pastikan template untuk status tersebut diaktifkan (Enable tercentang)
4. Verifikasi nomor telepon pelanggan sudah benar dan menggunakan format internasional
5. Kirim Test Message untuk memastikan koneksi berfungsi

4. Lisensi Tidak Valid

Gejala: Muncul pesan “Invalid license code” saat aktivasi.

Solusi:

1. Periksa kembali kode lisensi (salin ulang dari akun AgenWebsite)
2. Pastikan tidak ada spasi di awal atau akhir kode
3. Pastikan lisensi belum digunakan di website lain
4. Hubungi support AgenWebsite jika masalah berlanjut

5. Koneksi WhatsApp Terputus

Gejala: Status berubah menjadi “Disconnected” secara tiba-tiba.

Penyebab:

• Ponsel WhatsApp mati atau tidak terhubung internet
• Logout manual dari perangkat tertaut di aplikasi WhatsApp
• Session timeout

Solusi:

1. Buka Device > Connection
2. Klik Connect WhatsApp Account untuk generate QR Code baru
3. Pindai ulang dengan aplikasi WhatsApp di ponsel

6. Template Tidak Tersimpan

Gejala: Perubahan template tidak tersimpan setelah klik Save Changes.

Solusi:

1. Pastikan tidak ada error validasi pada form
2. Periksa koneksi internet
3. Refresh halaman dan coba lagi
4. Periksa apakah ada plugin lain yang berkonflik

7. Pesan Error “WhatsApp not configured”

Gejala: Error muncul di log saat mengirim notifikasi.

Solusi:

1. Pastikan lisensi sudah diaktifkan
2. Pastikan WhatsApp sudah terhubung (status Connected)
3. Periksa pengaturan General – pastikan plugin diaktifkan