> 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/automation/cara-membuat-custom-by-keyword.md).

# Cara Membuat Custom by Keyword

Balas otomatis chat yang berisi kata kunci tertentu, misalnya "harga" atau "katalog", untuk nomor WhatsApp Reguler maupun WABA Official.

**Custom by Keyword** adalah balasan otomatis yang dikirim saat pesan pelanggan cocok dengan **kata kunci** (keyword) yang Kamu tentukan. Contohnya, pelanggan yang mengetik `katalog` langsung menerima katalog terbaru beserta pilihan menu.

Fitur ini cocok untuk pertanyaan yang sering berulang. Kamu tidak perlu menjawab hal yang sama berkali-kali dan bisa fokus ke pertanyaan yang lebih spesifik.

## Sebelum mulai

1. **Paket**: Custom by Keyword hanya tersedia di paket **Premium**.
2. **Nomor yang terhubung**: [nomor WhatsApp Reguler](https://docs.watzap.id/help/connect-to-whatsapp/cara-connect-nomor-whatsapp.md) atau [nomor WABA Official](https://docs.watzap.id/help/waba-official/cara-connect-nomor-waba-official.md).
3. **Text Replies** (opsional): kalau ingin menampilkan pilihan menu di bawah pesan, buat dulu [Text Replies](https://docs.watzap.id/help/automation/cara-membuat-text-replies.md).

{% hint style="info" %}
Satu nomor boleh punya banyak keyword, tetapi keyword yang sama tidak boleh dipakai dua kali di nomor yang sama. Huruf besar dan kecil dianggap sama, jadi `Katalog` dan `katalog` dihitung sebagai keyword yang sama.
{% endhint %}

## Perbedaan WhatsApp Reguler dan WABA Official

|                          | WhatsApp Reguler                                            | WABA Official                                                                      |
| ------------------------ | ----------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| Cara mencocokkan keyword | Tidak ada pilihan                                           | Bisa dipilih di **Reply when the message** (persis, mengandung, diawali, diakhiri) |
| Panjang pesan            | Maksimal 2.000 karakter                                     | Maksimal 1.024 karakter                                                            |
| Tampilan Text Replies    | Daftar pilihan bernomor yang diketik pelanggan              | Tombol (1–3 pilihan) atau menu daftar (4–5 pilihan)                                |
| Frequency per person     | Kosong (bawaan), atau Once every 15 minutes sampai 12 hours | **No limit** (bawaan), atau Once every 15 minutes sampai 12 hours                  |

## Langkah membuat Custom by Keyword

{% stepper %}
{% step %}

### Buka menu Custom by Keyword

Di menu samping, bagian **AUTOMATION**, klik **Smart Auto Reply**, lalu pilih **Custom by Keyword**.

![Menu Automation → Smart Auto Reply → Custom by Keyword](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FunnkXGkgVeJbsLBL7R9k%2FC3-01-menu.png?alt=media)
{% endstep %}

{% step %}

### Klik New Custom by Keyword

1. Klik **New Custom by Keyword** di kanan atas.

Tabel di bawahnya berisi keyword yang sudah ada: **Keyword**, **Number**, **Meta Pixel Event**, **Status**, dan **Actions**. Ikon kecil di samping keyword menandakan balasannya memakai lampiran. Klik ikon itu untuk melihat pratinjaunya.

![Tombol New Custom by Keyword](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F20kdBmoVlj3elVuf9pAl%2FC3-02-list.png?alt=media)

{% hint style="info" %}
Di luar paket Premium, tombol ini memunculkan pesan **Not available in your plan** dengan tombol **Upgrade plan**.
{% endhint %}
{% endstep %}

{% step %}

### Pilih jenis nomor

Di jendela **Choose Your Method**:

1. **WABA / Co-Ex (Official)**: untuk nomor WhatsApp Business API resmi.
2. **WhatsApp Reguler (Unofficial)**: untuk nomor yang terhubung lewat scan QR Code.
3. Klik **Continue**.

![Jendela Choose Your Method](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FA0Mj2iV3ZZDd4lrZp9oW%2FC3-03-method.png?alt=media)
{% endstep %}

{% step %}

### Isi keyword dan atur status

Halaman **Create a new Custom by Keyword** terbuka.

1. **Back**: kembali ke daftar keyword.
2. **Keyword**: kata kunci yang memicu balasan, maksimal 40 karakter, misalnya `katalog`.
3. **Status**: klik sakelar untuk mengubah **Inactive** menjadi **Active**.
4. **Save & exit** dan **Save**: tombol simpan.

![Kolom Keyword dan Status](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FuA5yJgwJ06wss8SGPmw0%2FC3-04-header.png?alt=media)
{% endstep %}

{% step %}

### Pilih cara mencocokkan keyword (WABA Official)

Khusus nomor WABA Official, ada kolom **Reply when the message**.

1. Klik kolomnya, lalu pilih salah satu:
   * **Is exactly the keyword** (bawaan): pesan harus persis sama dengan keyword. Contoh: `Katalog` cocok, tetapi `minta katalog` tidak.
   * **Contains the keyword**: pesan mengandung keyword di bagian mana saja. Contoh: `minta katalog dong` cocok.
   * **Starts with the keyword**: pesan diawali keyword. Contoh: `katalog terbaru` cocok.
   * **Ends with the keyword**: pesan diakhiri keyword. Contoh: `kirim katalog` cocok.

![Pilihan Reply when the message](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FJZCY1EB0Ek7fEkeAXuPu%2FC3-05-match.png?alt=media)

Huruf besar dan kecil diabaikan. Pilihan **Is exactly the keyword** paling aman, karena tidak membalas pesan yang kebetulan memuat keyword. Kalau satu pesan cocok dengan beberapa keyword, yang membalas adalah keyword yang **paling akhir dibuat**.
{% endstep %}

{% step %}

### Pilih nomor dan tulis pesan balasan

1. **WhatsApp number**: pilih nomornya. Nomor berlabel **Smart Bot** atau **Disconnected** tidak bisa dipilih. Untuk WABA Official, ada pengingat **24-hour reply window** di bawahnya.
2. **Reply message**: tulis balasan. Pakai toolbar untuk **tebal**, *miring*, ~~coret~~, atau emoji.
3. Keterangan **Sent when an incoming message matches your keyword.**

![Nomor WhatsApp dan pesan balasan](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FVoCwzKZypGG8xR7CbjHD%2FC3-06-message.png?alt=media)

Di bawah pesan ada kolom **Attachment** (opsional, khusus paket Premium): PNG, JPEG, PDF, XLS, XLSX, atau MP4, maksimal 1 MB. Caranya sama seperti di [Welcome Chat](https://docs.watzap.id/help/automation/cara-membuat-welcome-chat.md).
{% endstep %}

{% step %}

### Pasang Text Replies dan atur frekuensi (opsional)

1. **Insert replies**: klik **Select a reply**, lalu pilih [Text Reply](https://docs.watzap.id/help/automation/cara-membuat-text-replies.md).
2. **+ Add another reply**: tambah pilihan berikutnya, maksimal 5.
3. **Frequency per person**: batas seberapa sering orang yang sama menerima balasan ini. Contoh: dengan **Once every hour**, pelanggan yang mengetik `katalog` tiga kali dalam satu jam hanya dibalas sekali. Lihat [Apa Itu "Frequency per Person"?](https://docs.watzap.id/help/automation/apa-itu-frequency-per-person.md).
4. **Meta Pixel event**: event yang dikirim ke Meta setiap kali balasan terkirim, dari menu [Meta Conversion API](https://docs.watzap.id/help/meta-conversion-api/cara-mendapatkan-access-token-and-pixel-id.md).

![Insert replies, Frequency per person, dan Meta Pixel event](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FtUVYyPFYkRFToXQO6uQh%2FC3-07-replies.png?alt=media)
{% endstep %}

{% step %}

### Simpan

Klik **Save** (tetap di halaman ini) atau **Save & exit** (kembali ke daftar). Kalau status masih **Inactive**, muncul jendela **Activate now?**:

1. **Save as inactive**: simpan tanpa mengaktifkan.
2. **Save & activate**: simpan sekaligus aktifkan.

![Jendela Activate now?](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FzqBCynnIToBTPA9f0wR8%2FC3-09-activate.png?alt=media)

Muncul notifikasi **Saved**. Bila disimpan sebagai inactive, pesannya mengingatkan bahwa keyword belum membalas sampai statusnya **Active**.

1. Klik **OK**. Dengan **Save**, halaman berganti menjadi **Edit Custom by Keyword**. Dengan **Save & exit**, Kamu kembali ke daftar.

![Notifikasi Saved](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FdjipGM4IyBkQaw2myNWz%2FC3-10-saved.png?alt=media)
{% endstep %}
{% endstepper %}

## Tampilan editor untuk WhatsApp Reguler

1. Hanya ada kolom **Keyword** dan **Status**, tanpa pilihan **Reply when the message**.
2. **Frequency per person** bawaannya kosong (**Select frequency**).

Batas pesan 2.000 karakter, dan Text Replies tampil sebagai daftar bernomor yang diketik pelanggan.

![Editor Custom by Keyword untuk WhatsApp Reguler](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fw85t40QUQYbcy0pM4eI7%2FC3-08-reguler.png?alt=media)

## Mengubah, menonaktifkan, atau menghapus keyword

Cari keyword lewat kolom **Search** di halaman **Custom by Keyword**, lalu:

1. **Status**: klik sakelar **Active**/**Inactive**.
2. Ikon pensil: membuka editor (**Edit Custom by Keyword**).
3. Ikon tempat sampah: menghapus keyword.

![Status, Edit, dan Delete di daftar keyword](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FKACDPkYnECqstHVbN9H4%2FC3-11-row.png?alt=media)

Saat menghapus, muncul jendela **Confirm Deletion**. Klik **Yes, Delete** untuk melanjutkan. Keyword yang dihapus tidak bisa dikembalikan.

1. **Yes, Delete**: hapus keyword.

![Konfirmasi hapus keyword](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FD5Q16G1gH3QOdvLOHhcY%2FC3-12-delete.png?alt=media)

Untuk banyak keyword sekaligus, centang barisnya lalu pilih **Bulk Action** → **Set Status to Active**, **Set Status to Inactive**, atau **Delete Actions**.

## Masalah umum

<details>

<summary>Muncul pesan "Keyword already used"</summary>

Keyword yang sama sudah dipakai di nomor itu (huruf besar/kecil tidak dibedakan). Pakai keyword lain, atau ubah keyword yang sudah ada.

![Pesan Keyword already used](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FfL3AiippRSM7YcYgBocS%2FC3-13-duplicate.png?alt=media)

</details>

<details>

<summary>Keyword tidak membalas</summary>

Periksa hal berikut:

* Status keyword **Active** dan nomornya terhubung.
* Untuk WABA Official, cek **Reply when the message**. Dengan **Is exactly the keyword**, pesan `minta katalog` tidak dibalas oleh keyword `katalog`. Pakai **Contains the keyword** bila keyword boleh muncul di tengah kalimat.
* **Frequency per person**: orang yang sama mungkin masih dalam batas waktu.

</details>

<details>

<summary>Keyword yang salah ikut membalas</summary>

Dengan **Contains the keyword**, keyword pendek seperti `mau` juga cocok dengan kata lain yang memuatnya. Pakai keyword yang lebih spesifik, atau pilih **Is exactly the keyword**. Ingat juga: bila beberapa keyword cocok, yang membalas adalah keyword yang paling akhir dibuat.

</details>

<details>

<summary>Muncul "Upgrade needed" atau "Not available in your plan"</summary>

Custom by Keyword hanya bisa dibuat dan disimpan di paket **Premium**. Keyword lama tetap bisa dinyalakan atau dimatikan dari daftar.

</details>

## Panduan terkait

* [Cara Membuat Text Replies](https://docs.watzap.id/help/automation/cara-membuat-text-replies.md)
* [Apa Itu "Frequency per Person"?](https://docs.watzap.id/help/automation/apa-itu-frequency-per-person.md)
* [Cara Membuat Welcome Chat](https://docs.watzap.id/help/automation/cara-membuat-welcome-chat.md)
* [Cara Membuat Home Chat](https://docs.watzap.id/help/automation/cara-membuat-home-chat.md)
* [Cara Menggunakan Custom Rules](https://docs.watzap.id/help/automation/cara-menggunakan-custom-rules.md)
