Introducción

En n8n, cada automatización comienza con un nodo trigger — algo que inicia el workflow — y va seguido de uno o más nodos de acción que realizan el trabajo real. En esta lección construirás un workflow pequeño pero real: cada vez que se añada una nueva fila a una hoja de cálculo de Google Sheets, el workflow extrae el email y el nombre, envía un email de bienvenida personalizado a través de Gmail, y luego registra que el email fue enviado escribiendo un estado de vuelta en la hoja. Este patrón — trigger, transformar, actuar, registrar — es la columna vertebral de casi cualquier automatización que vayas a construir.

Entendiendo Triggers vs Acciones

Un nodo trigger escucha un evento e inicia el workflow. n8n diferencia entre Triggers de Polling (que comprueban si hay nuevos datos en un horario programado) y Triggers de Webhook (que reciben datos al instante mediante una llamada HTTP). En esta lección usamos un Trigger de Polling de Google Sheets porque es el más fácil de configurar sin exponer una URL pública.

Un nodo de acción hace algo con esos datos — enviar un email, escribir en una base de datos, llamar a una API. Los nodos de acción solo se ejecutan después de que un trigger se haya activado y haya producido al menos un ítem de datos. Cada ítem fluye de nodo a nodo, y cada nodo puede leerlo y transformarlo.

Construyendo el Workflow Paso a Paso

Abre n8n y crea un nuevo workflow. Añade el primer nodo, busca "Google Sheets" y selecciona el nodo "Google Sheets Trigger". Configúralo para que vigile una hoja de cálculo específica y una hoja específica (por ejemplo, "Signups"), y establece el trigger para que se active "On Row Added". Esto significa que n8n sondeará la hoja cada minuto y detectará cualquier fila recién insertada.

El trigger produce un ítem por cada nueva fila, conteniendo los valores de las columnas. Ahora añade un nodo "Set" justo después del trigger. El nodo Set te permite mapear explícitamente qué campos quieres mantener y renombrarlos, facilitando la referencia posterior a los datos. Mapea la columna de email a un campo llamado `email` y la columna de nombre a un campo llamado `firstName`.

A continuación, añade un nodo "Gmail" y elige la operación "Send Message". En el cuerpo del mensaje, referencia los campos que acabas de definir para que cada email esté personalizado. n8n usa expresiones con dobles llaves para inyectar datos de nodos anteriores.

To: {{ $json.email }}
Subject: Welcome, {{ $json.firstName }}!
Body: Hi {{ $json.firstName }}, thanks for signing up. We're glad to have you.

Finalmente, añade otro nodo de Google Sheets, pero esta vez elige la operación "Update Row". Mapea la fila a actualizar usando el mismo número de fila que vino del trigger, y establece una columna llamada "Status" con el valor "Email Sent". Esto te da un registro de auditoría claro dentro de la propia hoja de cálculo.

Probando y Activando

Antes de activar el workflow, ejecútalo manualmente usando el botón "Execute Workflow". Añade una fila de prueba a tu hoja con un email y un nombre. Deberías ver cómo el trigger se activa, el nodo Set pasa los valores mapeados, el nodo de Gmail envía el mensaje, y el nodo de actualización escribe "Email Sent" de vuelta en esa fila. Si algún paso falla, haz clic en el nodo para inspeccionar su entrada y salida — esta es la forma más rápida de depurar.

Una vez que la prueba funcione, cambia el workflow de "Inactive" a "Active". A partir de ahora, cada nueva fila de signup generará automáticamente un email de bienvenida y se marcará como procesada.

Errores Comunes a Evitar

Un error frecuente es olvidar que los triggers de polling tienen un retraso — n8n comprueba la hoja en un intervalo, por lo que una fila añadida en el segundo 0 puede no procesarse hasta el segundo 59. Si necesitas procesamiento instantáneo, usa un Trigger de Webhook en su lugar. Otro error común es usar `$node["Node Name"].json` con un nombre de nodo incorrecto después de renombrar un nodo — las expresiones distinguen entre mayúsculas y minúsculas y hacen referencia a la etiqueta actual del nodo. Finalmente, asegúrate de que tus credenciales de Google Sheets y Gmail tengan los scopes necesarios tanto para lectura como para escritura; los scopes faltantes a menudo parecen errores de autenticación, pero en realidad son errores de permisos.

Resumen

Has construido un workflow completo de cuatro nodos: un Google Sheets Trigger que detecta nuevos signups, un nodo Set que da forma a los datos, un nodo de Gmail que envía un mensaje de bienvenida personalizado, y un nodo de actualización de Google Sheets que registra el resultado. Este patrón trigger → transformar → actuar → registrar es reutilizable en casi cualquier proceso de negocio — reemplazar el nodo de Gmail con Slack, una escritura a base de datos, o una llamada HTTP te permite adaptar el mismo esqueleto a innumerables escenarios.