Complete "Estrategias de manejo de errores y el Trigger de Error" primero para desbloquear esta lección.Ir a la lección anterior

Introducción

En este punto del curso, ya cuentas con ramificación con nodos IF y Switch, bucle con división de ítems y procesamiento por lotes, fusión de ramas en paralelo y envoltura de operaciones riesgadas en manejo de errores. Esta última lección trata de unir todo eso en un único flujo de trabajo que refleje cómo se construyen las automatizaciones reales de producción.

El objetivo no es introducir nodos nuevos. El objetivo es mostrar cómo se componen estos patrones — cómo un bucle alimenta a una fusión, cómo un manejador de errores envuelve un bucle y cómo la lógica de ramificación determina qué ruta toma el resultado fusionado a continuación. El flujo de trabajo que construyas aquí es una plantilla práctica que puedes adaptar a tus propios casos de uso.

El escenario: un flujo de trabajo que lee una lista de contactos desde una API externa, mejora cada contacto llamando a una segunda API, maneja fallos de forma adecuada, fusiona los resultados y envía un informe resumen por correo electrónico.

Diagrama de flujo de extremo a extremo que muestra 5 etapas en secuencia: Obtener Contactos → Bucle + Enriquecer (con rama de errores) → Fusionar Resultados → Ramificar por Éxito/Parcial/Fallo → Enviar Informe

Etapa 1: Obtención y División de Datos de Entrada

El flujo de trabajo comienza con un disparador programado que se activa cada mañana. El primer nodo HTTP Request llama a tu API de contactos y devuelve un arreglo de objetos de contacto. Como n8n envuelve esto en un solo ítem por defecto, necesitas dividir el arreglo antes de recorrerlo.

Usa un nodo Code para dividir el arreglo en ítems individuales que el resto del flujo de trabajo pueda procesar uno a la vez:

javascript
return $input.first().json.contacts.map(contact => ({ json: contact }));

Este es el cimiento. Cada nodo descendiente recibe ahora un solo contacto por ítem, lo que significa que el procesamiento estilo bucle con SplitInBatches o llamadas HTTP directas por ítem funcionará correctamente.

Stage 2: Enriquecer cada contacto con manejo de errores

La etapa de enriquecimiento llama a una API de terceros para cada contacto. Las APIs de terceros fallan. Llevan a límites de tasa, se agotan y devuelven formas inesperadas. Envolver esta llamada en un patrón Try/Catch es no negociable para producción.

Conecta tu nodo de Solicitud HTTP (la llamada de enriquecimiento) a un Disparador de error acotado a ese nodo. La ruta de éxito añade datos enriquecidos al elemento. La ruta de error añade una estructura de respaldo para que el elemento nunca se descarte silenciosamente.

javascript
// On the error branch — Code node that normalizes the failed item
return [{
json: {
...($input.first().json),
enriched: false,
enrichmentError: $input.first().json.error?.message ?? 'Unknown error'
}
}];

Tanto la ruta de éxito como la ruta de error deben producir ítems con la misma forma de nivel superior. Esto es crítico para el paso de fusión que sigue — si una rama devuelve objetos con claves diferentes, los nodos descendentes se vuelven frágiles.

Diagrama de flujo que muestra el nodo de Solicitud HTTP dividiéndose en dos rutas: la ruta de éxito añade datos enriquecidos, la ruta de error añade campos de respaldo, ambas rutas convergen en el nodo Merge

Stage 3: Fusionar y Agregar Resultados

Después de la etapa de enriquecimiento (tanto las ramas de éxito como de error), un nodo Merge en modo Append reúne todos los ítems en un único flujo. A partir de ahí, un nodo Code agrega los resultados en un objeto resumen:

javascript
const items = $input.all();
const total = items.length;
const succeeded = items.filter(i => i.json.enriched !== false).length;
const failed = items.filter(i => i.json.enriched === false).length;
return [{
json: {
total,
succeeded,
failed,
failureRate: (failed / total * 100).toFixed(1) + '%',
items: items.map(i => i.json)
}
}];

Este nodo de agregación es la frontera entre el procesamiento por ítem y la lógica a nivel de flujo de trabajo. Todo lo anterior opera sobre contactos individuales. Todo lo siguiente opera sobre el lote en su conjunto.

Stage 4: Rama sobre el resultado

No cada ejecución debe generar la misma notificación. Una tasa de fallo del 0% merece un correo de éxito limpio. Una tasa de fallo del 100% debe avisar a alguien de inmediato. Un fallo parcial se ubica entre ambos.

Utiliza un nodo IF o Switch para enrutar en función de la tasa de fallo:

javascript
// Switch node — Expression for routing
{{ $json.failed === 0 ? 'success' : $json.succeeded === 0 ? 'critical' : 'partial' }}

Cada rama se conecta a un nodo de notificación diferente — correo para éxito y parcial, Slack o PagerDuty para crítico. Aquí es donde la ramificación y fusión de lecciones anteriores rinden frutos: has construido la capacidad de producir un resumen único por ítem específicamente para que este nodo Switch tenga algo simple que evaluar.

Stage 5: Enviando el informe

Cada rama de notificaciones formatea su propio mensaje. La rama de éxito envía una confirmación corta. La rama parcial incluye la lista de contactos fallidos para que alguien pueda investigar. La rama crítica activa una alerta urgente con todos los detalles del error.

El nodo de correo electrónico en la rama parcial usa una expresión para construir el cuerpo dinámicamente:

javascript
// Code node before the email — builds the failure list
const failures = $json.items
.filter(i => i.enriched === false)
.map(i => `${i.email}: ${i.enrichmentError}`)
.join('\n');
return [{ json: { ...$json, failureList: failures } }];

En este punto el flujo de trabajo está completo. Tiene un disparador, procesamiento por ítem con manejo de errores, fusión de resultados, ramificación basada en el resultado y notificaciones focalizadas.

Resumen

Un flujo de trabajo listo para producción no es aquel que maneja bien la ruta feliz — es aquel que maneja fallos sin perder datos, ramifica sin duplicar lógica y reporta su propia salud. Los patrones que aplicaste aquí — dividir antes del bucle, normalizar ramas de error, agregar antes de ramificar, ramificar por resultado — son los bloques de construcción repetibles para casi cualquier automatización que crearás en n8n. Usa este flujo de trabajo como plantilla de referencia y adapta las etapas a tus propias fuentes de datos, APIs y canales de notificación.

Práctica de la lección

Punto de control de la lección

Repasa lo aprendido y recibe comentarios sobre tu trabajo.

0/1
Respondidas · 0/1