Documentação

Aprenda o TicketsX mais rápido

Guias de configuração, a referência completa dos comandos, os recursos Premium e a API REST num só lugar.

14.2

Colocando o widget no seu site

Copie o trecho no cartão do widget e cole antes da tag body de fechamento em cada página que deve mostrar o botão de chat.

<script src="https://api.ticketsx.xyz/widget.js" data-key="wk_your_key_here" defer></script>

É toda a instalação. Nada para baixar, nenhuma dependência, e o widget é desenhado dentro de um shadow root, então não briga com os seus estilos. Funciona em HTML puro, WordPress, Shopify, Webflow e qualquer framework JavaScript.

Atributos opcionais

NomeTipoObrigatórioDescrição
data-keystring
obrigatório
A chave pública do widget. Copie do painel.
data-positionleft | right
opcional
Em qual canto o botão fica. Sobrepõe a configuração do painel.
data-themeauto | light | dark
opcional
Janela clara ou escura. O padrão segue a configuração do sistema.
data-localestring
opcional
Força um idioma, por exemplo de ou pt-BR. O padrão segue o navegador.
data-launcherauto | manual
opcional
Coloque manual para esconder o botão flutuante e abrir o chat pelo seu próprio elemento.

Abrindo o chat pelo seu próprio botão

Com data-launcher em manual, o widget fica invisível até você chamar.

<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 a janela.
  • TicketsXChat.close() e TicketsXChat.toggle() fazem exatamente o que dizem.
  • TicketsXChat.isOpen() informa se a janela está aberta.
  • TicketsXChat.on('message', handler) dispara quando chega uma resposta da sua equipe.