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
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| data-key | string | wymagane | Klucz publiczny widgetu. Skopiuj go z panelu. |
| data-position | left | right | opcjonalne | W którym rogu siedzi przycisk. Nadpisuje ustawienie z panelu. |
| data-theme | auto | light | dark | opcjonalne | Jasne albo ciemne okno. Domyślnie zgodnie z ustawieniem systemu. |
| data-locale | string | opcjonalne | Wymusza język, na przykład de albo pt-BR. Domyślnie zgodnie z przeglądarką. |
| data-launcher | auto | 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.