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_status limita 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:false de propósito — uma execução travada não pode esperar a janela comercial do Enviador.

Quer isso rodando na sua clínica sem montar do zero?