Documentación

Aprende TicketsX más rápido

Guías de instalación, la referencia completa de comandos, las funciones Premium y la API REST en un solo sitio.

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

NombreTipoObligatorioDescripción
data-keystring
obligatorio
La clave pública del widget. Cópiala desde el panel.
data-positionleft | right
opcional
En qué esquina se coloca el botón. Sustituye al ajuste del panel.
data-themeauto | light | dark
opcional
Ventana clara u oscura. Por defecto sigue el ajuste del sistema.
data-localestring
opcional
Fuerza un idioma, por ejemplo de o pt-BR. Por defecto sigue al navegador.
data-launcherauto | 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.