Page Events
Buka di CMSLayar Page Events mendefinisikan event yang dapat dikirim agent Anda ke halaman web tempat chat-nya di-embed, sehingga halaman bisa merespons percakapan: membuka produk, mengisi form, menuju checkout. Terdapat di sidebar agent pada Tools → Page Events. Perubahan hanya tersimpan setelah Anda mengklik Save all changes. Untuk panduan langkah demi langkah, lihat Membuat Halaman Merespons Agent.
Page Events
| Only on a page that embeds the chat | Catatan bahwa page event hanya ditawarkan ke agent selama chat-nya berjalan di dalam widget qlar pada halaman web, bukan di WhatsApp atau chat standalone. Catatan ini menautkan ke Channels › Embed dan membuka builder. |
| Add page event | Membuka panel New Page Event. |
| Baris page event | Menampilkan action name, nama event, dan deskripsi. Klik untuk membuka Edit Page Event. |
| Switch aktif | Menyalakan atau mematikan page event tanpa menghapusnya. Selama mati, baris tampil redup dengan chip Off, agent tidak ditawari page event ini, dan embed builder tidak menampilkannya. Berlaku setelah Anda menyimpan. |
| Tombol hapus | Menghapus page event dari daftar setelah Anda mengonfirmasi. |
| Empty state | "No page events yet" ditampilkan saat agent belum punya page event. |
| Listen on your page | Contoh kode yang mendengarkan qlarPageEvent pada elemen widget. |
| Save all changes | Menyimpan semua page event setelah Anda mengonfirmasi. |
New Page Event / Edit Page Event
Basic Information
| Action Name | Wajib. Nama action yang dikenal AI, misalnya show_product. |
| Event Name | Wajib. Yang diterima halaman sebagai event.detail.name, misalnya open_product. Diawali huruf dan hanya berisi huruf, angka, _, -, . atau :, maksimal 64 karakter. Dua page event tidak boleh memakai nama event yang sama. |
| Description | Apa yang dilakukan event di halaman dan kapan dikirim. AI memutuskan berdasarkan teks ini. |
| Rules | Opsional. Syarat tambahan untuk mengirim event. |
Parameters
Nilai yang diisi AI dari percakapan. Halaman menerimanya sebagai event.detail.parameters. qlar menolak event yang nilainya tidak sesuai definisi, lalu AI mencoba lagi.
| Property Name | Wajib. Key di event.detail.parameters. Dua property tidak boleh memakai nama yang sama. |
| Property Type | Wajib. String, Number, atau Boolean. |
| Required Parameter | Aktif: event tidak dikirim tanpa nilai ini. |
| Property Enum | Opsional. Satu-satunya nilai yang diizinkan. Tekan Enter setelah setiap nilai. |
| Property Description | Memberi tahu AI apa yang harus diisikan ke property. |
| Add New Property | Menambahkan property. Ikon tempat sampah menghapusnya setelah Anda mengonfirmasi. |
Page event tidak punya request, jadi berbeda dengan Custom API tidak ada location, HTTP method, URL, authentication, maupun loading text.
Metadata
Diisi oleh qlar, tidak pernah oleh AI, dan dikirim sebagai event.detail.metadata. Setiap script di halaman yang meng-embed bisa membacanya, jadi hanya nilai yang aman di sana yang ditawarkan.
Agent ID (agentId) | ID agent yang sudah di-publish. Aktif secara default. |
Conversation ID (threadId) | ID percakapan. Tidak bisa dipakai untuk membaca percakapan. Aktif secara default. |
Message ID (messageId) | ID pesan pengunjung yang dijawab oleh event. Aktif secara default. |
Channel (channel) | text atau voice. Aktif secara default. |
Timestamp (timestamp) | Waktu event dikirim, dalam ISO 8601 UTC. Aktif secara default. |
User ID (userId) | User ID qlar milik pengunjung yang sudah sign in; kosong untuk pengunjung anonim. Nonaktif secara default. |
User email (userEmail) | Alamat email pengunjung yang sudah sign in; kosong untuk pengunjung anonim. Nonaktif secara default. |
| Peringatan data pribadi | Muncul saat User ID atau User email aktif: nilainya dikirim ke halaman yang meng-embed dan setiap script di dalamnya, tidak pernah dikirim dalam privacy mode, dan kosong untuk pengunjung anonim. |
ID organisasi dan owner, permission, link file, dan akun messenger tidak pernah dikirim ke halaman.
Add Page Event / Update Page Event
Memeriksa form lalu memasukkan page event ke daftar. Page event tersimpan setelah Save all changes.
Yang Diterima Halaman
Elemen widget men-dispatch qlarPageEvent yang bubble. Isi detail-nya:
name | Nama event. |
parameters | Parameter beserta nilai dari AI. |
metadata | Metadata yang Anda pilih, beserta nilai dari qlar. |
id | Unik untuk setiap event. |
agentId | data-agent-id dari widget yang mengirimnya. |
Event dikirim sekali, saat percakapan berlangsung. Membuka kembali percakapan tidak mengirimnya ulang.