> 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/waba-official/cara-menggunakan-fitur-variabel-waba-official.md).

# Cara Menggunakan Fitur Variabel WABA Official

Pakai variabel seperti {{full\_name}} di template WABA Official supaya satu broadcast terasa personal, lalu petakan variabel itu ke kolom list kontak saat membuat broadcast.

Pernah menerima pesan WhatsApp dari brand yang menyebut nama Kamu secara otomatis? Itu memakai **variabel**. Dengan variabel, satu template bisa dikirim ke ribuan kontak, tapi isinya tetap personal untuk masing-masing penerima.

**Variabel** adalah penanda di dalam template yang ditulis dengan kurung kurawal ganda, misalnya `{{full_name}}` atau `{{diskon}}`. Saat broadcast dikirim, penanda itu diganti dengan data dari kolom list kontak, misalnya **Full Name** menjadi *Budi*.

Caranya dua tahap: **pasang variabel di template**, lalu **petakan variabel ke kolom list** saat membuat broadcast.

## Sebelum mulai

1. **Nomor WABA sudah terhubung.** Lihat [Cara Connect Nomor WABA Official](https://docs.watzap.id/help/waba-official/cara-connect-nomor-waba-official.md).
2. **List kontak punya kolom datanya.** Misalnya kolom **Diskon** untuk variabel `{{diskon}}`. Cara menambah kolom: [Penjelasan Fitur "Column" di List](https://docs.watzap.id/help/list/penjelasan-fitur-column-di-list.md).

## Aturan variabel

* Nama variabel memakai huruf kecil, angka, dan garis bawah, misalnya `{{full_name}}`. Spasi otomatis diubah jadi `_`.
* Pesan tidak boleh **diawali** atau **diakhiri** variabel. Tulis *"Halo {{full\_name}}, ..."*, bukan *"{{full\_name}}, ..."*.
* Satu nama variabel hanya boleh dipakai **sekali** dalam satu template.
* Dua variabel tidak boleh **berdempetan**, misalnya `{{nama}}{{kode}}`.
* **Footer** tidak boleh berisi variabel.
* Setiap variabel wajib diberi contoh nilai (**Sample Content**) sebelum template diajukan.

## Bagian 1: Membuat template dengan variabel

{% stepper %}
{% step %}

### Buka Templates, lalu klik New Template

Di menu samping, klik **Templates** di bagian **WABA OFFICIAL**, lalu klik **New Template**. Isi **Template Name**, **Category**, dan **Language** seperti biasa. Panduan lengkapnya ada di [Cara Membuat Template WABA Official](https://docs.watzap.id/help/waba-official/cara-membuat-template-waba-official.md).

![Menu WABA OFFICIAL → Templates](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FZtLrckemkaBjems0z8k9%2FA7-01-menu.png?alt=media)
{% endstep %}

{% step %}

### Tulis pesan, lalu klik Variable

Di kotak **Content Message**, tulis pesan Kamu. Saat kursor ada di posisi yang ingin diisi data kontak:

1. Klik **Variable** di toolbar.

![Tombol Variable di toolbar Content Message](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FPqNA36b82t3KfbszwOGG%2FA7-02-tombol-variable.png?alt=media)
{% endstep %}

{% step %}

### Pilih variabel

Jendela **Select Variable** terbuka. Daftarnya diambil dari nama kolom di semua list kontak Kamu, lengkap dengan contoh nilainya.

1. **Search variables**: ketik untuk mencari variabel.
2. Klik variabel yang diinginkan, misalnya **full\_name**. Variabel langsung tersisip di posisi kursor sebagai `{{full_name}}`.
3. Jumlah variabel yang tersedia.

![Jendela Select Variable](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fl0YwwWxBqKZFVBXNZkL9%2FA7-03-select-variable.png?alt=media)

{% hint style="info" %}
Variabel juga bisa diketik manual, misalnya `{{diskon}}`. Pastikan namanya mudah dikenali, karena nanti Kamu memasangkannya dengan kolom list.
{% endhint %}
{% endstep %}

{% step %}

### Isi Sample Content

Setelah variabel ada di pesan, muncul bagian **Detected Variables (Auto Detect)**.

1. Variabel tampil sebagai label berwarna di dalam pesan.
2. Isi kolom **Sample Content** di sebelah setiap variabel dengan contoh nilai, misalnya `Budi` untuk `{{full_name}}` dan `25%` untuk `{{diskon}}`. Contoh ini membantu Meta meninjau template.

![Detected Variables dan Sample Content](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FXRmU1LKD5sbbhgcavVx0%2FA7-04-detected-variables.png?alt=media)

Pratinjau ponsel langsung menampilkan pesan dengan contoh nilai tersebut:

![Pratinjau pesan dengan contoh nilai variabel](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fqixr0r9t9oQD3AP06uuK%2FA7-05-preview.png?alt=media)

Variabel di link tombol **Visit website** bertipe **Dynamic** juga ikut muncul di bagian ini.
{% endstep %}

{% step %}

### Simpan dan ajukan template

Klik **Save as Draft** untuk menyimpan, atau **Save & Submit** untuk mengajukannya ke Meta. Tunggu sampai statusnya **Approved** di halaman **Templates**. Hanya template Approved yang bisa dipakai untuk broadcast.
{% endstep %}
{% endstepper %}

## Bagian 2: Kirim broadcast dengan variabel

{% stepper %}
{% step %}

### Buat broadcast baru dan pilih template

Buka menu **Broadcasts** di bagian **WABA OFFICIAL**, klik **New Broadcast**, lalu klik **Select Template** di kartu **Broadcast content**. Di jendela **Choose a template**:

1. Klik template yang berisi variabel. Pratinjaunya tampil di sebelah kanan.
2. Klik **Choose Template**.

![Memilih template di jendela Choose a template](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FVFgcYo0rwtaSUWuYmnOX%2FA7-06-pilih-template.png?alt=media)

Langkah dasar membuat broadcast ada di [Cara Kirim Broadcast WABA Official](https://docs.watzap.id/help/waba-official/cara-kirim-broadcast-waba-official.md).
{% endstep %}

{% step %}

### Lihat Detected Variables

Setelah template dipilih:

1. **Content Message** menampilkan isi template, lengkap dengan variabelnya (tidak bisa diubah di sini).
2. **Detected Variables (Auto Detect)** menampilkan setiap variabel beserta kolom pilihan di sebelahnya. Selama belum ada list yang dipilih, kolom itu bertuliskan **You must select list first**.
3. Catatan pengingat untuk memilih list terlebih dahulu.

![Detected Variables sebelum list dipilih](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FbgKzubtVr72wqff1DZPH%2FA7-07-detected-composer.png?alt=media)
{% endstep %}

{% step %}

### Pilih list kontak

Gulir ke kartu **Who is your audience?**:

1. Centang list kontak tujuan. Gunakan kolom **Search** untuk mencari list.

![Memilih list di kartu Who is your audience?](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F6IS3Wy5Kulrl8DPdbmhh%2FA7-08-pilih-list.png?alt=media)
{% endstep %}

{% step %}

### Petakan variabel ke kolom list

Kembali ke **Detected Variables**. Klik kolom di sebelah variabel (sekarang bertuliskan **Choose field**), lalu pilih kolom list yang datanya ingin dipakai. Pilihan kolomnya berasal dari list yang Kamu centang.

![Pilihan kolom dari list yang dicentang](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FNICn8SPhi9wvzUcRNUit%2FA7-09-mapping-dropdown.png?alt=media)

1. Contoh: variabel `{{full_name}}` dipetakan ke kolom **Full Name**.

![Variabel sudah dipetakan ke kolom Full Name](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fc1nKP7VVWL2WWQgTrdUL%2FA7-10-mapping-selesai.png?alt=media)

Ulangi untuk setiap variabel. Saat broadcast dikirim, `{{full_name}}` di pesan setiap penerima diganti dengan isi kolom **Full Name** milik kontak tersebut.
{% endstep %}

{% step %}

### Lanjutkan pengiriman

Periksa lagi pengaturan broadcast, lalu kirim sekarang atau jadwalkan. Panduannya: [Cara Kirim Broadcast WABA Official](https://docs.watzap.id/help/waba-official/cara-kirim-broadcast-waba-official.md) dan [Cara Schedule Broadcast WABA Official](https://docs.watzap.id/help/waba-official/cara-kirim-broadcast-waba-official/cara-schedule-broadcast-waba-official.md).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Pastikan kolom yang dipetakan terisi untuk semua kontak. Kalau kolomnya kosong pada seorang kontak, WatZap mengisi variabel itu dengan nilai pengganti (misalnya nama atau nomor kontak, contoh nilai template, atau tanda `-`), sehingga pesannya bisa terbaca janggal.
{% endhint %}

## Masalah umum

<details>

<summary>Variabel yang dicari tidak ada di jendela Select Variable</summary>

Daftar variabel diambil dari nama kolom di list kontak Kamu. Tambahkan kolomnya dulu di list (lihat [Penjelasan Fitur "Column" di List](https://docs.watzap.id/help/list/penjelasan-fitur-column-di-list.md)), atau ketik variabelnya manual dengan format `{{nama_variabel}}`.

</details>

<details>

<summary>Muncul peringatan saat Save &#x26; Submit template</summary>

* **Invalid Template Format**: pesan diawali atau diakhiri variabel. Tambahkan teks sebelum dan sesudahnya.
* **Duplicate Variable Detected**: nama variabel yang sama dipakai lebih dari sekali.
* **Adjacent Variables Not Allowed**: dua variabel berdempetan tanpa teks di antaranya.
* **Please fill in the example value for parameter: {{...}}**: **Sample Content** variabel tersebut masih kosong.
* **Footer Cannot Contain Variables**: pindahkan variabel dari footer ke isi pesan.

</details>

<details>

<summary>Kolom di Detected Variables masih "You must select list first"</summary>

Centang minimal satu list di kartu **Who is your audience?**. Setelah itu kolomnya berubah menjadi **Choose field** dan berisi daftar kolom list.

</details>

<details>

<summary>Muncul pesan "We detected contact variables (...) that don't match the template"</summary>

List yang dicentang punya kolom yang namanya tidak cocok dengan variabel mana pun di template. Broadcast tetap bisa dikirim. Pastikan saja setiap variabel di **Detected Variables** sudah dipetakan ke kolom yang benar.

</details>
