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

Научи 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) се задейства, когато дойде отговор от екипа ти.