Estabilidade · template n8n
Vigia de execuções travadas
Pega o tipo de falha que o alerta de erro comum não vê — a execução que trava ou morre no meio, sem gerar nenhum evento de erro.
O que faz
A cada 15 minutos, consulta a própria API do n8n e procura execuções recentes com status error, crashed (o n8n reiniciou/travou no meio) ou canceled (cancelada manualmente). O [TN] Estabilidade · Alerta de erro em qualquer workflow só dispara quando um workflow termina com erro — uma execução que trava e nunca termina (crashed) não aciona nada nele. Este vigia cobre esse buraco. Cada execução entra em, no máximo, um alerta (usa o maior ID já avisado para não repetir) e falhas do mesmo workflow na mesma janela vêm agrupadas num só alerta, por e-mail e, se quiser, também por WhatsApp.
O que você precisa
- n8n 2.x (self-hosted, com a API do n8n habilitada — vem ligada por padrão)
- Núcleo TN instalado (
[TN] Núcleo · Enviar WhatsApp, só se for usar o alerta por WhatsApp) - Credencial SMTP configurada no n8n (Settings → Credentials → SMTP)
Cuidados (LGPD)
- O alerta é só para a equipe técnica/administrativa. Ele identifica o workflow que falhou pelo ID (não busca o nome nem o conteúdo do workflow, para manter a consulta leve) — clique no link para ver os detalhes direto no seu n8n.
Limites conhecidos
- Identifica os workflows com falha pelo ID, não pelo nome — buscar o nome exigiria carregar a definição completa de todos os workflows a cada 15 minutos, o que pesa desnecessariamente numa instância com muitos workflows. O link do alerta já abre direto no workflow certo.
limite_por_statuslimita quantas falhas de cada status são lidas por checagem. Numa avalanche de falhas muito maior que esse número, dentro dos mesmos 15 minutos, o alerta cobre as mais recentes e o restante entra na checagem seguinte (nada se perde, só chega em lotes).- Este alerta **não usa
tn_enviados**: a proteção contra alerta repetido é o controle de maior ID já avisado, guardado nos dados internos deste workflow (staticData do n8n) — se o workflow for excluído e reimportado, a memória se perde e ele volta a só "marcar o ponto de partida" na próxima execução. - O alerta por WhatsApp é mandado com
proativo:falsede propósito — uma execução travada não pode esperar a janela comercial do Enviador.