> 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/toolkit/membuat-live-chat-widget.md).

# Cara Membuat WhatsApp Chat Button untuk Website

Pasang tombol chat di pojok website. Pengunjung klik, pilih customer service, lalu langsung lanjut ngobrol di WhatsApp tim Kamu.

**WhatsApp Chat Button** adalah tombol chat yang menempel di pojok bawah website Kamu. Saat diklik, pengunjung melihat daftar operator/CS Kamu, memilih salah satu, lalu langsung diarahkan ke WhatsApp operator tersebut, lengkap dengan pesan pembuka.

{% hint style="info" %}
Fitur ini dulu bernama **Live Chat (Widget)**. Fungsinya sama, hanya nama dan tampilan editornya yang baru. Ingin chat dari website masuk ke satu Kotak Masuk dan dibalas bersama tim? Itu fitur lain: [Live Chat di WatZap.chat](https://docs.watzap.id/help/watzap.chat/penjelasan-fitur-live-chat.md).
{% endhint %}

## Video Tutorial

{% embed url="<https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FgQr7TGJ3cfWsIK2a3bpI%2Ftutorial-whatsapp-chat-button-v4.mp4?alt=media>" %}
Video: Cara Membuat WhatsApp Chat Button (±3 menit)
{% endembed %}

## Hasil akhirnya

Begini tampilan tombolnya di website. Setelah diklik, muncul jendela kecil berisi operator yang bisa dihubungi.

![Tombol WhatsApp Chat Button di pojok kanan bawah website](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FL0ega8puDkV6BnHflg4G%2Fwcb-14-site-button.png?alt=media)

![Jendela chat terbuka: pengunjung memilih operator](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FkBpIpfG7B1mjICorKWZS%2Fwcb-15-site-chat-open.png?alt=media)

## Sebelum mulai

Siapkan tiga hal ini dulu:

1. **Minimal satu operator.** Operator adalah nomor WhatsApp tim Kamu yang menerima chat. Belum punya? Buat dulu lewat panduan [Menambahkan Operator Baru](https://docs.watzap.id/help/toolkit/menambahkan-operator-baru.md).
2. **Alamat website** yang diawali `https://`, misalnya `https://tokocontoh.com`.
3. **Akses untuk memasang kode** di website Kamu (file tema, plugin header & footer, atau plugin WatZap untuk WordPress).

Jumlah tombol dan operator per tombol mengikuti paket Kamu:

| Paket    | Jumlah tombol | Operator per tombol | Meta Conversion API | Google Tag Manager |
| -------- | ------------- | ------------------- | ------------------- | ------------------ |
| Free     | 1             | 2                   | –                   | –                  |
| Lite     | 5             | 4                   | ✅                   | –                  |
| Pro      | 15            | 6                   | ✅                   | ✅                  |
| Business | 30            | 10                  | ✅                   | ✅                  |

## Langkah membuat tombol

{% stepper %}
{% step %}

### Buka menu WhatsApp Chat Button

Di dashboard WatZap, gulir menu samping ke bagian **Toolkit**, lalu klik **WhatsApp Chat Button**.

![Menu Toolkit → WhatsApp Chat Button](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F4sfXBkjZAwRmNMALkbAF%2Fwcb-01-menu.png?alt=media)
{% endstep %}

{% step %}

### Klik New Button

Di halaman daftar tombol, klik **New Button** di kanan atas. Angka di sebelahnya (misalnya `0 / 30 Buttons`) menunjukkan jumlah tombol yang sudah dibuat dari jatah paket Kamu.

![Klik New Button](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FJGrrl97OESEk4RVemLe6%2Fwcb-02-new-button.png?alt=media)

Halaman editor **Create a new button** terbuka. Kolom kiri berisi kartu **Operators**, **Content & behaviour**, **Appearance**, dan **Tracking**. Kolom kanan berisi **Publishing** dan **Preview**, yang menampilkan tombol Kamu secara langsung selama Kamu mengisi form.

![Tampilan editor Create a new button](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2F4iNmXSMF5zUBZMDHBNPm%2Fwcb3-03-editor.png?alt=media)
{% endstep %}

{% step %}

### Pilih operator dan atur Priority

Di kartu **Operators**, klik kolom **Operator**, lalu pilih operator dari daftar.

![Daftar operator terbuka](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FreKtbTKK8sciD0PqSkxy%2Fwcb2-04a-operator-dropdown.png?alt=media)

1. **Operator**: operator yang tampil di jendela chat.
2. **Priority**: angka **lebih kecil tampil lebih dulu** (1–10). Beri angka yang sama bila semua operator setara.
3. **Add operator**: menambah baris operator lain. Tombol ini nonaktif kalau batas operator paket Kamu sudah tercapai, atau semua operator sudah ditambahkan. Ikon tempat sampah menghapus barisnya.

![Kartu Operators: pilih operator, Priority, dan Add operator](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fyj32zSyg7Iz5XF5Gcmcc%2Fwcb2-04-operators.png?alt=media)

{% hint style="info" %}
Pesan pembuka (*greeting*) diatur di masing-masing operator, bukan di tombol. Ubah lewat menu **Operator**.
{% endhint %}
{% endstep %}

{% step %}

### Isi Site URL, judul, dan deskripsi

Di kartu **Content & behaviour**:

1. **Site URL** (wajib): alamat website tempat tombol dipasang, diawali `https://`. Cukup tulis domainnya. Kalau Kamu menempel alamat halaman lengkap, hanya bagian domainnya yang disimpan.
2. **Button title**: tulisan yang tampil di tombol, maksimal 50 karakter. Contoh: *Butuh bantuan? Chat kami yuk!*
3. **Button description**: kalimat di bagian atas jendela chat, maksimal 50 karakter. Contoh: *Tim kami siap bantu. Klik untuk mulai chat.*

![Site URL, Button title, dan Button description](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fy0Bx1NF6bnrDwqAwgYLb%2Fwcb2-05-site-url.png?alt=media)

{% hint style="warning" %}
**Site URL harus sama persis dengan alamat website**, termasuk `www` kalau ada. Tombol untuk `https://tokocontoh.com` tidak akan tampil di `https://www.tokocontoh.com`. Satu alamat website hanya bisa dipakai untuk satu tombol.
{% endhint %}
{% endstep %}

{% step %}

### Pilih yang terjadi saat tombol diklik

Di **When visitors click**, pilih salah satu:

| Pilihan    | Yang terjadi                                                                                                                                    |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Direct** | Pengunjung memilih operator, lalu WhatsApp langsung terbuka dengan pesan pembuka operator. Paling cepat.                                        |
| **Reply**  | Pesan pembuka operator tampil dulu di jendela chat. Pengunjung mengetik balasan, lalu WhatsApp terbuka dengan pesan itu. Terasa lebih personal. |

![Pilihan Direct dan Reply](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FRtacx4X0Vuqz6l7lgnC4%2Fwcb2-06-mode.png?alt=media)
{% endstep %}

{% step %}

### Atur kapan tombol muncul

Di **Show the button**, pilih:

* **Right away**: tombol langsung muncul saat halaman dibuka.
* **After a delay**: tombol muncul setelah jeda, misalnya `3` detik.
* **After scrolling**: tombol muncul setelah pengunjung menggulir halaman sekian persen, misalnya `50` %.

![Show the button: After a delay 3 detik](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FZ9I69nnJmobT9zm8xFnb%2Fwcb2-07-show-button.png?alt=media)
{% endstep %}

{% step %}

### Atur tampilan tombol

Di kartu **Appearance**:

1. **Style**: pilih **Label + icon**, **Rounded**, atau **Icon only**. Untuk Icon only, centang **Show the title next to the icon** bila judul ingin tetap tampil.
2. **Position**: **Bottom left** (kiri bawah) atau **Bottom right** (kanan bawah).
3. **Button colour**: klik kotak warna atau ketik kode warna, misalnya `#0DC152`.
4. **Text colour**: warna tulisan di tombol, misalnya `#fff` untuk putih.

![Kartu Appearance](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FJdR48oyZR5MJYH4uKB7V%2Fwcb2-08-appearance.png?alt=media)

Setiap perubahan langsung terlihat di kartu **Preview** di sebelah kanan. Contohnya saat memilih **Icon only**:

![Pilihan Icon only langsung terlihat di Preview](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FwfLvu6BQK7WoW3AuUov5%2Fwcb3-10d-preview-iconly.png?alt=media)

Perbandingan gaya tombol di website:

![Perbandingan Label + icon, Rounded, dan Icon only](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FnnjYoaKj4onomXCCjLt6%2Fwcb-08b-styles.png?alt=media)
{% endstep %}

{% step %}

### Tracking (opsional)

Kartu **Tracking** boleh dilewati.

* **Meta Conversion API trigger**: klik kolomnya, lalu pilih trigger yang sudah Kamu buat di menu **Meta Conversion API**. Event dikirim setiap kali tombol tampil di halaman. Tersedia mulai paket **Lite**.
* **Google Tag Manager ID**: isi ID container, misalnya `GTM-XXXXXXX`. GTM berjalan di halaman pengalih sebelum WhatsApp terbuka. Tersedia mulai paket **Pro**.

![Kartu Tracking](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FVYzldLJ5QpcujVqh6bXi%2Fwcb2-09-tracking.png?alt=media)

Kalau paket Kamu belum mendukung, kolomnya terkunci dan ada tombol **Upgrade**.
{% endstep %}

{% step %}

### Atur Publishing

Di kartu **Publishing** (kolom kanan):

1. **Status**: biarkan sakelar menyala di **Published** agar tombol tampil di website setelah kodenya dipasang. Matikan sakelar untuk menyimpannya sebagai **Draft** (tidak tampil).
2. **Show on**: **All devices**, **Desktop** saja, atau **Mobile** saja.
3. **Open WhatsApp in a new tab**: centang agar WhatsApp terbuka di tab baru dan website Kamu tetap terbuka.

![Kartu Publishing](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FDrlTAP9fupAqKhRFbcaR%2Fwcb2-10-publishing.png?alt=media)
{% endstep %}

{% step %}

### Cek tampilan di Preview

Kartu **Preview** menampilkan tombol di situs tiruan dengan alamat dari Site URL, dengan ukuran yang sama seperti di website. Pakai tab di kanan atas kartu untuk berpindah tampilan:

* **Button**: tombol saat belum diklik.
* **Chat open**: jendela chat yang terbuka setelah tombol diklik.

![Preview tab Button](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FrgEOasehCCajwIl0kuW3%2Fwcb3-10b-preview-button.png?alt=media)

![Preview tab Chat open](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FNRGuL4ZUoS9bQNQKpLRG%2Fwcb3-10c-preview-chat.png?alt=media)

{% hint style="info" %}
Preview memakai operator yang Kamu pilih. Di website sungguhan, operator yang sedang di luar jadwal kerjanya disembunyikan. Di layar kecil atau ponsel, buka Preview lewat tombol **Preview** di bagian atas editor.
{% endhint %}
{% endstep %}

{% step %}

### Simpan dan salin kode pemasangan

Klik **Save** di kanan atas.

![Klik Save](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FYdzibu6MSRbyDz4366QX%2Fwcb2-11-save.png?alt=media)

Muncul notifikasi **Button saved** dan halaman berganti ke **Edit button**. Di paling atas ada kartu **Install on your site** berisi kode pemasangan.

![Button saved dan kartu Install on your site](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FWoBogbyNxTnwHn3Vxfz8%2Fwcb2-12a-button-saved.png?alt=media)

Klik **Copy code** untuk menyalin kodenya.

![Kode pemasangan dan tombol Copy code](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FKQcjh1iFGKTZw9FFrzNb%2Fwcb2-12-install-code.png?alt=media)

Tombolnya berubah menjadi **Copied** tanda kode sudah tersalin.

![Kode tersalin](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FdDDGq6eMLngjmhcPtS1F%2Fwcb2-12b-code-copied.png?alt=media)

Tempel kode itu di dalam `<head>`, atau tepat sebelum `</body>`, **di setiap halaman** website Kamu. Kodenya seperti ini:

```html
<script async data-watzapkey="KODE-KAMU" src="https://cdn.watzap.id/widget-api.js"></script>
```

Panduan memasang lewat WordPress (plugin Insert Headers and Footers atau plugin WatZap): [Memasang WhatsApp Chat Button ke Website](https://docs.watzap.id/help/toolkit/memasang-live-chat-widget-ke-website.md).

{% hint style="info" %}
Kartu **Install on your site** hanya muncul bila status tombol **Published**. Kalau masih Draft, yang tampil adalah info *This button is a draft*.
{% endhint %}
{% endstep %}
{% endstepper %}

## Coba di website

Buka website Kamu (muat ulang halamannya). Inilah yang dialami pengunjung:

1. Tombol muncul di pojok sesuai pengaturan **Show the button**.
2. Pengunjung klik tombol, lalu memilih operator.
3. Pada mode **Reply**, pesan pembuka operator tampil dan pengunjung mengetik balasan.
4. Setelah pesan dikirim, WhatsApp operator terbuka dengan pesan tersebut.

{% columns %}
{% column %}
![Pesan pembuka dari operator](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FBwr0t3Oij55wi96jvyEH%2Fwcb-16-site-intro.png?alt=media)
{% endcolumn %}

{% column %}
![Pengunjung mengetik balasan](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FP3s3wANcWnO6VgYANAvi%2Fwcb-17-site-reply.png?alt=media)
{% endcolumn %}
{% endcolumns %}

Di ponsel, jendela chat terbuka penuh layar:

![Tampilan di ponsel](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FhhgdY51NP6lWhmFSJhtq%2Fwcb-18-mobile.png?alt=media)

## Mengubah atau menghapus tombol

Semua tombol tampil di halaman **WhatsApp Chat Button** beserta jumlah operator, perangkat (**Show Button**), tanggal diubah, dan status.

![Daftar WhatsApp Chat Button](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FVBXLwroFlrkPqs2jBqIX%2Fwcb2-13-list.png?alt=media)

Klik ikon titik tiga **⋮** di baris tombol, lalu pilih **Edit** untuk mengubah pengaturan atau melihat kode pemasangan lagi, atau **Delete** untuk menghapusnya. Hapus banyak tombol sekaligus lewat kotak centang + **Bulk Action**.

![Menu Edit dan Delete](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FNLpfPU3fsiN65xwINf4Y%2Fwcb2-13b-list-menu.png?alt=media)

## Tombol belum muncul? Cek ini

<details>

<summary>Status masih Draft</summary>

Buka tombolnya lewat **⋮ → Edit**, nyalakan sakelar **Status** hingga tertulis **Published**, lalu klik **Save**.

</details>

<details>

<summary>Site URL tidak sama persis dengan alamat website</summary>

Bandingkan isi **Site URL** dengan alamat di browser, termasuk `https://` dan `www`. `https://tokocontoh.com` dan `https://www.tokocontoh.com` dianggap berbeda.

</details>

<details>

<summary>Tidak ada operator yang sedang online</summary>

Operator yang memakai jadwal kerja (**Scheduling**) hanya tampil pada jam kerjanya. Kalau semua operator di tombol sedang di luar jadwal, tombol tidak ditampilkan sama sekali. Cek jadwalnya di menu **Operator**.

</details>

<details>

<summary>Perangkat atau waktu tampil</summary>

Cek **Show on**: tombol untuk **Desktop** tidak muncul di ponsel, dan sebaliknya. Cek juga **Show the button**: dengan **After a delay** atau **After scrolling**, tombol baru muncul setelah jeda atau setelah halaman digulir.

</details>

<details>

<summary>Kode belum terpasang di semua halaman, atau masa aktif paket habis</summary>

Pastikan kode ada di setiap halaman, lalu muat ulang tanpa cache. Tombol juga tidak tampil bila masa aktif paket WatZap Kamu sudah berakhir. Perpanjang paket di menu **Plan**.

</details>

<details>

<summary>Muncul pesan "Domain ... is already used"</summary>

Alamat website itu sudah dipakai tombol lain. Satu alamat hanya bisa punya satu tombol. Edit tombol yang sudah ada, atau hapus dulu tombol lamanya.

</details>
