Troubleshooting

Resolver os problemas mais comuns sem intervenção manual

Cada tópico parte do sintoma e aponta os checks mais curtos para reduzir tempo de diagnóstico.

Widget não aparece

O snippet foi publicado, mas o launcher não aparece no frontend.

Confirmar se o script foi realmente entregue no HTML final.
Validar se o token público da installation está preenchido.
Verificar CSP, bloqueio de ad blockers e erros de consola.
Abrir recurso relacionado

Widget offline

O widget abre, mas a installation não fica verde e a presença não parece ativa.

Verificar heartbeat e current_url reportados pela installation.
Confirmar se o domínio do site coincide com o domínio configurado.
Testar installation health antes de publicar o site.
Abrir recurso relacionado

Installation vermelha

A installation aparece stale ou offline no painel.

Comparar o token ativo com o snippet publicado.
Verificar se a página com o snippet recebe tráfego real.
Garantir que a versão do loader não foi bloqueada por cache antigo.
Abrir recurso relacionado

Google Login

O login social redireciona, mas o callback falha ou não cria sessão.

Validar redirect URI configurado no provider.
Confirmar client id, secret e domínio autorizado.
Rever Production Configuration no Operations Center.
Abrir recurso relacionado

Apple Login

O fluxo Apple não conclui ou devolve configuração inválida.

Validar Service ID, Team ID, Key ID e private key.
Confirmar callback e domínio público.
Executar teste no Operations Center antes de abrir produção.
Abrir recurso relacionado

Stripe

Checkout, webhook ou assinatura não refletem no tenant.

Confirmar secret key, webhook signing secret e endpoint ativo.
Verificar logs do billing e eventos no Operations Center.
Testar o fluxo sandbox antes de trocar para produção.
Abrir recurso relacionado

Push e Firebase

Notificações não chegam ao browser ou ao mobile.

Verificar service worker, VAPID keys e Firebase credentials.
Confirmar subscrição ativa do dispositivo.
Executar smoke test de push no Operations Center.
Abrir recurso relacionado

Moloni / Fiscalo

A conexão fiscal existe, mas as ações não executam com sucesso.

Validar credenciais, base URL e environment da connection.
Testar a connection e rever o último erro registado.
Garantir que a action chamada já está mapeada no catálogo.
Abrir recurso relacionado