Memasang Plugin WatZap di WordPress

Plugin WatZap.id menghubungkan situs WordPress Kamu ke akun WatZap, supaya toko atau form di situs bisa mengirim pesan WhatsApp otomatis. Halaman ini adalah langkah pertama untuk semua integrasi: WooCommerce, Sejoli, dan Custom Form. Cukup dilakukan sekali per situs.

Ringkasan alur (sekitar 10 menit):

1. Pasang plugin WatZap.id dari direktori plugin WordPress.

2. Hubungkan API Key akun WatZap Kamu.

3. Pastikan ada nomor pengirim yang siap.

4. Lanjut ke tutorial integrasi yang Kamu butuhkan.

Plugin WatZap.id sekarang tersedia resmi di direktori plugin WordPress, jadi Kamu tidak perlu lagi mengunduh file zip. Jika di halaman Plugins nama plugin Kamu masih WatZap (tanpa ".id"), berarti Kamu masih memakai plugin lama dari file zip. Ikuti Pindah dari plugin lama versi zip supaya plugin Kamu bisa menerima pembaruan otomatis.

Yang perlu disiapkan

• WordPress 6.8 ke atas dengan PHP 7.2 ke atas.

• Akun WatZap yang aktif. Kalau belum punya, daftar dulu di watzap.id.

• Akses admin ke WordPress Kamu.

Istilah yang akan Kamu temui

• API Key: kode 16 digit dari akun WatZap Kamu. Fungsinya seperti kunci supaya plugin di WordPress boleh mengirim pesan lewat akun WatZap Kamu.

• Nomor pengirim dan Rotasi: nomor WhatsApp yang sudah Kamu hubungkan di aplikasi WatZap. Yang tombol Rotasi-nya menyala dipakai bergantian untuk mengirim pesan.

• WhatsApp Unofficial dan WhatsApp Official: Unofficial adalah nomor WhatsApp biasa yang Kamu scan di aplikasi WatZap. Official adalah nomor WhatsApp Business API (WABA) yang disetujui Meta dan hanya bisa mengirim template. Pemula cukup memakai Unofficial.

Langkah 1: Pasang plugin WatZap

1. Di dashboard WordPress, buka Plugins » Add New Plugin.

2. Ketik WatZap.id di kolom pencarian.

3. Pada kartu plugin WatZap.id, klik Install Now, lalu Activate.

4. Setelah aktif, muncul menu WatZap di sidebar WordPress dengan submenu WhatsApp Numbers, WooCommerce, Sejoli, Custom Form, dan WABA Templates.

Kalau hosting Kamu tidak mengizinkan pemasangan plugin dari dashboard, buka halaman WatZap.id di WordPress.org, klik Download, lalu unggah file zip-nya lewat Plugins » Add New Plugin » Upload Plugin.

Langkah 2: Hubungkan API Key

1. Ambil API Key Kamu dengan mengikuti Mendapatkan API Key di Member Area.

2. Buka WatZap » WhatsApp Numbers. Di pojok kanan atas ada tombol bertuliskan Belum terhubung. Klik tombol itu untuk membuka panel Koneksi akun (Account connection).

3. Isi kolom API Key, lalu klik Hubungkan (Connect).

Jika berhasil, halaman dimuat ulang dan panelnya berubah menjadi seperti ini: ada tanda Terhubung ke akun WatZap beserta nama paket dan masa berlakunya.

Panel Koneksi akun setelah API Key berhasil dihubungkan

Satu API Key dipakai oleh semua integrasi di situs ini. Jangan bagikan ke siapa pun. Jika Kamu klik Putuskan koneksi (Disconnect), semua pengiriman berhenti sampai API Key baru dipasang.

Langkah 3: Pastikan ada nomor pengirim

Masih di halaman WhatsApp Numbers, tab WhatsApp Unofficial menampilkan semua nomor WhatsApp biasa yang sudah Kamu scan di aplikasi WatZap. Harus ada minimal satu nomor berstatus Tersambung dengan tombol Rotasi (Rotation) menyala. Nomor itulah yang mengirim pesan ke pembeli atau pengisi form.

Halaman WhatsApp Numbers dengan nomor Tersambung dan Rotasi menyala

• Kalau daftarnya kosong, hubungkan nomor dulu lewat Menambahkan Nomor WA untuk API, lalu kembali ke halaman ini dan klik Sinkronkan (Sync).

• Kalau ada beberapa nomor dengan Rotasi menyala, pesan dikirim bergantian supaya beban tiap nomor lebih ringan.

• Kalau semua Rotasi mati, halaman integrasi menampilkan peringatan No number is ready to send dan tidak ada pesan yang terkirim.

Opsional: tab WhatsApp Official (WABA)

Tab WhatsApp Official menampilkan nomor WhatsApp Business API yang terhubung ke akun WatZap Kamu. Satu API Key hanya terikat ke satu nomor official, jadi di sini tidak ada daftar nomor dan tidak ada rotasi.

Di tab ini Kamu bisa melihat nama pengirim, status, Kualitas (Quality), WABA ID, ID Nomor Pengirim, serta kartu Kesehatan pengiriman (Delivery health) berupa jumlah pesan Diterima, Sampai, Dibaca, dan Gagal, lengkap dengan penyebab kegagalan terbanyak.

Tab WhatsApp Official dengan kartu Kesehatan pengiriman

Tombol gerigi di kanan atas membuka Pengaturan lanjutan. Isi kolom API Key v1 hanya jika diminta oleh tim dukungan WatZap. Salah isi membuat pengiriman official berhenti.

Modal Pengaturan lanjutan dengan kolom API Key v1

Jika muncul pesan Jalur official belum tersedia, berarti akun WatZap Kamu belum punya nomor WABA. Ikuti Cara Connect Nomor WABA Official terlebih dahulu.

Langkah 4: Lanjut ke integrasi yang Kamu butuhkan

• Toko online WooCommerce: Integrasi dengan WooCommerce.

• Produk digital dan membership Sejoli: Integrasi dengan Sejoli.

• Form kontak atau pendaftaran: WPForms, Contact Form 7, atau KIRIM.EMAIL.

Hal lain yang perlu Kamu tahu

Pindah dari plugin lama versi zip

Plugin lama yang dulu diunduh sebagai file watzap.zip tampil dengan nama WatZap di halaman Plugins. Plugin ini tidak menerima pembaruan otomatis dan tidak bisa aktif bersamaan dengan WatZap.id, jadi hapus dulu sebelum memasang yang baru:

1. Buka Plugins » Installed Plugins, cari plugin WatZap, lalu klik Deactivate.

2. Klik Delete pada plugin yang sama, lalu konfirmasi.

3. Pasang WatZap.id seperti di Langkah 1.

4. Buka WatZap » WhatsApp Numbers dan pastikan panelnya masih menampilkan Terhubung ke akun WatZap.

API Key, nomor pengirim, dan semua integrasi Kamu tidak ikut terhapus. WatZap.id otomatis memakai pengaturan lama itu begitu diaktifkan.

Jangan aktifkan WatZap.id selagi plugin WatZap lama masih aktif. Keduanya bentrok, sehingga WordPress menolak mengaktifkan plugin baru dan menampilkan pesan fatal error.

Bahasa plugin

Bahasa plugin mengikuti bahasa WordPress Kamu. Semua tutorial di sini memakai label Bahasa Indonesia dengan padanan bahasa Inggrisnya dalam kurung.

Memperbarui plugin

Karena dipasang dari direktori plugin WordPress, versi baru WatZap.id muncul seperti pembaruan plugin lainnya. Buka Plugins, lalu klik update now di bawah WatZap.id. Supaya tidak perlu memperbarui secara manual, klik Enable auto-updates pada baris plugin WatZap.id. Semua pengaturan dan integrasi Kamu tetap tersimpan.

Menonaktifkan atau menghapus plugin

Menonaktifkan atau menghapus plugin menghentikan semua pengiriman, tetapi tidak menghapus pengaturan. Kalau plugin dipasang lagi, API Key dan semua integrasi kembali seperti semula.

Kalau ada masalah

• Tombol Install Now berubah menjadi Cannot Install: versi WordPress Kamu di bawah 6.8. Perbarui WordPress dulu lewat Dashboard » Updates.

• Plugin gagal diaktifkan karena fatal error: plugin WatZap lama masih aktif. Ikuti Pindah dari plugin lama versi zip.

• API Key ditolak: pastikan 16 digit tersalin utuh tanpa spasi, dan paket WatZap Kamu masih aktif.

• No number is ready to send: buka tab WhatsApp Unofficial, pastikan ada nomor Tersambung dan nyalakan Rotasi-nya.

• Nomor tidak muncul di daftar: hubungkan dulu di aplikasi WatZap, lalu klik Sinkronkan.

• Pesan tidak masuk padahal semua sudah aktif: jika situs memakai plugin cache, bersihkan cache lalu coba lagi. Log pengiriman plugin tersimpan di folder wp-content/uploads/watzap-logs/ pada hosting Kamu.

• Masih gagal? Lihat Solusi Kendala Kirim Pesan via API.