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-key | string | обязательно | Публичный ключ виджета. Скопируй его из панели. |
| data-position | left | right | необязательно | В каком углу стоит кнопка. Перебивает настройку из панели. |
| data-theme | auto | light | dark | необязательно | Светлое или тёмное окно. По умолчанию берётся настройка системы. |
| data-locale | string | необязательно | Задаёт язык принудительно, например de или pt-BR. По умолчанию берётся язык браузера. |
| data-launcher | auto | 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) срабатывает, когда приходит ответ от твоей команды.