Dokumentacija

Nauči TicketsX brže

Upute za postavljanje, popis svih naredbi, mogućnosti Premiuma i REST API na jednom mjestu.

14.2

Dodavanje widgeta na stranicu

Kopiraj isječak s kartice widgeta i zalijepi ga prije zatvarajuće body oznake na svakoj stranici koja treba prikazati gumb za chat.

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

To je cijela instalacija. Nema preuzimanja, nema ovisnosti, a widget se crta unutar shadow roota pa se ne može sudariti s tvojim stilovima. Radi u čistom HTML-u, na WordPressu, Shopifyju, Webflowu i bilo kojem JavaScript okviru.

Neobavezni atributi

NazivVrstaObaveznoOpis
data-keystring
obavezno
Javni ključ widgeta. Kopiraj ga s nadzorne ploče.
data-positionleft | right
neobavezno
U kojem kutu stoji gumb. Nadjačava postavku s nadzorne ploče.
data-themeauto | light | dark
neobavezno
Svijetli ili tamni prozor. Zadano prati postavku sustava.
data-localestring
neobavezno
Prisiljava jezik, primjerice de ili pt-BR. Zadano prati preglednik.
data-launcherauto | manual
neobavezno
Postavi na manual da sakriješ plutajući gumb i otvoriš chat vlastitim elementom.

Otvaranje chata vlastitim gumbom

Uz data-launcher postavljen na manual widget ostaje nevidljiv dok ga ne pozoveš.

<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() otvara prozor.
  • TicketsXChat.close() i TicketsXChat.toggle() rade upravo ono što im ime kaže.
  • TicketsXChat.isOpen() javlja je li prozor otvoren.
  • TicketsXChat.on('message', handler) okida kad stigne odgovor tvojeg tima.