> For the complete documentation index, see [llms.txt](https://docs.watzap.id/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.watzap.id/help/integrations/memasang-plugin-watzap-di-wordpress.md). # 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. {% hint style="info" %} Plugin **WatZap.id** sekarang tersedia resmi di [direktori plugin WordPress](https://wordpress.org/plugins/watzap-id/), 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](#pindah-dari-plugin-lama-versi-zip) supaya plugin Kamu bisa menerima pembaruan otomatis. {% endhint %} ## 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](https://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](https://wordpress.org/plugins/watzap-id/), 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](/help/integrations/mendapatkan-api-key-di-member-area.md). 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](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FbikN8VhqIy8mV8cV4AJv%2Fnomor-whatsapp-koneksi-akun-v2.png?alt=media) {% hint style="warning" %} 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. {% endhint %} ## 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](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FfMJR1VAwXS7RgQ62EFRB%2Fnomor-whatsapp-daftar-v2.png?alt=media) * Kalau daftarnya kosong, hubungkan nomor dulu lewat [Menambahkan Nomor WA untuk API](/help/integrations/menambahkan-nomor-wa-untuk-api.md), 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](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fixyijwxx6tjkYJxCaNpq%2Fnomor-whatsapp-tab-official.png?alt=media) 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](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FRj9xFhkngXNKOODxQTSy%2Fnomor-whatsapp-pengaturan-lanjutan.png?alt=media) Jika muncul pesan **Jalur official belum tersedia**, berarti akun WatZap Kamu belum punya nomor WABA. Ikuti [Cara Connect Nomor WABA Official](/help/waba-official/cara-connect-nomor-waba-official.md) terlebih dahulu.
## Langkah 4: Lanjut ke integrasi yang Kamu butuhkan * Toko online WooCommerce: [Integrasi dengan WooCommerce](/help/integrations/integrasi-dengan-woocommerce.md). * Produk digital dan membership Sejoli: [Integrasi dengan Sejoli](/help/integrations/integrasi-dengan-sejoli.md). * Form kontak atau pendaftaran: [WPForms](/help/integrations/integrasi-dengan-wpforms.md), [Contact Form 7](/help/integrations/integrasi-dengan-contact-form-7.md), atau [KIRIM.EMAIL](/help/integrations/integrasi-dengan-kirim.email.md). ## 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](#langkah-1-pasang-plugin-watzap). 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. {% hint style="warning" %} Jangan aktifkan WatZap.id selagi plugin **WatZap** lama masih aktif. Keduanya bentrok, sehingga WordPress menolak mengaktifkan plugin baru dan menampilkan pesan fatal error. {% endhint %} ### 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](#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](/help/integrations/solusi-kendala-kirim-pesan-via-api.md).