2.2 Manejo de errores y alertas operativas

En producción, los errores son inevitables: una API externa puede responder con un error temporal 502, una base de datos puede tardar más de lo previsto o un usuario puede enviar un archivo corrupto.

La diferencia entre una automatización artesanal y un sistema profesional radica en cómo responde el flujo cuando algo falla.

Las Dos Estrategias de Tolerancia a Fallos en n8n

1. Reintentos a nivel de nodo (Retry on Fail)

Dentro de la configuración de cada nodo (pestaña Settings), puedes activar:

• Retry on Fail: Reintentar automáticamente hasta N veces (típicamente 3).
• Wait Between Tries: Intervalo en milisegundos con retroceso exponencial (exponential backoff).
• Continue on Fail: Si el nodo no es crítico, puedes continuar el flujo y rutear el error mediante un nodo If.

2. Workflow Global de Errores (Error Trigger)

Para fallos críticos no recuperables, n8n permite asignar un Error Workflow en la configuración general del flujo (Settings > Error Workflow).

Cuando cualquier nodo del flujo principal falla, n8n dispara automáticamente el Error Workflow pasándole un objeto completo con:

• execution.id: ID de la ejecución fallida con link directo al editor.
• workflow.name: Nombre del flujo donde ocurrió el incidente.
• error.message: Mensaje de error y traza técnica detallada.

1// Nodo Code dentro del Error Workflow
2const err = $json.execution.error;
3const wf = $json.workflow;
4const execId = $json.execution.id;
5​
6const mensajeTelegram = `🚨 **ALERTA OPERATIVA - FALLO EN AUTOMATIZACIÓN**
7​
8• **Flujo:** ${wf.name} (ID: ${wf.id})
9• **Causa:** ${err.message || 'Error no especificado'}
10• **Nodo:** ${err.node?.name || 'Desconocido'}
11• **Fecha:** ${new Date().toLocaleString('es-AR', { timeZone: 'America/Argentina/Cordoba' })}
12​
13🔗 [Revisar ejecución en n8n](https://n8n.tuempresa.com/execution/${execId})`;
14​
15return { json: { mensajeTelegram } };

Validación de Conceptos

Checklist de Implementación