> 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/integrasi-dengan-sejoli.md).

# Integrasi dengan Sejoli

Dengan integrasi ini, WatZap mengirim pesan WhatsApp otomatis ke member Sejoli setiap kali status pesanannya berubah, mulai dari pendaftaran, menunggu pembayaran, diproses, dikirim, selesai, sampai dibatalkan atau direfund. Kamu juga bisa mengirim pesan komisi ke afiliasi, rangkaian **Follow Up** untuk pesanan yang belum dibayar, dan notifikasi ke nomor admin toko.

**Ringkasan alur** (sekitar 20 menit):

1. Pasang WatZap dan hubungkan akun. Ini cukup sekali untuk semua integrasi.
2. Pastikan Sejoli aktif dan member punya nomor WhatsApp.
3. Aktifkan dan tulis pesan per kejadian di **WatZap » Sejoli**.
4. Atur Follow Up, notifikasi admin, dan pengaturan nomor.
5. Uji coba.

Untuk gambaran umum, Kamu bisa cek video berikut. Tampilan di video masih memakai plugin versi lama, jadi ikuti langkah tertulis di bawah untuk plugin versi terbaru.

{% embed url="<https://www.youtube.com/watch?v=QCWclRbycHc>" %}

{% hint style="info" %}
Panduan ini untuk plugin **WatZap.id versi 1.1.0** ke atas. Jika layar Sejoli di plugin Kamu masih berupa accordion dengan tab **Template Messages**, berarti plugin Kamu masih versi lama. Perbarui dulu lewat [Memasang Plugin WatZap di WordPress](/help/integrations/memasang-plugin-watzap-di-wordpress.md).

Bahasa plugin mengikuti bahasa WordPress Kamu. Panduan ini memakai label Bahasa Indonesia, dengan padanan bahasa Inggrisnya dalam kurung.
{% endhint %}

## Istilah yang akan Kamu temui

* **Kejadian**: momen yang memicu pesan, misalnya status pesanan Sejoli berubah menjadi menunggu pembayaran. Tiap kejadian punya pesannya sendiri dan bisa dinyalakan atau dimatikan.
* **Kanal Reguler** dan **Official (WABA)**: Reguler mengirim teks bebas dari nomor WhatsApp biasa. Official mengirim template resmi lewat WhatsApp Business API. Pemula cukup memakai Reguler.
* **Variabel**: kode seperti `{{buyer-name}}` yang otomatis diganti dengan data pesanan, misalnya nama member.

## Langkah 1: Pasang WatZap dan hubungkan akun

Ikuti [Memasang Plugin WatZap di WordPress](/help/integrations/memasang-plugin-watzap-di-wordpress.md) sampai API Key terhubung dan ada nomor pengirim dengan **Rotasi** menyala. Jika sudah pernah, lewati ke Langkah 2.

## Langkah 2: Pastikan Sejoli siap

1. Plugin **Sejoli** harus terpasang dan aktif. Kalau belum, halaman **WatZap » Sejoli** hanya menampilkan kartu **Sejoli belum terpasang** dengan tombol ke daftar plugin.
2. Member harus punya **nomor WhatsApp** di profil Sejoli-nya. Pesan dikirim ke nomor itu. Kalau kosong, pesan untuk member tersebut dilewati tanpa peringatan. Pastikan formulir checkout Sejoli Kamu meminta nomor HP.
3. Kalau Sejoli Kamu punya pengiriman WhatsApp bawaan yang aktif, matikan supaya member tidak menerima pesan dobel.

## Langkah 3: Aktifkan pesan untuk member

Buka **WatZap » Sejoli**. Di kanan atas ada pil **Aktif** yang menandakan plugin Sejoli terdeteksi. Halaman ini punya lima tab:

* **Pesan Member** (Member Messages): pesan ke member saat status pesanan berubah.
* **Afiliasi**: pemberitahuan komisi untuk afiliasi.
* **Follow Up**: pesan susulan bila pesanan belum dibayar.
* **Notifikasi Admin** (Admin Notifications): salinan pemberitahuan ke nomor admin toko.
* **Pengaturan** (Settings): kode negara, formulir checkout, dan nomor admin.

![Halaman WatZap Sejoli dengan tab Pesan Member](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FkjVSfNyE7XuCC1xUMncJ%2Fsejoli-pesan-member.png?alt=media)

### Tab Pesan Member

Ada 7 kejadian yang bisa Kamu aktifkan, masing-masing dengan pesannya sendiri:

| Kejadian                  | Kapan dikirim                            |
| ------------------------- | ---------------------------------------- |
| **Pendaftaran User Baru** | Member baru mendaftar, belum ada pesanan |
| **Menunggu Pembayaran**   | Status pesanan Sejoli menjadi *on-hold*  |
| **Pesanan Diproses**      | Status pesanan menjadi *in-progress*     |
| **Pengiriman**            | Status pesanan menjadi *shipping*        |
| **Pesanan Selesai**       | Status pesanan menjadi *completed*       |
| **Pembatalan Invoice**    | Status pesanan menjadi *cancelled*       |
| **Pesanan Direfund**      | Status pesanan menjadi *refunded*        |

Status *payment-confirm* di Sejoli tidak punya kejadian sendiri. Pesan berikutnya dikirim saat pesanan masuk *in-progress*.

Setiap baris punya tombol on/off di kiri, cuplikan isi pesan, dan pil kanal **Reguler** atau **Official**. Baris yang aktif tapi belum diisi ditandai **Aktif tapi belum diisi**, jadi pastikan tidak ada baris dengan tanda itu. Klik baris untuk membuka penyunting.

### Menulis pesan

Penyunting terbagi tiga kolom: daftar kejadian di kiri, isi pesan di tengah, dan **Pratinjau** gelembung WhatsApp di kanan. Di kolom tengah ada saklar **Aktifkan pesan ini** dan tombol **Simpan**.

![Penyunting pesan Sejoli: kejadian Menunggu Pembayaran pada kanal Reguler](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FbZ5EdONbT5bidQPNId1b%2Fsejoli-penyunting-pesan.png?alt=media)

1. Biarkan kanal pada **Reguler**.
2. Tulis pesan di kolom **Isi pesan**. Tombol **B**, **I**, **S**, dan `</>` memberi format tebal, miring, coret, dan monospace seperti di WhatsApp.
3. Sisipkan data pesanan lewat panel **Variabel**. Klik variabel yang diinginkan, kodenya masuk di posisi kursor. Ada kotak **Cari variabel** untuk menemukan cepat.
4. Nyalakan saklar **Aktifkan pesan ini**, lalu klik **Simpan**. Muncul notifikasi **disimpan** dan baris di daftar ikut berubah.

![Panel Variabel Sejoli dengan kelompok Umum dan Pesanan](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FqA5pnV4L2RbbBxLQlrNH%2Fsejoli-variabel.png?alt=media)

<details>

<summary>Daftar variabel Sejoli</summary>

**Umum**

| Variabel          | Isi                          |
| ----------------- | ---------------------------- |
| `{{sitename}}`    | Nama situs Kamu              |
| `{{site-url}}`    | Alamat situs Kamu            |
| `{{member-url}}`  | Tautan login member          |
| `{{confirm-url}}` | Tautan konfirmasi pembayaran |

**Pesanan**

| Variabel                | Isi                      |
| ----------------------- | ------------------------ |
| `{{order-id}}`          | Nomor pesanan            |
| `{{order-grand-total}}` | Total yang harus dibayar |
| `{{quantity}}`          | Jumlah item              |
| `{{order-detail}}`      | Rincian pesanan          |
| `{{order-meta}}`        | Data tambahan pesanan    |

**Pembeli**

| Variabel          | Isi              |
| ----------------- | ---------------- |
| `{{buyer-name}}`  | Nama pembeli     |
| `{{buyer-email}}` | Email pembeli    |
| `{{buyer-phone}}` | Nomor HP pembeli |

**Afiliasi**

| Variabel              | Isi               |
| --------------------- | ----------------- |
| `{{affiliate-name}}`  | Nama afiliasi     |
| `{{affiliate-phone}}` | Nomor HP afiliasi |
| `{{affiliate-email}}` | Email afiliasi    |
| `{{affiliate-tier}}`  | Tingkat afiliasi  |
| `{{commission}}`      | Nominal komisi    |

Khusus kejadian **Pendaftaran User Baru**, karena belum ada pesanan, variabel yang tersedia hanya `{{sitename}}`, `{{site-url}}`, `{{member-url}}`, `{{user-name}}`, `{{user-email}}`, `{{user-pass}}`, dan `{{user-phone}}`.

</details>

<details>

<summary>Opsional: kirim lewat kanal Official (WABA)</summary>

Kanal Official hanya bisa mengirim **template yang sudah disetujui Meta**. Syaratnya: [nomor WABA sudah terhubung](/help/waba-official/cara-connect-nomor-waba-official.md) dan [ada template yang disetujui](/help/waba-official/cara-membuat-template-waba-official.md).

Klik **Official (WABA)**, pilih template dari daftar **Template disetujui**, lalu di bagian **Isi parameter** pasangkan tiap parameter template dengan **Variabel** Sejoli atau **Teks tetap**. Semua parameter harus terisi, kalau tidak pesan tidak bisa diaktifkan. Pratinjau di kolom kanan menampilkan header, isi, footer, dan tombol template.

</details>

## Langkah 4: Afiliasi, Follow Up, admin, dan pengaturan

### Tab Afiliasi

Dua kejadian yang dikirim ke nomor afiliasi: **Komisi Affiliate** saat pesanan selesai dan komisi tercatat, dan **Pembayaran Komisi Affiliate** saat komisi ditandai sudah dibayar di Sejoli. Cara menulis pesannya sama dengan tab Pesan Member. Pakai variabel kelompok Afiliasi, misalnya `{{affiliate-name}}` dan `{{commission}}`.

![Tab Afiliasi dengan dua kejadian komisi](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F0grmyty2jXNvqAHBDRUF%2Fsejoli-afiliasi.png?alt=media)

### Tab Follow Up

Rangkaian **Follow Up 1** sampai **Follow Up 7** untuk pesanan yang masih menunggu pembayaran. Rangkaian dijadwalkan saat pesanan masuk status menunggu pembayaran, dan tiap follow up punya jeda sendiri yang dihitung dari follow up sebelumnya.

![Tab Follow Up berbentuk garis waktu](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FmzrER2kZRN2eQ0IcYk5o%2Fsejoli-follow-up.png?alt=media)

Buka salah satu follow up, lalu di bagian **Jeda pengiriman** atur **Jumlah** (1 sampai 20) dan **Satuan** (**Jam** atau **Hari**). Tulis pesannya seperti biasa, nyalakan, dan simpan. Di kepala daftar tampil total durasi rangkaian yang aktif, misalnya **Rangkaian berjalan 3 hari**. Hanya follow up yang aktif yang dihitung.

### Tab Notifikasi Admin

Delapan kejadian yang sama dengan Pesan Member ditambah **Komisi Affiliate**, tetapi dikirim ke nomor admin toko, bukan ke member. Nomor tujuannya diambil dari **Nomor tujuan notifikasi** di tab Pengaturan. Kalau belum diisi, di kepala daftar muncul peringatan **Nomor tujuan belum diisi**.

![Tab Notifikasi Admin dengan peringatan nomor tujuan belum diisi](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FkmSJHNoCWt4dgUyUpf5y%2Fsejoli-notifikasi-admin.png?alt=media)

### Tab Pengaturan

* **Kode negara bawaan**: dipakai saat member mengisi nomor tanpa kode negara. Biarkan **+62** untuk Indonesia.
* **Tampilkan pemilih kode negara di formulir checkout Sejoli**: menambahkan pemilih bendera pada kolom nomor HP di checkout Sejoli.
* **Nomor tujuan notifikasi**: daftar nomor admin yang menerima Notifikasi Admin. Tulis dengan kode negara tanpa tanda plus, misalnya `62812xxxxxxx`. Klik **Tambah nomor** untuk menambah penerima.

![Tab Pengaturan Sejoli](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FMjN3OwOMa5r7hJQezd5Y%2Fsejoli-pengaturan.png?alt=media)

Setelah mengubah pengaturan, klik **Simpan** di bar yang muncul di bagian bawah.

## Langkah 5: Uji coba

1. Nyalakan minimal kejadian **Menunggu Pembayaran** di tab Pesan Member.
2. Buat pesanan percobaan di situs Sejoli Kamu, dengan nomor WhatsApp Kamu sendiri sebagai member.
3. Dalam beberapa detik, pesan masuk ke WhatsApp Kamu. Jika Notifikasi Admin aktif, nomor admin juga menerima salinannya.

Kalau pesan tidak masuk, cek satu per satu:

* Nomor HP member terisi di profil Sejoli, lengkap dengan kode negara atau nomor lokal yang cocok dengan kode negara bawaan.
* Kejadian yang dimaksud sudah **aktif** dan isi pesannya tidak kosong.
* Di **WatZap » WhatsApp Numbers**, nomor pengirim berstatus **Tersambung** dan **Rotasi** menyala.
* Masih gagal? Lihat [Solusi Kendala Kirim Pesan via API](/help/integrations/solusi-kendala-kirim-pesan-via-api.md). Log pengiriman plugin tersimpan di folder `wp-content/uploads/watzap-logs/` pada hosting Kamu.

Lihat juga: [Integrasi dengan WooCommerce](/help/integrations/integrasi-dengan-woocommerce.md).