Mensagens de Log e Solução de Problemas
"A pesquisa não apareceu" — checklist
- Ligue o Modo Debug (
debug: trueouwindow.PliQ.enableDebug()) e abra o painel - Confira a Sessão: está ativa? A pessoa é a esperada?
- Olhe a coluna exibe? do disparo/widget — ela mostra o motivo de não aparecer:
| Motivo | O que significa | O que fazer |
|---|---|---|
URL | A tela atual não casa com as regras de URL configuradas | Acesse a URL exata (ou ajuste o regex na plataforma) |
limite | Já foi exibido o número máximo de vezes | Ajuste o limite na plataforma ou teste com outro contato |
agendado | O disparo ainda não chegou na janela de agendamento | Confira o agendamento da comunicação |
device | O dispositivo atual não está no alvo do widget | Teste no device configurado (ou amplie o alvo) |
inativo | O widget está desativado na plataforma | Ative o widget |
- Acabou de mudar a configuração na plataforma e não refletiu? É o cache de 20 minutos — use o bypass de cache
Mensagens de log do console
Com log: true, o plugin registra o que está fazendo no console do navegador:
| Mensagem | Explicação |
|---|---|
| "Modal launched 🚀🚀" | Sucesso! O popup foi apresentado ao usuário |
| "Já foi exibido a quantidade máxima de vezes" | O contato chegou ao limite de exibições do popup |
| "Local da pesquisa não compatível" | A URL atual não corresponde à configurada na plataforma |
| "Contato para essa pesquisa ainda em quarentena" | O contato respondeu recentemente e está em quarentena |
FAQ — Perguntas frequentes
Como usar URL de ativação com múltiplos subdomínios?
Para empresas com múltiplos subdomínios como:
https://empresaA.pliq.iohttps://empresaB.pliq.iohttps://empresaN.pliq.io
Use regex no campo de URL:
^https:\/\/empresa[A-Z]\.pliq\.io$
dica
No painel de debug, o detalhe da coluna exibe? mostra cada regra de URL avaliada com ✓/✗ — ótimo para validar o regex.
Por que contatos não saem do status "agendado"?
Para sair do status agendado, o contato precisa:
- Acessar a URL exata parametrizada na etapa de Popup
- Estar logado (via
initialize) com os dados daquele contato
Atenção
O usuário deve acessar exatamente a URL configurada na plataforma PliQ, caso contrário o popup não será exibido.
Mudei a pesquisa na plataforma e o plugin não atualizou
O plugin guarda a sessão por 20 minutos (local + servidor). Em testes, use o bypass de cache:
window.PliQ.setIgnoreCache(true);
window.PliQ.relogin();
O CSS do meu site está quebrando o modal (ou vice-versa)
Isso era possível até a v4. Desde a v6, o plugin renderiza tudo dentro de um Shadow DOM — os estilos não se misturam mais. Se ainda estiver na v4, migre para a v7.