Documentație

Învață TicketsX mai repede

Ghiduri de configurare, lista completă de comenzi, funcțiile Premium și API-ul REST într-un singur loc.

14.2

Adăugarea widgetului pe site

Copiază fragmentul din fișa widgetului și lipește-l înainte de eticheta body de închidere, pe fiecare pagină care trebuie să arate butonul de chat.

<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>

Asta e toată instalarea. Nimic de descărcat, nicio dependență, iar widgetul se desenează într-un shadow root, deci nu se lovește de stilurile tale. Merge în HTML simplu, pe WordPress, Shopify, Webflow și în orice framework JavaScript.

Atribute opționale

NumeTipObligatoriuDescriere
data-keystring
obligatoriu
Cheia publică a widgetului. Copiaz-o din panou.
data-positionleft | right
opțional
În ce colț stă butonul. Trece peste setarea din panou.
data-themeauto | light | dark
opțional
Fereastră deschisă sau închisă la culoare. Implicit urmează setarea sistemului.
data-localestring
opțional
Forțează o limbă, de exemplu de sau pt-BR. Implicit urmează browserul.
data-launcherauto | manual
opțional
Pune manual ca să ascunzi butonul plutitor și să deschizi chatul din propriul element.

Deschiderea chatului din butonul tău

Cu data-launcher pe manual, widgetul rămâne invizibil până îl chemi.

<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() deschide fereastra.
  • TicketsXChat.close() și TicketsXChat.toggle() fac exact ce spun.
  • TicketsXChat.isOpen() spune dacă fereastra e deschisă.
  • TicketsXChat.on('message', handler) pornește când sosește un răspuns de la echipa ta.