TourKit

Instalação em cinco minutos

Esta página é para quem cuida do sistema. Se você chegou aqui por indicação do cliente, é isto que ele precisa que seja feito — uma vez só.

O que fazer

Colar duas linhas antes do </body>, em qualquer página onde o conteúdo deva aparecer. Normalmente no template base, para valer no sistema inteiro.

<script src="https://tourkit.zillon.com.br/dist/tourkit.min.js"></script>
<script>
  TourKit.init({ key: "CHAVE-DO-CLIENTE", endpoint: "https://tourkit.zillon.com.br" });
</script>

A chave vai no e-mail que o cliente recebe ao criar a conta, e também fica no painel dele. É o único valor que muda.

Opcional: se o sistema souber quem está logado, dá para segmentar quem vê cada aviso. Nada disso é obrigatório para funcionar.

TourKit.identify({ perfil: "recepcao", unidade: "centro" });

Fica no navegador. Só acompanha o envio se o usuário responder um formulário.

As perguntas que você vai fazer

Vai pesar?	40 KB minificado, carregado de forma assíncrona depois da página. Sem dependência, sem framework, sem polyfill. Um `GET` de configuração por carga, com ETag — sem mudança, volta 304.
Vai quebrar meu layout?	Não altera o HTML existente. O que ele cria são elementos próprios no fim do `<body>`, com prefixo `tk-` e `tkc-`, em `position:fixed`. A barra de aviso reserva a própria altura via `padding` no `body` em vez de cobrir o conteúdo.
E a LGPD?	Sem cookie, sem rastreador, sem gravação de sessão, sem captura de DOM, sem telemetria de clique. A única coisa que sai do navegador é resposta de formulário, com ação explícita do usuário. O que fica no `localStorage` é apenas o controle de "já vi este aviso".
E o CSP?	Precisa liberar `script-src` e `connect-src` para `tourkit.zillon.com.br`. Nada de `eval` e nada de `unsafe-inline` por parte dele.
Mexe no banco?	Não. Nenhuma alteração de schema, nenhuma migração, nada no servidor do cliente.
Como remove?	Apagando as duas linhas. Não deixa resíduo no sistema.
Acessibilidade?	Foco preso e devolvido, `role` e `aria-*` corretos, operação por teclado, respeita `prefers-reduced-motion`. Verificado com axe-core em navegador real, em quatro perfis, a cada build. Ver o relatório.

Como conferir que funcionou

Abra qualquer página onde as tags foram coladas.
No console: TourKit.campaigns deve devolver uma lista.
Se o cliente já publicou um aviso e ele está dentro da janela de exibição, aparece na tela.
Se nada aparecer, confira a chave e se o domínio está liberado no CSP.

Precisa de ajuda

Se preferir, entramos numa chamada de quinze minutos e colamos junto. Escreva para contato@zillon.com.br.