¿Qué es un trigger?

Todo workflow en n8n debe comenzar en algún lugar. Ese punto de inicio se llama nodo trigger — el primer nodo de cualquier workflow y el único nodo que decide cuándo se ejecuta el workflow. Sin un trigger, un workflow simplemente permanece inactivo.

Hay dos grandes categorías: triggers manuales (tú mismo lo inicias) y triggers automáticos (algo externo o una programación lo inicia). Entender qué trigger usar es una de las decisiones más importantes que tomas al diseñar un workflow.

Los tres triggers más comunes

N8n incluye varios nodos trigger. Te encontrarás con estos tres constantemente.

El Manual Trigger es el más sencillo. Haces clic en "Test workflow" en el editor y el workflow se ejecuta una vez. No produce datos propios — simplemente señala "adelante". Úsalo durante el desarrollo o para workflows que solo ejecutas bajo demanda.

El Schedule Trigger ejecuta tu workflow automáticamente a un intervalo fijo — cada hora, cada lunes a las 9 AM, o cualquier expresión cron que definas. Tampoco produce datos de entrada; la programación es simplemente una señal de reloj.

{
  "rule": {
    "interval": [
      {
        "field": "hours",
        "hoursInterval": 1
      }
    ]
  }
}

El Webhook Trigger es el más potente. N8n expone una URL única, y cada vez que una petición HTTP llega a esa URL, el workflow se ejecuta de inmediato. El body de la petición entrante, los headers y los query parameters se convierten en el primer dato que fluye a través del workflow. Así es como conectas n8n con servicios externos como GitHub, Stripe o cualquier sistema que soporte webhooks.

Cuando añades un nodo Webhook, n8n te ofrece dos URLs: una URL de prueba (activa solo mientras tienes el editor abierto y haces clic en "Listen for Test Event") y una URL de producción (activa solo cuando el workflow está guardado y activado).

# Example: trigger a workflow by sending a POST request
curl -X POST https://your-n8n-instance.com/webhook/your-unique-path \
  -H "Content-Type: application/json" \
  -d '{"event": "user.signup", "email": "alex@example.com"}'

Cómo procesa datos n8n: el modelo de ejecución

Una vez que se dispara un trigger, n8n crea una ejecución — una sola corrida de tu workflow. Cada nodo se ejecuta en secuencia, de izquierda a derecha, pasando datos al siguiente nodo.

El modelo de datos que usa n8n es un array de items. Cada nodo recibe un array de items y produce un array de items. Cada item es un objeto JSON envuelto en una estructura como esta:

[
  {
    "json": {
      "email": "alex@example.com",
      "plan": "pro"
    }
  },
  {
    "json": {
      "email": "sam@example.com",
      "plan": "free"
    }
  }
]

Cuando un nodo recibe dos items, normalmente procesa cada item individualmente y produce dos items. Esto significa que si tu webhook envía un usuario, el siguiente nodo procesa un registro. Si un nodo upstream divide o multiplica datos, los nodos downstream ven más items.

Este modelo mental de item-por-fila es la clave para entender por qué las cosas se comportan como lo hacen. Un nodo como HTTP Request se ejecuta una vez por item por defecto. Un nodo como Merge puede combinar items de dos ramas en un solo array. Llevar el control de cuántos items tienes en cada paso previene la mayor parte de la confusión de los principiantes.

Puedes inspeccionar qué ocurrió en cualquier paso haciendo clic en un nodo después de una ejecución de prueba — n8n te muestra los datos exactos de entrada y salida de esa ejecución.

Workflows activos vs. inactivos

Un workflow con un trigger Webhook o Schedule solo responde a eventos reales cuando está activo. Activar un workflow lo guarda y registra el trigger en el scheduler interno o en el registro de webhooks de n8n. Desactivarlo elimina el registro del trigger — no habrá más ejecuciones automáticas.

Durante el desarrollo, casi siempre trabajas con el workflow inactivo, usando el Manual Trigger o la URL de webhook de prueba para enviar datos de muestra. Cambiar a activo es el paso de despliegue.

Un efecto secundario importante: no puedes tener dos workflows activos compartiendo la misma ruta de webhook. N8n te avisará y se negará a activar el segundo.

Resumen

Todo workflow comienza con un nodo trigger. Los triggers manuales son para desarrollo y uso bajo demanda; los triggers Schedule se ejecutan con un reloj; los triggers Webhook responden a llamadas HTTP externas en tiempo real. Una vez que se dispara un trigger, n8n crea una ejecución y mueve los datos como un array de items de nodo en nodo, de izquierda a derecha. Los workflows con triggers automáticos solo se ejecutan cuando están activados. Familiarizarte con estos fundamentos hace que cada workflow que construyas a partir de aquí sea mucho más fácil de razonar.