Dokumentasi

Kuasai TicketsX lebih cepat

Panduan pemasangan, daftar lengkap perintah, fitur Premium, dan REST API dalam satu tempat.

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

NamaJenisWajibKeterangan
data-keystring
wajib
Kunci publik widget. Salin dari dasbor.
data-positionleft | right
opsional
Sudut tempat tombol berada. Menimpa pengaturan di dasbor.
data-themeauto | light | dark
opsional
Panel terang atau gelap. Bawaannya mengikuti pengaturan sistem pengunjung.
data-localestring
opsional
Memaksa satu bahasa, misalnya de atau pt-BR. Bawaannya mengikuti peramban.
data-launcherauto | 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.