Pedidos novos podem demorar entre 30 segundos e alguns minutos para aparecer no painel ShopIA, dependendo da plataforma e da carga atual do sistema. Esta página define o que é normal, o que é atraso real e como diagnosticar.
Tempo esperado de sincronização
| Evento | Plataforma | Tempo esperado |
|---|---|---|
| Pedido novo (webhook) | WooCommerce v3.13+ | 30 segundos a 2 minutos |
| Pedido novo (webhook) | WooCommerce v3.12 ou anterior | 2 a 5 minutos |
| Pedido novo (webhook) | Shopify | 30 segundos a 1 minuto |
| Pedido novo (webhook) | Nuvemshop | 1 a 3 minutos |
| Carrinho abandonado | Todas | 60 minutos após inatividade |
| Atualização de produto | Todas | 1 a 5 minutos |
Acima desses tempos, classificamos como atraso e vale investigar.
Causa 1: pico de volume na fila
O ShopIA processa eventos em filas BullMQ separadas por prioridade. Em horários de pico (Black Friday, lançamentos), a fila critical pode acumular alguns minutos de fila.
Como verificar
- Acesse o painel.
- Em Status do sistema, observe Fila crítica.
- Se exibir "Mais de 5 minutos de espera", há acúmulo temporário.
Não há ação do lojista — sistema se normaliza após pico.
Causa 2: webhook chegando mas não processado
Em casos raros, o evento entra na fila mas falha durante processamento (erro de validação, dados inconsistentes, etc.). O sistema retém na fila de retry.
Como verificar (super admin)
Logs em Monitoramento > Webhooks mostram eventos com status failed ou retry.
Como resolver
Em geral, retry automático resolve em até 15 minutos. Se persistir:
- Confirme que dados do pedido estão completos na plataforma de origem
- Cliente associado tem email ou telefone válido (sem isso, pedido entra mas customer não é criado)
- Produtos do pedido existem no catálogo sincronizado
Causa 3: sincronização inicial em andamento
Após conectar uma loja nova, o ShopIA importa os últimos 90 dias de dados em segundo plano. Durante esse período, eventos novos são processados normalmente, mas o painel pode mostrar "carregando" em algumas seções.
Como verificar
- Em Painel > Status, observe Sincronização inicial.
- Mostra percentual concluído.
- Tempo médio para 30.000 clientes: 2 a 4 horas.
Causa 4: fila pausada para a loja
Em casos raros (manutenção, alerta de fraude, suspensão temporária), a fila da loja é pausada. Eventos chegam mas não processam.
Como verificar
Banner vermelho no painel: "Sincronização pausada — contate suporte".
Como resolver
Apenas suporte pode despausar. Contate informando o motivo provável (mudança de plano, restauração de loja arquivada, etc.).
Causa 5: latência da plataforma de origem
Plataformas têm sua própria latência. Shopify costuma enviar webhook em até 5 segundos após o pedido. WooCommerce depende do servidor da loja — em hospedagens lentas, pode demorar 1 ou 2 minutos só para disparar.
Não há ação do ShopIA. Mude de hospedagem se a latência for crítica para seu negócio.
Como identificar atraso real vs comportamento normal
Use a regra de 5x:
Se o tempo observado é mais de 5 vezes o tempo esperado da tabela acima, é atraso real e vale investigar.
Exemplo:
- Esperado para Shopify: 30 segundos a 1 minuto
- Observado: 8 minutos
- 5x = 5 minutos
- 8 minutos > 5 minutos → atraso real, abrir ticket
Forçando ressincronização manual
Em caso de atraso persistente:
- Acesse Configurar > Conexões > [plataforma].
- Clique em Forçar sincronização.
- Sistema importa os últimos 7 dias de pedidos diretamente da API da plataforma.
- Eventos duplicados são ignorados pelo
external_id.
Use com moderação. Forçar sincronização em loja com 100.000 pedidos consome cota de API da plataforma e pode demorar.
Carrinho abandonado e o atraso de 60 minutos
Importante distinguir:
- Pedido: chega quase imediatamente após o checkout.
- Carrinho abandonado: detectado 60 minutos após a última atividade. Esse é o tempo padrão de inatividade que define abandono. Não é atraso, é definição.
Detalhes em Como funciona a recuperação de carrinho abandonado.