Pular para o conteúdo
Pliic

Solução de problemas

Os erros mais comuns ao integrar o widget têm soluções rápidas. Confira abaixo.

”Origin not allowed”

Seção intitulada “”Origin not allowed””

O widget envia o header Origin do navegador em cada requisição. O domínio do seu site precisa estar listado nos domínios permitidos do app.

Vá em Apps → seu app → aba Geral e adicione seu domínio. Curingas são suportados (ex: *.example.com).

”Missing X-App-Key header”

Seção intitulada “”Missing X-App-Key header””

A tag do script está ausente ou usa o nome de atributo errado. Certifique-se de usar data-app-key (e não data-key ou data-pliic-key).

<script
  src="https://pliic.com/widget/v1.js"
  data-app-key="pk_live_xxx"
  async
></script>

Widget não aparece

Seção intitulada “Widget não aparece”

Se o botão do widget não aparece no seu site, verifique:

  • A tag do script está antes de </body>?
  • A chave pública está correta? Confira em Apps → seu app → aba Instalação.
  • Abra o console do DevTools do navegador, procure por avisos com o prefixo [Pliic].
  • O domínio está na lista de domínios permitidos?

”Sua sessão expirou” no modo visitante

Seção intitulada “”Sua sessão expirou” no modo visitante”

Isso é esperado quando a sessão do visitante (30 dias) chegou ao fim, ou quando você gerou uma nova chave secreta para o app: a rotação da chave encerra todas as sessões de visitante ativas. A pessoa só precisa verificar o email de novo; nenhum registro é perdido. Veja Autenticação de usuários para o fluxo completo do modo visitante.

Testando localmente

Seção intitulada “Testando localmente”

Há duas formas de testar o widget em desenvolvimento local:

  • Use a aba Playground na página de edição do app (não precisa configurar domínio).
  • Adicione localhost (ou 127.0.0.1) à lista de domínios permitidos do app.

Próximos passos

Seção intitulada “Próximos passos”