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

Освой 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) срабатывает, когда приходит ответ от твоей команды.