Instalação do Script

Snippet de instalação (v7)

Adicione o snippet abaixo antes do fechamento da tag </body> (ou no <head>) do seu site:

index.html

<!-- PliQ Tag -->
<script>
  (function (p, l, i, q, c, x) {
    p._pliqStt = i;
    x = l.createElement('script');
    x.async = 1;
    x.src = atob(q) + c + '/pliqcx.js';
    l.head.appendChild(x);
  })(window, document, {
    token: 'SEU_TOKEN_AQUI',
    log: false,
    timerButtonClose: 5000,
    position: 'bottom-right',
    blockBackground: false
  }, 'aHR0cHM6Ly9wbGlxZHJpdmUuYmxvYi5jb3JlLndpbmRvd3MubmV0L3BsaXFkcml2ZS9BcHAvUGx1Z2luLw==', 'v7.0.0');
</script>

Token

Substitua SEU_TOKEN_AQUI pelo token da sua empresa (tipo Plugin, ativo). Ele é gerado na plataforma PliQ, em Integrações → Tokens.

Trocar a versão

Para atualizar, mude apenas o último parâmetro do snippet ('v7.0.0').

Ambiente local

Em desenvolvimento não precisa dessa lógica — aponte direto para o arquivo local:

<script>
  (function (p, l, i, x) {
    p._pliqStt = i;
    x = l.createElement('script'); x.async = 1;
    x.src = '/pliqcx.js'; // ou http://localhost:5173/pliqcx.js
    l.head.appendChild(x);
  })(window, document, { token: 'SEU_TOKEN', log: true });
</script>

v7: mudou só o nome do arquivo

Na v7 o bundle passou a ser pliqcx.js. A config continua como window._pliqStt e a API como window.PliQ — e, por causa do nome do bundle, _pliqcxStt e data-pliqcx-* também são aceitos como alias. Integrações da v6 não quebram. Ver Novidades.

Single-file + Shadow DOM (desde a v6)

O plugin é single-file: o CSS vai embutido no .js e é renderizado dentro de um Shadow DOM. Não adicione <link> para nenhum .css — ele não existe. Integrações antigas na v4 (com pliq.js + pliq.css) continuam funcionando, mas recomendamos migrar.

Produção × Sandbox

Os dois últimos parâmetros do snippet são, nesta ordem, a base do CDN (em base64) e a versão. O snippet acima é o de produção; para apontar o mesmo site para o ambiente de homologação, troque só a base64:

Ambiente	Base64 (parâmetro q)	Quando usar
Produção	aHR0cHM6Ly9wbGlxZHJpdmUuYmxvYi5jb3JlLndpbmRvd3MubmV0L3BsaXFkcml2ZS9BcHAvUGx1Z2luLw==	Site em produção, token de produção
Sandbox	aHR0cHM6Ly9wbGlxZHJpdmUuYmxvYi5jb3JlLndpbmRvd3MubmV0L3NhbmRib3gvQXBwL1BsdWdpbi8=	Homologação/testes, token de sandbox

Snippet de sandbox (idêntico ao de produção, só com a outra base64):

index.html (homologação)

<!-- PliQ Tag (sandbox) -->
<script>
  (function (p, l, i, q, c, x) {
    p._pliqStt = i;
    x = l.createElement('script');
    x.async = 1;
    x.src = atob(q) + c + '/pliqcx.js';
    l.head.appendChild(x);
  })(window, document, {
    token: 'SEU_TOKEN_DE_SANDBOX',
    log: true,
    timerButtonClose: 5000,
    position: 'bottom-right',
    blockBackground: false
  }, 'aHR0cHM6Ly9wbGlxZHJpdmUuYmxvYi5jb3JlLndpbmRvd3MubmV0L3NhbmRib3gvQXBwL1BsdWdpbi8=', 'v7.0.0');
</script>

O token é por ambiente

O token de sandbox não funciona em produção e vice-versa — cada ambiente tem sua base. Gere o token no admin do ambiente correspondente.

Por que base64?

Para a URL do nosso CDN não ficar exposta no HTML da sua página. Copie o parâmetro como está — você não precisa decodificar nada.

Se o seu site usa CSP, fale com o nosso suporte para receber o host a liberar em script-src.

Versão fixa × latest

O último parâmetro do snippet define qual build carregar:

Valor	Comportamento
'v7.0.0' (versão fixa)	Recomendado em produção — só muda quando você troca
'latest'	Sempre a build mais recente — atualiza sozinha

Em produção, prefira a versão fixa: você controla quando atualizar.

Depois de instalar

O snippet apenas carrega o plugin. Para as pesquisas aparecerem, chame o initialize no login do seu app e o closeSession no logout:

// login
await window.PliQ.initialize({ name: 'João Silva', email: 'joao@empresa.com' });

// logout
await window.PliQ.closeSession();

Veja todos os detalhes em Métodos do PluginJS e as opções do snippet em Parâmetros de Configuração.