Introducción

Los nodos son los bloques de construcción de cada workflow de n8n. Cada nodo representa una única acción: obtener datos de una API, enviar un correo electrónico, transformar un valor o disparar un flujo según una programación. Cuando conectas nodos entre sí, obtienes un pipeline automatizado que reemplaza el trabajo manual.

Esta lección te guía a través de la biblioteca de nodos, te muestra cómo configurar integraciones reales y explica cómo n8n maneja las credenciales para que tus claves API y contraseñas se mantengan seguras.

La biblioteca de nodos

n8n incluye más de 400 nodos integrados que cubren servicios comunes como Slack, Google Sheets, GitHub, PostgreSQL, APIs HTTP y muchos más. Accedes a ellos haciendo clic en el botón + dentro del canvas, lo que abre un panel con búsqueda.

Los nodos se dividen en dos grandes categorías. Los nodos trigger inician un workflow: escuchan un evento (una llamada webhook, una programación cron, una nueva fila en una base de datos). Los nodos de acción realizan trabajo dentro del workflow: leen, escriben, transforman o envían datos.

Algunos nodos que usarás constantemente:

El nodo HTTP Request llama a cualquier API REST que no tenga un nodo dedicado. Maneja GET, POST, PUT, DELETE, y te permite definir headers, parámetros de consulta y un cuerpo de solicitud.

El nodo Code ejecuta JavaScript o Python en línea, útil cuando las transformaciones integradas no son suficientes.

El nodo Set remodela el objeto de datos que pasa por el workflow: añade un campo, renombra una clave, elimina ruido que no necesitas más adelante.

Configurar una integración real

Vamos a montar un ejemplo práctico: cada vez que se envíe un formulario, publica un mensaje en un canal de Slack con el nombre y el correo electrónico de quien lo envió.

Primero, añade un nodo trigger Webhook. Define el método HTTP como POST y copia la URL generada: este es el endpoint que llamará tu formulario. Activa el workflow para que n8n empiece a escuchar.

A continuación, añade un nodo Slack después del webhook. Elige la acción "Send a Message". En este punto n8n te pedirá que selecciones o crees una credencial de Slack; lo veremos en la siguiente sección.

Una vez configurada la credencial, configura el nodo así:

{
  "channel": "#new-leads",
  "text": "New submission from {{ $json.name }} — {{ $json.email }}"
}

La sintaxis de doble llave es el lenguaje de expresiones de n8n. Lee datos del cuerpo JSON entrante en tiempo de ejecución. Si tu webhook recibe un payload con un campo name y un campo email, esos valores se sustituyen automáticamente.

Envía una solicitud POST de prueba para verificar el flujo completo:

curl -X POST https://your-n8n-instance.com/webhook/your-path \
  -H "Content-Type: application/json" \
  -d '{"name": "Linh", "email": "linh@example.com"}'

Si todo está conectado correctamente, el canal de Slack recibe el mensaje en cuestión de segundos.

Gestión de credenciales

n8n almacena las credenciales de forma separada de los workflows. Este diseño significa que creas una credencial una vez, la reutilizas en muchos workflows y nunca incrustas una clave API en crudo dentro de la configuración de un nodo.

Para añadir una credencial, ve a Settings > Credentials > Add Credential, o deja que n8n te la solicite cuando configures un nodo que requiera autenticación. Seleccionas el servicio, rellenas los campos requeridos (clave API, tokens OAuth, usuario/contraseña) y guardas. n8n cifra los valores almacenados usando la clave de cifrado definida en la configuración de tu instancia.

Para servicios con OAuth2 como Google o Slack, n8n gestiona el flujo de autorización por ti. Haces clic en "Connect", te autenticas en la ventana emergente del navegador, y n8n almacena automáticamente los tokens de acceso y refresco resultantes.

Una práctica importante: usa credenciales separadas por entorno. Tu workflow de staging debería usar un workspace de Slack de pruebas o una clave API de sandbox, no la de producción. Puedes duplicar una credencial y cambiar solo el valor del secreto, dejando el nombre claramente etiquetado ("Slack - Production" frente a "Slack - Staging").

Las credenciales también están acotadas por propietario en configuraciones multiusuario: una credencial creada bajo una cuenta de usuario no es visible para otros a menos que se comparta explícitamente. Esto evita la exposición accidental entre equipos.

Errores comunes

Los errores de sintaxis de expresiones son el problema más frecuente. Si una referencia a un campo como {{ $json.email }} devuelve undefined, comprueba que el nodo anterior realmente esté emitiendo esa clave. Usa el panel "Input" a la derecha del canvas para inspeccionar exactamente qué datos están entrando en cada nodo.

Otro error común es olvidar activar el workflow después de guardarlo. Un nodo trigger Webhook no escucha mientras el workflow está inactivo: el interruptor en la parte superior del canvas debe estar encendido.

Para nodos HTTP Request que llaman a APIs externas, cuidado con los desajustes de autenticación. Algunas APIs esperan la clave en un header (Authorization: Bearer ...), otras en un parámetro de consulta. Lee la documentación de la API y respeta exactamente el formato, luego usa el sistema de credenciales para inyectar el valor en lugar de hardcodearlo en la URL.

Resumen

La biblioteca de nodos te ofrece un kit de herramientas listo para usar que permite conectar servicios sin escribir código boilerplate de integración. Los nodos trigger inician workflows, los nodos de acción hacen el trabajo y las expresiones conectan datos entre ellos dinámicamente. Las credenciales se gestionan de forma centralizada, cifradas en reposo y son reutilizables entre workflows: mantenlas específicas por entorno y deja que n8n gestione por ti el baile de OAuth. Con estos fundamentos en su lugar puedes construir pipelines fiables y legibles que conectan aplicaciones reales.