Документація

Опануй TicketsX швидше

Посібники з налаштування, повний перелік команд, можливості Premium і REST API в одному місці.

14.2

Як додати віджет на сайт

Скопіюй код із картки віджета й встав його перед закривальним тегом body на кожній сторінці, де має бути кнопка чату.

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

Це вся інсталяція. Нічого не треба завантажувати, жодних залежностей, а віджет малюється всередині shadow root, тож він не зіткнеться з твоїми стилями. Працює на чистому HTML, WordPress, Shopify, Webflow і будь-якому JavaScript-фреймворку.

Необовʼязкові атрибути

НазваТипОбов'язковоОпис
data-keystring
обовʼязково
Публічний ключ віджета. Скопіюй його з панелі керування.
data-positionleft | right
необовʼязково
У якому куті стоїть кнопка. Перекриває налаштування з панелі керування.
data-themeauto | light | dark
необовʼязково
Світле чи темне вікно. За замовчуванням береться налаштування системи.
data-localestring
необовʼязково
Задає мову примусово, наприклад de або pt-BR. За замовчуванням береться мова браузера.
data-launcherauto | manual
необовʼязково
Постав manual, щоб сховати плавучу кнопку й відкривати чат своїм елементом.

Відкрити чат власною кнопкою

Якщо data-launcher дорівнює manual, віджет лишається невидимим, доки ти його не викличеш.

<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() відкриває вікно.
  • TicketsXChat.close() і TicketsXChat.toggle() роблять саме те, що написано.
  • TicketsXChat.isOpen() каже, чи вікно відкрите.
  • TicketsXChat.on('message', handler) спрацьовує, коли надходить відповідь від твоєї команди.