Dokumentace

Nauč se TicketsX rychleji

Návody k nastavení, přehled všech příkazů, funkce Premium a REST API na jednom místě.

14.2

Přidání widgetu na web

Zkopíruj úryvek z karty widgetu a vlož ho před uzavírací body tag na každé stránce, kde se má tlačítko chatu ukázat.

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

To je celá instalace. Nic se nestahuje, žádná závislost, a widget se kreslí v shadow rootu, takže se nemůže srazit s tvými styly. Funguje v čistém HTML, na WordPressu, Shopify, Webflow i v jakémkoli JavaScriptovém frameworku.

Volitelné atributy

NázevTypPovinnéPopis
data-keystring
povinné
Veřejný klíč widgetu. Zkopíruj ho z panelu.
data-positionleft | right
volitelné
V kterém rohu tlačítko sedí. Přebije nastavení z panelu.
data-themeauto | light | dark
volitelné
Světlé nebo tmavé okno. Výchozí se řídí nastavením systému.
data-localestring
volitelné
Vynutí jazyk, třeba de nebo pt-BR. Výchozí se řídí prohlížečem.
data-launcherauto | manual
volitelné
Nastav manual, ať se plovoucí tlačítko skryje a chat otevřeš vlastním prvkem.

Otevření chatu vlastním tlačítkem

S data-launcher na manual zůstane widget neviditelný, dokud si o něj neřekneš.

<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() otevře okno.
  • TicketsXChat.close() a TicketsXChat.toggle() dělají přesně to, co říkají.
  • TicketsXChat.isOpen() řekne, jestli je okno otevřené.
  • TicketsXChat.on('message', handler) se spustí, když dorazí odpověď od tvého týmu.