Documentazione

Impara TicketsX più in fretta

Guide di configurazione, riferimento completo dei comandi, funzioni Premium e API REST in un unico posto.

14.2

Aggiungere il widget al tuo sito

Copia lo snippet dalla scheda del widget e incollalo prima del tag body di chiusura su ogni pagina che deve mostrare il pulsante della chat.

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

L'installazione è tutta qui. Niente da scaricare, nessuna dipendenza, e il widget viene disegnato dentro uno shadow root, quindi non può scontrarsi con i tuoi stili. Funziona in HTML puro, su WordPress, Shopify, Webflow e qualunque framework JavaScript.

Attributi facoltativi

NomeTipoObbligatorioDescrizione
data-keystring
obbligatorio
La chiave pubblica del widget. Copiala dalla dashboard.
data-positionleft | right
facoltativo
In quale angolo sta il pulsante. Sovrascrive l'impostazione della dashboard.
data-themeauto | light | dark
facoltativo
Finestra chiara o scura. Di default segue l'impostazione di sistema.
data-localestring
facoltativo
Forza una lingua, ad esempio de o pt-BR. Di default segue il browser.
data-launcherauto | manual
facoltativo
Metti manual per nascondere il pulsante flottante e aprire la chat da un tuo elemento.

Aprire la chat da un tuo pulsante

Con data-launcher su manual il widget resta invisibile finché non lo chiami.

<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() apre la finestra.
  • TicketsXChat.close() e TicketsXChat.toggle() fanno esattamente quello che dicono.
  • TicketsXChat.isOpen() dice se la finestra è aperta.
  • TicketsXChat.on('message', handler) scatta quando arriva una risposta del tuo team.