> 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/broadcast-unofficial/penjelasan-fitur-variable.md).

# Penjelasan Fitur Variable

Panggil data kontak, seperti nama atau kota, ke dalam pesan broadcast WhatsApp lewat Choose Variable, supaya setiap pesan terasa personal.

**Variable** memanggil data kontak dari kolom list ke dalam pesan broadcast. Dengan variable, satu pesan bisa terkirim dengan nama, kota, nomor tagihan, atau data lain milik setiap penerima.

Contohnya, pesan `Halo [Full Name], ada promo ongkir gratis khusus pelanggan di [Kota] minggu ini.` akan diterima kontak **Rudi Contoh** dari **Bandung** sebagai *Halo Rudi Contoh, ada promo ongkir gratis khusus pelanggan di Bandung minggu ini.*

## Sebelum mulai

Variable diambil dari kolom list penerima. Pastikan list sudah berisi kolom dan datanya, misalnya **Full Name** dan **Kota**.

* Cara menambah kolom sendiri ada di [Penjelasan Fitur “Column” di List](https://docs.watzap.id/help/list/penjelasan-fitur-column-di-list.md).
* Kolom bisa diisi lewat [Import Kontak Secara Manual](https://docs.watzap.id/help/list/import-kontak-secara-manual.md) atau [Import Kontak dari File EXCEL/CSV/TXT](https://docs.watzap.id/help/list/import-kontak-dari-file-excel-csv-txt.md).

## Langkah memakai variable

{% stepper %}
{% step %}

### Pilih list di langkah Recipients

Buat broadcast seperti biasa (lihat [Cara Membuat Broadcast WhatsApp](https://docs.watzap.id/help/broadcast-unofficial/cara-membuat-broadcast-whatsapp.md)). Di langkah **Recipients**, centang list yang punya kolom yang ingin dipanggil, lalu klik **Next**.
{% endstep %}

{% step %}

### Buka Choose Variable

Di langkah **Content**:

1. Klik **Choose Variable** di toolbar editor pesan.
2. Daftar kolom muncul, misalnya **WhatsApp Number**, **Full Name**, dan **Kota**.

![Daftar Choose Variable](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fq074NXTNXouxxers4ZkD%2FJ1-09-choose-variable.png?alt=media)

Daftar ini berisi semua kolom dari list yang dipilih di langkah Recipients, kecuali **Last Modified**.
{% endstep %}

{% step %}

### Sisipkan variable ke pesan

Klik nama kolom. Variable seperti `[Full Name]` masuk ke posisi kursor di kotak pesan.

1. Lanjutkan menulis pesan. Kamu bisa memakai beberapa variable dalam satu pesan, misalnya `[Full Name]` dan `[Kota]`.

![Variable \[Full Name\] dan \[Kota\] di kotak pesan](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fe9gTgON0Jf1CQmISlsiF%2FJ1-10-variable-di-pesan.png?alt=media)

Variable juga bisa diketik manual, asalkan tulisannya sama persis dengan nama kolom, termasuk huruf besar-kecil dan spasi, lalu diapit kurung siku.
{% endstep %}

{% step %}

### Cek di langkah Preview

Klik **Next**.

1. Pratinjau pesan masih menampilkan nama variable, misalnya `[Full Name]` dan `[Kota]`. Variable baru diganti dengan data setiap kontak saat broadcast dikirim.

![Pratinjau pesan dengan variable](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FY2nfrpBoUPkNchsZoWzX%2FJ1-11-preview-variable.png?alt=media)

Contoh hasilnya:

| Kontak           | Kota     | Pesan yang diterima                                                                |
| ---------------- | -------- | ---------------------------------------------------------------------------------- |
| Rudi Contoh      | Bandung  | Halo Rudi Contoh, ada promo ongkir gratis khusus pelanggan di Bandung minggu ini.  |
| Sari Contoh      | Surabaya | Halo Sari Contoh, ada promo ongkir gratis khusus pelanggan di Surabaya minggu ini. |
| {% endstep %}    |          |                                                                                    |
| {% endstepper %} |          |                                                                                    |

{% hint style="info" %}
**Aturan penggantian variable:**

* Nama variable harus sama persis dengan nama kolom. Kalau kolomnya **Kota**, tulisan `[kota]` tidak akan diganti.
* Kalau isi kolom untuk kontak tertentu kosong, variable diganti dengan teks kosong.
* Kontak dari list yang tidak punya kolom tersebut menerima teks variable apa adanya, misalnya `[Kota]`.
* Variable bisa dipakai di setiap variasi pesan [A/B Testing](https://docs.watzap.id/help/broadcast-unofficial/penjelasan-fitur-a-b-testing.md) dan tetap utuh di variasi [Spintax Replacement](https://docs.watzap.id/help/broadcast-unofficial/penjelasan-fitur-spintax-replacement.md).
  {% endhint %}

{% hint style="info" %}
**Variable nama tambahan.** Selain kolom list, Kamu bisa mengetik manual (huruf kecil semua):

* `[fullname]`: nama lengkap kontak.
* `[firstname]`: kata pertama nama kontak, misalnya `Rudi`.
* `[lastname]`: kata terakhir nama kontak, misalnya `Contoh`.

Kalau nama kontak kosong, ketiga variable ini diganti dengan nomor WhatsApp kontak.
{% endhint %}

## Masalah umum

<details>

<summary>Daftar Choose Variable kosong</summary>

Belum ada list yang dipilih di langkah **Recipients**. Kembali ke langkah itu, centang list, lalu buka lagi **Choose Variable**.

</details>

<details>

<summary>Muncul pesan "Mixed Variable" saat memilih beberapa list</summary>

List yang dicentang punya susunan kolom berbeda (*We're detecting multiple variable between the lists. Do you want to continue?*). Pesan ini juga muncul kalau nama kolomnya sama tetapi urutannya berbeda.

1. **Cancel**: centang list yang susunan kolomnya berbeda dari list teratas yang dicentang dibatalkan. Periksa lagi list mana yang masih tercentang.
2. **Continue**: tetap memakai semua list. Kontak dari list yang tidak punya kolom tertentu akan menerima teks variable apa adanya, misalnya `[Kota]`.

![Pesan Mixed Variable](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FH2akf3zefsSQ0GC8ZI2v%2FJ1-12-mixed-variable.png?alt=media)

Supaya aman, pakai hanya variable yang ada di semua list yang dipilih.

</details>

<details>

<summary>Penerima menerima teks variable apa adanya, misalnya [Kota]</summary>

Kemungkinan list penerima tidak punya kolom tersebut, atau tulisan variable tidak sama persis dengan nama kolom. Sisipkan variable lewat **Choose Variable** supaya tulisannya pasti sesuai.

</details>

<details>

<summary>Nama penerima kosong di pesan yang terkirim</summary>

Kolom **Full Name** kontak itu kosong. Lengkapi datanya di list sebelum mengirim broadcast berikutnya.

</details>

## Video tutorial

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

Tampilan di video bisa sedikit berbeda dari tampilan terbaru.
