Dokumentacja

Poznaj TicketsX szybciej

Poradniki konfiguracji, pełny spis komend, funkcje Premium i API REST w jednym miejscu.

14.2

Dodawanie widgetu do strony

Skopiuj fragment z karty widgetu i wklej go przed zamykającym tagiem body na każdej stronie, która ma pokazywać przycisk czatu.

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

To cała instalacja. Nic do pobrania, żadnej zależności, a widget rysuje się w shadow root, więc nie zderzy się z twoimi stylami. Działa w czystym HTML, na WordPressie, Shopify, Webflow i w dowolnym frameworku JavaScript.

Atrybuty opcjonalne

NazwaTypWymaganeOpis
data-keystring
wymagane
Klucz publiczny widgetu. Skopiuj go z panelu.
data-positionleft | right
opcjonalne
W którym rogu siedzi przycisk. Nadpisuje ustawienie z panelu.
data-themeauto | light | dark
opcjonalne
Jasne albo ciemne okno. Domyślnie zgodnie z ustawieniem systemu.
data-localestring
opcjonalne
Wymusza język, na przykład de albo pt-BR. Domyślnie zgodnie z przeglądarką.
data-launcherauto | manual
opcjonalne
Ustaw manual, żeby ukryć pływający przycisk i otwierać czat własnym elementem.

Otwieranie czatu własnym przyciskiem

Przy data-launcher ustawionym na manual widget pozostaje niewidoczny, dopóki go nie wywołasz.

<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() otwiera okno.
  • TicketsXChat.close() i TicketsXChat.toggle() robią dokładnie to, co mówią.
  • TicketsXChat.isOpen() mówi, czy okno jest otwarte.
  • TicketsXChat.on('message', handler) uruchamia się, gdy przychodzi odpowiedź twojego zespołu.