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) спрацьовує, коли надходить відповідь від твоєї команди.