14.2
Ajouter le widget à ton site
Copie l'extrait depuis la fiche du widget et colle-le avant la balise body fermante sur chaque page qui doit afficher le bouton de chat.
<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>C'est toute l'installation. Rien à télécharger, aucune dépendance, et le widget s'affiche dans un shadow root, donc il ne peut pas entrer en conflit avec tes styles. Ça marche en HTML pur, sur WordPress, Shopify, Webflow et tout framework JavaScript.
Attributs facultatifs
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| data-key | string | requis | La clé publique du widget. Copie-la depuis le tableau de bord. |
| data-position | left | right | facultatif | Le coin où se place le bouton. Remplace le réglage du tableau de bord. |
| data-theme | auto | light | dark | facultatif | Fenêtre claire ou sombre. Par défaut, le réglage système du visiteur. |
| data-locale | string | facultatif | Force une langue, par exemple de ou pt-BR. Par défaut, celle du navigateur. |
| data-launcher | auto | manual | facultatif | Mets manual pour cacher le bouton flottant et ouvrir le chat depuis ton propre élément. |
Ouvrir le chat depuis ton propre bouton
Avec data-launcher sur manual, le widget reste invisible jusqu'à ce que tu l'appelles.
<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() ouvre la fenêtre.
- TicketsXChat.close() et TicketsXChat.toggle() font ce que leur nom dit.
- TicketsXChat.isOpen() indique si la fenêtre est ouverte.
- TicketsXChat.on('message', handler) se déclenche quand une réponse de ton équipe arrive.