14.2
Memasang widget di situsmu
Salin cuplikan dari kartu widget dan tempel sebelum tag body penutup di setiap halaman yang perlu menampilkan tombol obrolan.
<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>Itu seluruh pemasangannya. Tidak ada yang perlu diunduh, tanpa dependensi, dan widget digambar di dalam shadow root sehingga tidak bisa bentrok dengan gayamu sendiri. Ia bekerja di HTML biasa, WordPress, Shopify, Webflow, dan kerangka JavaScript mana pun.
Atribut opsional
| Nama | Jenis | Wajib | Keterangan |
|---|---|---|---|
| data-key | string | wajib | Kunci publik widget. Salin dari dasbor. |
| data-position | left | right | opsional | Sudut tempat tombol berada. Menimpa pengaturan di dasbor. |
| data-theme | auto | light | dark | opsional | Panel terang atau gelap. Bawaannya mengikuti pengaturan sistem pengunjung. |
| data-locale | string | opsional | Memaksa satu bahasa, misalnya de atau pt-BR. Bawaannya mengikuti peramban. |
| data-launcher | auto | manual | opsional | Setel ke manual untuk menyembunyikan tombol mengambang dan membuka obrolan dari elemenmu sendiri. |
Membuka obrolan dari tombolmu sendiri
Dengan data-launcher disetel manual, widget tetap tak terlihat sampai kamu memintanya.
<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" data-launcher="manual" defer></script>
<button onclick="TicketsXChat.open()">Contact support</button>- TicketsXChat.open() membuka panel.
- TicketsXChat.close() dan TicketsXChat.toggle() melakukan persis seperti namanya.
- TicketsXChat.isOpen() memberitahu apakah panel sedang terbuka.
- TicketsXChat.on('message', handler) berjalan saat balasan dari timmu masuk.