> 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/meta-conversion-api/cara-menambahkan-event-baru.md).

# Cara Menambahkan Event Baru

Buat event Meta Conversion API (misalnya Purchase atau Lead) di WatZap, lalu pakai di Link Generator, WhatsApp Chat Button, balasan otomatis, dan Smart Bot Action untuk melacak konversi di Meta Ads.

**Meta Conversion API** mengirim event konversi, seperti **Purchase** atau **Lead**, langsung dari server WatZap ke Meta Pixel Kamu. Hasilnya bisa Kamu pantau di Meta Events Manager dan dipakai untuk mengoptimalkan iklan di Facebook dan Instagram.

Event yang Kamu buat di sini bisa dipilih di fitur WatZap lain. Event dikirim ke Meta saat fitur tersebut berjalan, misalnya saat link dibuka atau tombol chat diklik:

* [WhatsApp Chat Button](https://docs.watzap.id/help/toolkit/membuat-live-chat-widget.md)
* [Link Generator / Rotator](https://docs.watzap.id/help/toolkit/menggunakan-link-generator-rotator.md)
* [Smart Bot Action](https://docs.watzap.id/help/auto-engage/cara-menggunakan-smart-bot-action.md)
* [Smart Auto Reply](https://docs.watzap.id/help/automation/penjelasan-tentang-smart-auto-reply.md), [Auto Reply Timer](https://docs.watzap.id/help/automation/cara-menggunakan-auto-reply-timer.md), dan [Text Replies](https://docs.watzap.id/help/automation/cara-membuat-text-replies.md)

## Sebelum mulai

Siapkan **Meta Pixel ID** dan **Conversion API Token** (Access Token) dari Meta Events Manager. Caranya: [Cara Mendapatkan Access Token & Pixel ID](https://docs.watzap.id/help/meta-conversion-api/cara-mendapatkan-access-token-and-pixel-id.md).

## Langkah menambahkan event

{% stepper %}
{% step %}

### Buka menu Meta Conversion API

Di menu samping, gulir ke bagian **INTEGRATIONS**, lalu klik **Meta Conversion API**.

![Menu INTEGRATIONS → Meta Conversion API](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2Fgkt0mTStkd69w7BwdOJo%2FF5-01-menu.png?alt=media)
{% endstep %}

{% step %}

### Klik New Event

Di bagian atas halaman:

1. **Jumlah event**: event yang sudah Kamu buat dari batas 20 event.
2. **Tutorial**: membuka panduan ini (**How-to-Guide**) atau gambar alur kerja fitur (**Flow Diagram**).
3. **New Event**: membuat event baru.

![Daftar event, Tutorial, dan tombol New Event](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FmAMxnrXNNXmcf6stQS0u%2FF5-02-header-daftar.png?alt=media)

Kalau belum punya event sama sekali, halaman ini menampilkan **Create Your First Meta Conversion Event!**. Klik **New Event** di tengah halaman.

![Halaman kosong Create Your First Meta Conversion Event!](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FSDZqWqJpGewdZYlc5Nl5%2FF5-03-kosong.png?alt=media)
{% endstep %}

{% step %}

### Isi Trigger Name, Meta Pixel ID, dan Conversion API Token

Jendela **Create New Event** terbuka.

1. **Trigger Name**: nama event ini di WatZap, maksimal 32 karakter. Nama inilah yang nanti Kamu pilih di fitur lain, jadi buat yang mudah dikenali, misalnya `Purchase Hoodie`.
2. **Meta Pixel ID**: ID Pixel dari Meta, berupa angka 12–20 digit.
3. **Conversion API Token**: token dari Events Manager, 150–250 karakter tanpa spasi.

![Trigger Name, Meta Pixel ID, dan Conversion API Token (token diburamkan)](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FR84cSq4A0sjwAcI1noek%2FF5-05-isi-kredensial.png?alt=media)

{% hint style="warning" %}
Conversion API Token memberi akses untuk mengirim event ke Pixel Kamu. Jangan bagikan ke orang lain.
{% endhint %}
{% endstep %}

{% step %}

### Pilih Event Name dan isi Product Information

1. **Event Name**: jenis aktivitas yang ingin dilacak. Pilihannya dijelaskan di tabel di bawah.
2. **Product Information (Optional)**: **Product Name** (maksimal 24 karakter), **Currency** (IDR, USD, SGD, MYR, dan lainnya), dan **Price** (angka saja). Kalau diisi, nama produk, harga sebagai nilai konversi, dan mata uangnya ikut terkirim bersama event.
3. **Validate Event**: memeriksa lalu menyimpan event (langkah berikutnya).

![Event Name, Product Information, dan tombol Validate Event](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FwmoOXDdEYiGKQvO57oQf%2FF5-06-event-produk.png?alt=media)

| Event Name                       | Kapan dipakai                                                      |
| -------------------------------- | ------------------------------------------------------------------ |
| **Page View**                    | Seseorang membuka halaman.                                         |
| **Lead**                         | Seseorang menunjukkan minat, misalnya mengisi formulir kontak.     |
| **Add to Cart**                  | Produk dimasukkan ke keranjang.                                    |
| **Add Payment Info**             | Pelanggan memasukkan informasi pembayaran.                         |
| **Initiate Checkout**            | Pelanggan mulai proses checkout.                                   |
| **Purchase**                     | Pelanggan menyelesaikan pembelian.                                 |
| **Complete Registration**        | Pelanggan menyelesaikan pendaftaran akun atau layanan.             |
| **Contact**                      | Pelanggan menghubungi bisnis, misalnya lewat WhatsApp.             |
| **Add to Wishlist**              | Produk ditambahkan ke wishlist.                                    |
| **Customize Product**            | Pelanggan menyesuaikan produk, misalnya memilih warna atau ukuran. |
| **Donate**                       | Pelanggan berdonasi.                                               |
| **Find Location / Ask Location** | Pelanggan mencari atau menanyakan lokasi bisnis.                   |
| **Schedule**                     | Pelanggan membuat janji atau jadwal.                               |
| **Search**                       | Pelanggan melakukan pencarian.                                     |
| **Start Trial**                  | Pelanggan memulai masa uji coba.                                   |
| **Submit Data**                  | Pelanggan mengirim data, misalnya formulir atau survei.            |
| **Subscribe**                    | Pelanggan berlangganan layanan atau newsletter.                    |
| {% endstep %}                    |                                                                    |

{% step %}

### Klik Validate Event

Klik **Validate Event**. Tombolnya berubah menjadi **Validating...** lalu **Saving...**.

WatZap mengirim satu event uji ke Pixel Kamu untuk memastikan **Meta Pixel ID** dan **Conversion API Token** valid. Karena itu, wajar kalau satu event ini muncul di Events Manager.

* **Valid**: muncul notifikasi **Success!**. Klik **OK**, event baru tampil di daftar.
* **Tidak valid**: muncul **Something went wrong!** dengan pesan *Unable to validate Pixel ID or API Token with Meta Ads*, dan event tidak disimpan. Cek lagi Pixel ID dan token Kamu.

![Pesan Unable to validate Pixel ID or API Token with Meta Ads](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FLDbbhQAoG3unLVtvC5Nf%2FF5-07-gagal.png?alt=media)

Event yang berhasil disimpan tampil di daftar dengan kolom **Trigger Name**, **Pixel ID**, **Event Name**, dan **Product**.

![Event baru di daftar Meta Conversion API (Pixel ID diburamkan)](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FO9ppgRQHRJL2saXao68b%2FF5-09-daftar.png?alt=media)
{% endstep %}

{% step %}

### Pakai event di fitur lain

Buka fitur yang ingin dilacak, misalnya [Link Generator / Rotator](https://docs.watzap.id/help/toolkit/menggunakan-link-generator-rotator.md), lalu pilih **Trigger Name** event ini di bagian Meta Conversion API atau Meta Pixel Event fitur tersebut.
{% endstep %}
{% endstepper %}

## Mengubah atau menghapus event

Klik ikon **⋮** di ujung kanan baris event:

1. **Edit**: membuka jendela **Edit Event**. Ubah datanya, lalu klik **Validate Event** lagi untuk memeriksa dan menyimpan.
2. **Delete**: menghapus event.

![Menu ⋮ berisi Edit dan Delete](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FmHlfOcFx9ALpaIFT3Yyr%2FF5-10-menu-aksi.png?alt=media)

Saat menghapus, muncul konfirmasi **Are you sure?**. Klik **Delete** untuk menghapus permanen.

![Konfirmasi hapus event](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FOhmcNn2IKz8lupzULk1a%2FF5-11-hapus.png?alt=media)

Untuk menghapus beberapa event sekaligus, centang event-event tersebut, lalu pilih **Bulk Action → Delete** di kiri bawah.

{% hint style="info" %}
Sebelum menghapus, pastikan event tidak sedang dipakai di Link Generator, WhatsApp Chat Button, atau fitur lain, supaya pelacakan konversinya tidak terputus.
{% endhint %}

## Masalah umum

<details>

<summary>Muncul tulisan merah di bawah kolom saat klik Validate Event</summary>

Ada kolom wajib yang masih kosong: **Trigger Name**, **Meta Pixel ID**, **Conversion API Token**, dan **Event Name**. Lengkapi kolom yang ditandai, lalu klik **Validate Event** lagi.

![Pesan wajib diisi di jendela Create New Event](https://4182233851-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hxDGBLGZN4N69IP4zHp%2Fuploads%2FzcB87GOBG8A08OAtZyn3%2FF5-08-wajib-diisi.png?alt=media)

</details>

<details>

<summary>Browser meminta token minimal 150 karakter</summary>

Misalnya muncul *Please lengthen this text to 150 characters or more*. Token yang ditempel terlalu pendek, kemungkinan tidak tersalin utuh. Salin ulang **Conversion API Token** dari Events Manager. Panduannya: [Cara Mendapatkan Access Token & Pixel ID](https://docs.watzap.id/help/meta-conversion-api/cara-mendapatkan-access-token-and-pixel-id.md).

</details>

<details>

<summary>Muncul "Unable to validate Pixel ID or API Token with Meta Ads"</summary>

Meta menolak Pixel ID atau token tersebut. Pastikan:

* **Meta Pixel ID** sesuai dengan Pixel tempat token dibuat.
* Token disalin utuh tanpa spasi, dan belum dicabut di Events Manager.

</details>

<details>

<summary>Muncul "This event configuration already exists"</summary>

Event dengan Pixel ID, token, Event Name, dan data produk yang sama persis sudah ada. Ubah salah satunya, misalnya Event Name atau Product Name, atau pakai event yang sudah ada.

</details>
