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
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| data-key | string | obbligatorio | La chiave pubblica del widget. Copiala dalla dashboard. |
| data-position | left | right | facoltativo | In quale angolo sta il pulsante. Sovrascrive l'impostazione della dashboard. |
| data-theme | auto | light | dark | facoltativo | Finestra chiara o scura. Di default segue l'impostazione di sistema. |
| data-locale | string | facoltativo | Forza una lingua, ad esempio de o pt-BR. Di default segue il browser. |
| data-launcher | auto | 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.