# Pustaka Variabel Template

Pustaka Variabel adalah daftar variabel yang dapat dipakai ulang di banyak template WhatsApp, misalnya "Nama Pelanggan" atau "Link Tracking". Satu variabel di pustaka dipetakan ke posisi variabel pada isi template, sehingga pratinjau dan pengiriman template memakai nilai yang konsisten.

## Sebelum mulai

- Pahami dulu cara membuat template di [Template](/fitur-utama/template).
- Pustaka milik bisnis Anda sendiri. Bisnis lain tidak melihat variabel Anda.
- Saat ini halaman Template belum menampilkan layar untuk mengelola pustaka (membuat, mengubah, atau menghapus variabel). Pembuatan variabel dilakukan oleh tim teknis Anda lewat API tumbuh.ai. Bagian "Isi pustaka" di bawah menjelaskan data yang tersimpan, supaya Anda tahu apa yang muncul di drawer template.

## Isi pustaka

Setiap variabel di pustaka punya:

| Kolom | Keterangan |
| --- | --- |
| Nama Variabel | Nama unik, maksimal 100 karakter. Nama yang sama tidak dapat dipakai dua kali. |
| Tipe | Teks, URL, Mata Uang, Tanggal, Gambar, Video, atau Dokumen. |
| Deskripsi | Opsional, maksimal 500 karakter. Menjelaskan untuk apa variabel dipakai. |
| Contoh Nilai | Opsional. Dipakai untuk pratinjau template. |
| Jumlah Penggunaan | Seberapa sering variabel dipakai. |

### Aturan contoh nilai per tipe

- **Teks:** teks bebas.
- **URL:** harus diawali `http://` atau `https://`.
- **Mata Uang:** angka saja, atau kode mata uang tiga huruf lalu angka, misalnya `IDR 100,000`.
- **Tanggal:** format `YYYY-MM-DD` atau `DD/MM/YYYY`.
- **Gambar, Video, Dokumen:** URL HTTPS, atau ID media WhatsApp.

## Memakai variabel di template

1. Buka **Template**, lalu klik **Buat Template** (atau edit template).
2. Di bagian **Isi Pesan**, klik **Sisipkan Variabel**.
3. Ketik di kolom "Cari variabel..." untuk mencari berdasarkan nama. Setiap baris menampilkan lencana tipe, nama, dan contoh nilainya.
4. Pilih variabel. Posisi berikutnya, misalnya `{{1}}`, `{{2}}`, disisipkan di isi pesan di tempat kursor.
5. Bagian **Pemetaan Variabel** menampilkan variabel mana yang terpasang di posisi mana. Pratinjau memakai contoh nilai variabel itu.
6. Simpan template. Pemetaan tersimpan bersama template.

Bila pustaka kosong, pencarian menampilkan "Variabel tidak ditemukan. Buat di Pustaka Variabel." Anda tetap dapat mengetik `{{1}}`, `{{2}}` sendiri lalu mengisi **Contoh Variabel** untuk tiap posisi.

Aturan Meta tetap berlaku: variabel harus berurutan tanpa lompatan, dan tidak boleh berada di awal atau akhir pesan.

## Pemetaan saat mengirim template

Saat Anda mengirim template ke satu pelanggan dari [OneInbox](/fitur-utama/oneinbox), dialog **Kirim Pesan Template** membaca pemetaan template itu. Bagian **Isi Variabel** menampilkan isian per posisi sesuai tipe variabel, dan pesan akan ditolak bila nilai kosong atau formatnya salah (misalnya URL tidak valid).

Bila template belum punya pemetaan, dialog menampilkan "Pemetaan variabel belum dikonfigurasi" dan tombol kirim tidak aktif. Buat pemetaan lewat **Sisipkan Variabel** saat membuat atau mengedit template.

## Mengubah dan menghapus variabel

- Mengubah nama, tipe, deskripsi, atau contoh nilai dilakukan lewat API oleh tim teknis. Nama baru tidak boleh sama dengan variabel lain.
- Menghapus variabel ikut menghapus pemetaannya di semua template. Setelah itu Anda perlu memetakan ulang template tersebut sebelum mengirimnya.

Periksa dulu template mana yang memakai variabel (kolom Jumlah Penggunaan) sebelum menghapusnya.

## Hubungannya dengan Broadcast

[Broadcast](/fitur-utama/broadcast) mengisi variabel template dengan caranya sendiri: nilai manual, kolom CSV, atau field pelanggan lewat **Sisipkan Field**. Pustaka Variabel dipakai di sisi template, bukan sebagai sumber nilai per penerima.

## Hasil yang diharapkan

- Variabel muncul di pencarian **Sisipkan Variabel** dengan tipe dan contohnya.
- Template yang tersimpan memiliki pemetaan sehingga pesan template bisa dikirim dari OneInbox.

## Masalah umum

- **"Variabel tidak ditemukan".** Pustaka belum berisi variabel. Minta tim teknis membuatnya.
- **"Variabel dengan nama ini sudah ada".** Nama harus unik, gunakan nama lain.
- **Tombol kirim tidak aktif di dialog template.** Template belum dipetakan atau ada isian yang kosong.