"Webhook silencioso" descreve o cenário em que sua loja parou de enviar eventos ao ShopIA mas o sistema ainda exibe a integração como conectada. Essa página explica como o ShopIA detecta o problema, quais são as causas e como resolver.
Como o sistema detecta
O ShopIA monitora a frequência de webhooks recebidos por loja. Se uma loja anteriormente ativa parar de enviar eventos por mais de 2 horas em horário comercial, o sistema gera alerta automático:
| Indicador | Onde aparece |
|---|---|
| Banner amarelo no painel | "Atenção: nenhum evento recebido nas últimas 2h" |
| Aviso em Avisos | Categoria "Integração" |
| Email para o lojista | Notificação automática (se ativada) |
| Alerta admin | Visível para super admin via Monitoramento |
Lojas em status arquivado ou trial expirado não geram alerta.
Causa 1: plugin pausou de enviar (WooCommerce)
A causa mais comum. O plugin pode parar por:
- Atualização do WordPress que desabilitou o plugin
- Conflito com novo plugin instalado
- Erro fatal em PHP que crash o plugin
- Modo de manutenção ativado
Como verificar
- Acesse
wp-admin > Plugins. - Confirme que ShopIA Connector está ativo.
- Em WooCommerce > ShopIA > Diagnóstico, clique em Testar conexão.
- Verifique log de erros recentes em WooCommerce > Status > Logs.
Como resolver
- Se desativado: clique em Ativar.
- Se com erro fatal: desative o plugin que causou conflito.
- Se em modo manutenção: desative o modo até finalizar.
Detalhes em Plugin WooCommerce não conecta.
Causa 2: subdomínio de webhook não acessível
A partir do plugin v3.13, os eventos são enviados para webhooks.shopia.com.br. Se sua hospedagem ou WAF bloqueia chamadas externas para esse subdomínio, eventos não chegam silenciosamente.
Como verificar
- Em Avisos, busque "Eventos enviados retornaram 4xx ou 5xx".
- Se aparecer, há bloqueio de saída. Comum em redes corporativas restritivas.
Como resolver
- Adicione
webhooks.shopia.com.brà allowlist do firewall. - Confirme que sua hospedagem permite chamadas HTTPS de saída.
- Teste com
curlda hospedagem para validar.
Causa 3: Shopify desinstalou o app
No caso do Shopify, a desinstalação do app implica perda dos webhooks registrados. O sintoma é idêntico ao webhook silencioso.
Detalhes e resolução em Shopify desconectou.
Causa 4: rate limit interno excedido
Lojas com volume muito alto (mais de 1.000 pedidos por hora) podem temporariamente exceder rate limit interno do ShopIA. Eventos novos voltam a ser processados em até 15 minutos.
Como identificar
- Banner azul "Processando volume alto"
- Eventos antigos chegam normalmente após o pico
Não há ação necessária — o sistema se autorregula.
Causa 5: hospedagem do site fora do ar
Loja inacessível para visitantes = sem pedidos novos = sem webhooks. Verifique se o site da loja responde normalmente. Use ferramentas como downforeveryoneorjustme.com.
Causa 6: ambiente sandbox confundido com produção
Em multi-ambiente, é fácil olhar o painel de produção achando que é sandbox e vice-versa. Confirme que está olhando o ambiente correto antes de declarar problema.
O que o sistema faz quando detecta silêncio prolongado
Após 24 horas sem eventos:
- Sistema marca a loja como
webhook_silent_storeinternamente. - Inicia rotina de full sync de fallback (importação completa dos últimos 7 dias).
- Notifica o lojista por email e in-app.
- Reseta o relógio quando webhooks voltam a chegar.
Esse mecanismo é defesa em profundidade — mesmo se webhooks falharem por dias, dados não são perdidos.
Quando entrar em contato com o suporte
Abra ticket se:
- Você passou pelas causas acima e nenhuma se aplica
- O fallback de full sync não rodou após 24 horas de silêncio
- Eventos passados não aparecem no painel mesmo após reconexão
Inclua no ticket: domínio da loja, plataforma, data e hora aproximada do último pedido recebido.