Documentation

Prends TicketsX en main plus vite

Guides d'installation, référence complète des commandes, fonctionnalités Premium et API REST au même endroit.

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

NomTypeObligatoireDescription
data-keystring
requis
La clé publique du widget. Copie-la depuis le tableau de bord.
data-positionleft | right
facultatif
Le coin où se place le bouton. Remplace le réglage du tableau de bord.
data-themeauto | light | dark
facultatif
Fenêtre claire ou sombre. Par défaut, le réglage système du visiteur.
data-localestring
facultatif
Force une langue, par exemple de ou pt-BR. Par défaut, celle du navigateur.
data-launcherauto | 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.