14.2
Agregar el widget a tu sitio
Copia el fragmento de la ficha del widget y pégalo antes de la etiqueta body de cierre en cada página que deba mostrar el botón de chat.
<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>Esa es toda la instalación. Nada que descargar, ninguna dependencia, y el widget se dibuja dentro de un shadow root, así que no puede chocar con tus estilos. Funciona en HTML puro, WordPress, Shopify, Webflow y cualquier framework de JavaScript.
Atributos opcionales
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| data-key | string | obligatorio | La clave pública del widget. Cópiala desde el panel. |
| data-position | left | right | opcional | En qué esquina se coloca el botón. Sustituye al ajuste del panel. |
| data-theme | auto | light | dark | opcional | Ventana clara u oscura. Por defecto sigue el ajuste del sistema. |
| data-locale | string | opcional | Fuerza un idioma, por ejemplo de o pt-BR. Por defecto sigue al navegador. |
| data-launcher | auto | manual | opcional | Ponlo en manual para ocultar el botón flotante y abrir el chat desde tu propio elemento. |
Abrir el chat desde tu propio botón
Con data-launcher en manual el widget queda invisible hasta que lo llamas.
<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() abre la ventana.
- TicketsXChat.close() y TicketsXChat.toggle() hacen lo que dicen.
- TicketsXChat.isOpen() indica si la ventana está abierta.
- TicketsXChat.on('message', handler) salta cuando llega una respuesta de tu equipo.