Guia de Diagnóstico Geral¶

Módulo 1 — Fotos de Pedidos¶

Sintoma	Causa provável e ação
Workflow não dispara ao receber NF	Verificar se o workflow está ATIVO. Checar se o sistema que envia o XML está usando a URL correta do webhook
Nenhuma foto encontrada (erro no nó 7)	O `cProd` da NF não bate com `referencia` na tabela. Verificar os primeiros 10 chars do `cProd` vs campo `referencia` no banco
E-mail não chega ao cliente	`refresh_token` do RD Station pode ter expirado. Verificar e atualizar o nó 10
Link do cliente retorna expirado	Token vencido. Usar o Workflow de Revalidação de Token (WF2)
WhatsApp não é enviado — fone 1	Verificar instância Evolution API. Aguardar os 5 min antes de diagnosticar. Checar se o fone 1 da NF está preenchido
WhatsApp não é enviado — fone 1 e fone 2	Ambos os telefones retornaram `exists = false`. Verificar se o CNPJ está sendo formatado com máscara na consulta ao Sisplan
Consulta ao Sisplan falha	Verificar credencial Bearer no nó HTTP Request. Checar se `cliente_cnpj` está chegando com a máscara `XX.XXX.XXX/XXXX-XX`
Telefone 2 retorna vazio	Cliente não tem `telefone2` cadastrado no Sisplan. Fluxo encerra sem envio de WhatsApp

Sintoma	Causa provável e ação
Bot não responde	Verificar se o Fluxo Principal está ATIVO. Checar webhook do Telegram Trigger
Bot responde mas não acha arquivos	Linha/tipo/coleção não bate com o banco. Verificar se o arquivo foi ingerido pelo Coletor ou pela Indexação
Agente IA não responde	Verificar saldo/limite do OpenRouter. Checar conexão Redis (Upstash)
Memória do chat parece perdida	Verificar expiração das chaves Redis. Confirmar que `chatId` está sendo passado como String
Coletor não registra arquivo	Nome do arquivo inválido (< 3 partes separadas por `_`). Ver planilha de LOG no Google Sheets

Sintoma	Causa provável e ação
Indexação termina mas banco não foi atualizado	Todos os arquivos já existem (apenas UPDATE foi feito). Ver log de existentes no Sheets
Muitos nomes inválidos no log da Indexação	Arquivos no B2 sem nomenclatura padrão. Verificar a estrutura de nomes no bucket
Erro ao conectar ao Backblaze	Verificar credencial `S3 account - BackBlaze - Drive Inteligente`. Checar validade das chaves B2

Sintoma	Causa provável e ação
Erro ocorreu mas e-mail não chegou	Verificar se o Monitor está ATIVO. Checar se o workflow de origem está vinculado no campo Error Workflow
E-mail chegou mas sem link de execução	Campo `execution.url` vazio — verificar versão da instância n8n
Registro não aparece em `logs_automacao`	Verificar credencial `Postgres - Drive Inteligente`. Confirmar que a tabela existe no schema `public`
Dashboard Metabase não carrega dados	Verificar conexão do Metabase com o PostgreSQL em Admin → Databases

Executions: workflow → aba Executions → clicar em qualquer execução para inspecionar nó a nó
Nó vermelho: erro — clicar para ver a mensagem completa
Nó verde: sucesso — clicar para ver o output
Google Sheets: logs de erros de nomenclatura e duplicatas (Coletor e Indexação)
Tabela logs_automacao: histórico de todos os erros capturados pelo Monitor Global