Documentación de n8n

Guía completa para usar n8n en tu Servidor N8N de RedVozTelecom. Aprende a crear flujos de trabajo visuales, conectar nodos, usar webhooks y automatizar tus procesos.

Introducción

n8n (nodemation) es una plataforma de automatización de código abierto que te permite conectar aplicaciones, APIs y servicios mediante un editor visual de flujos de trabajo. Con n8n puedes:

Automatizar tareas repetitivas entre diferentes servicios
Conectar +400 aplicaciones y APIs sin programar
Ejecutar flujos en tu propio servidor sin límites ni costos por uso
Programar tareas, recibir webhooks y procesar datos en tiempo real

Tu Servidor N8N de RedVozTelecom viene preinstalado y configurado. Solo inicia sesión en n8n.crm.redvozchat.com y empieza a automatizar.

Cómo empezar

1. Inicia sesión

Ve a n8n.crm.redvozchat.com e ingresa con tu usuario y clave de RedVozTelecom. Una vez dentro, verás el panel principal con el editor visual de flujos.

2. Conoce la interfaz

El editor tiene 3 áreas principales:

Panel lateral izquierdo: Lista de nodos disponibles (Trigger, Actions, Transformación, etc.)
Lienzo central: Aquí arrastras, conectas y organizas tus nodos visualmente
Panel de ejecución: Muestra el resultado de cada paso cuando ejecutas el flujo

3. Crea tu primer flujo

Arrastra un nodo Manual Trigger al lienzo. Luego arrastra un nodo Set y conéctalo al trigger. Configura el nodo Set con un campo de prueba. Haz clic en Execute Workflow para probarlo.

💡 Tip: Puedes empezar con las plantillas preconfiguradas que vienen con n8n. Ve a Templates en el menú lateral y elige una que se ajuste a tu necesidad.

Crear flujos de trabajo

Un flujo de trabajo en n8n es una secuencia de nodos conectados entre sí. Cada nodo realiza una acción específica y pasa los datos al siguiente nodo.

Estructura básica de un flujo

Trigger → Filtro/Condición → Acción 1 → Acción 2 → Respuesta

Tipos de nodos

Tipo	Descripción	Ejemplos
Trigger	Inician el flujo cuando ocurre un evento	Webhook, Cron, Email, Formulario
Action	Realizan una operación en un servicio	Enviar email, Crear registro, Subir archivo
Transform	Modifican o filtran datos	Set, Code, Filter, Aggregate
Flow	Controlan la lógica del flujo	IF, Switch, Merge, Loop, Wait
Output	Devuelven o almacenan resultados	Respond to Webhook, Return Data

Ejemplo: Guardar emails entrantes en Google Sheets

Arrastra nodo Email Trigger (IMAP) - configúralo con tu correo
Arrastra nodo Set - mapea los campos del email (asunto, remitente, cuerpo)
Arrastra nodo Google Sheets - conéctalo a tu cuenta y selecciona la hoja
Conecta los nodos: Email Trigger → Set → Google Sheets
Activa el flujo y ¡listo!

Nodos populares

n8n incluye +400 nodos nativos. Estos son los más utilizados:

Nodo	Qué hace
Webhook	Recibe datos de cualquier sistema mediante HTTP
HTTP Request	Hace peticiones a cualquier API REST
Gmail / Outlook / SMTP	Envía y recibe correos electrónicos
Google Sheets / Airtable / Notion	Lee y escribe en hojas de cálculo y bases de datos
Slack / Discord / Telegram	Envía mensajes a canales y grupos
WhatsApp Business	Envía y recibe mensajes de WhatsApp
MySQL / PostgreSQL / MongoDB	Consulta y modifica bases de datos
OpenAI / Claude / Gemini	Usa modelos de IA en tus flujos
Stripe / PayPal / MercadoPago	Procesa pagos y consulta transacciones
GitHub / GitLab	Automatiza repositorios y CI/CD
RSS / Cron / Schedule	Programa ejecuciones periódicas

🔌 ¿No encuentras el nodo que necesitas? Usa el nodo HTTP Request para conectar cualquier API REST personalizada, o Code para escribir JavaScript o Python.

Webhooks y APIs

Los webhooks permiten que servicios externos envíen datos a tu flujo de n8n en tiempo real. Cada nodo Webhook genera una URL única que puedes configurar en cualquier sistema.

Cómo usar un Webhook

Arrastra un nodo Webhook al lienzo
Copia la URL que genera (ej: https://n8n.crm.redvozchat.com/webhook/abc123)
Configura el servicio externo para que envíe datos a esa URL
Conecta el Webhook a otros nodos para procesar la información

Llamar APIs externas

Usa el nodo HTTP Request para llamar cualquier API REST. Soporta GET, POST, PUT, PATCH, DELETE, headers personalizados y autenticación (Basic, OAuth, API Key, Bearer Token).

// Ejemplo: Llamar una API con HTTP Request
{
  "method": "GET",
  "url": "https://api.ejemplo.com/v1/datos",
  "headers": {
    "Authorization": "Bearer {{ $credentials.apiKey }}"
  }
}

n8n + Inteligencia Artificial

n8n se integra con los principales modelos de IA para que puedas automatizar tareas inteligentes:

Modelo	Qué puedes hacer
OpenAI (GPT)	Generar textos, clasificar contenido, responder preguntas, traducir
Anthropic (Claude)	Análisis de documentos, resúmenes, generación de informes
Google (Gemini)	Procesar imágenes, análisis multimodal
Hugging Face	Modelos open-source de NLP, clasificación, traducción

Para conectar tu propia API key, ve a Settings → Credentials en n8n y agrega la del servicio que quieras usar.

🤖 Ejemplo: Crea un flujo que reciba un email, extraiga el texto, lo envíe a OpenAI para clasificarlo (urgencia/departamento) y lo redirija al Slack del equipo correspondiente.

🍳 Recetas paso a paso

Tres flujos completos para que copies y adaptes. Cada paso es un nodo.

1) Formulario web → Google Sheets → aviso por Telegram

Agregá un nodo Webhook y copiá su URL en el formulario de tu sitio (método POST).
Conectá un nodo Google Sheets → Append Row y mapeá los campos del formulario a las columnas.
Sumá un nodo Telegram → Send Message con el texto: "Nuevo lead: {{ $json.nombre }} - {{ $json.email }}".
Activá el flujo (botón Active arriba a la derecha). Listo: cada envío cae en la hoja y te avisa.

Webhook → Google Sheets → Telegram

2) Mensaje de WhatsApp → respuesta con IA

Nodo disparador de tu canal de WhatsApp (o un Webhook si llega por tu CRM).
Nodo OpenAI (o Anthropic / Claude): en el prompt pasá el mensaje del cliente y pedí un borrador de respuesta corto.
Nodo de envío de WhatsApp con el texto generado, o guardalo como borrador para revisión.

WhatsApp → IA → Respuesta

3) Reporte diario programado

Nodo Schedule Trigger configurado a las 8:00 AM todos los días.
Nodo de base de datos (MySQL / Postgres) con la consulta de ventas del día anterior.
Nodo OpenAI que arma un resumen en lenguaje natural.
Nodo Gmail / Email que te lo manda. Opcional: también a Telegram.

Schedule → DB → IA → Email

⚠️ Manejo de errores y reintentos

Que un servicio falle no significa que pierdas el dato. n8n te da varias redes de seguridad:

Retry On Fail: en cualquier nodo, activá Settings → Retry On Fail y definí cuántos reintentos y cada cuánto. Ideal para APIs que a veces tardan.
Continue On Fail: hace que el flujo siga aunque un nodo falle, para que un error no frene todo lo demás.
Error Workflow: creá un flujo aparte con el nodo Error Trigger y asignalo en Settings del flujo principal. Cada vez que algo falle, te avisa por correo o WhatsApp con el detalle.

💡 Recomendado: tené un único "flujo de errores" con Error Trigger → mensaje a tu Telegram. Asignalo a todos tus flujos importantes y te enterás al instante de cualquier falla.

💾 Respaldos y restauración

Tus flujos son tuyos y los podés guardar fuera del servidor en cualquier momento.

Exportar un flujo: abrilo, menú ··· → Download. Se baja un archivo .json con todo el flujo.
Importar: menú ··· → Import from File y elegí el .json. Útil para mover flujos entre instancias o restaurar.
Credenciales: por seguridad NO se exportan con el flujo; las volvés a cargar una sola vez al importar.

💡 Buena práctica: guardá los .json de tus flujos en Google Drive o GitHub. En tu plan ya incluimos respaldos periódicos del servidor, pero tener tus flujos aparte nunca está de más.

🔐 Seguridad y buenas prácticas

Credenciales, no texto plano: guardá claves y tokens en Credentials de n8n (van cifradas), nunca pegadas dentro de un nodo.
Protegé tus webhooks: usá una URL difícil de adivinar y validá un token o firma en el primer nodo antes de procesar.
Acceso: usá una contraseña fuerte y, si tu plan lo permite, sumá usuarios con roles en vez de compartir una sola cuenta.
HTTPS siempre: tu instancia ya viene con certificado; no expongas el panel por HTTP plano.
Mínimos permisos: en cada integración, dale a la credencial solo los permisos que el flujo necesita.

📈 Monitoreo y registros de ejecución

Cada vez que un flujo corre, n8n guarda el registro para que veas exactamente qué pasó.

Executions: en el menú lateral ves todas las ejecuciones, con estado éxito o error y la fecha.
Ver el detalle: hacé clic en una ejecución para ver qué entró y qué salió en cada nodo. Perfecto para depurar.
Re-ejecutar: podés volver a correr una ejecución que falló, sin rearmar nada.
Alertas: combiná con el Error Workflow para recibir un aviso automático cuando algo falla.

⚡ Optimización de rendimiento

Procesá en lotes: con Split In Batches recorrés muchos registros sin saturar la memoria.
Paginá las APIs: traé los datos de a páginas en vez de todo de golpe.
Evitá bucles pesados: usá nodos nativos (filtros, merge, set) en lugar de mucho código cuando se pueda.
Programá lo pesado: corré reportes o sincronizaciones grandes en horarios de poco uso con Schedule Trigger.
Limpiá ejecuciones viejas: si guardás muchísimas, archivá o reducí la retención para liberar espacio.

💡 Si un flujo procesa miles de filas, Split In Batches + paginación es la diferencia entre que vuele o que se quede sin memoria.

🛠️ Solución de problemas comunes

Síntoma	Causa probable	Solución
El webhook no dispara	Flujo inactivo o URL mal copiada	Activá el flujo y usá la URL de producción, no la de test
Error 401 / 403 en un nodo	Credencial vencida o sin permisos	Reconectá la credencial y revisá los permisos en la app
El nodo "tarda mucho" o corta	Trae demasiados datos de una vez	Paginá y usá `Split In Batches`
La IA responde raro o vacío	Prompt poco claro o falta el dato	Revisá que el prompt reciba bien `{{ $json.campo }}`
No encuentro una ejecución	Retención de logs corta	Revisá la lista de Executions; aumentá la retención si hace falta

💡 ¿Algo no funciona y no sabés por qué? Abrí la ejecución en Executions y mirá nodo por nodo: el que está en rojo te dice exactamente dónde se rompió.

Preguntas frecuentes

¿Puedo exportar e importar flujos?

Sí. Cada flujo se puede exportar como archivo JSON desde el botón ··· → Export. Para importar, usa ··· → Import en el editor.

¿Cómo gestiono las credenciales?

Ve a Settings → Credentials en n8n. Ahí puedes agregar, editar y eliminar credenciales para cada servicio. n8n las encripta automáticamente.

¿Puedo programar un flujo para que se ejecute cada cierto tiempo?

Sí. Usa el nodo Schedule Trigger o Cron para ejecutar flujos cada X minutos, horas, días o en fechas específicas.

¿Cómo recupero mi contraseña de n8n?

Usa el enlace de "Olvidé mi contraseña" en la pantalla de inicio de sesión de n8n.crm.redvozchat.com. Si tienes problemas, abre un ticket en Soporte.

¿Puedo tener múltiples usuarios en mi Servidor N8N?

Sí. Dependiendo de tu plan, puedes tener múltiples instancias y usuarios. Si necesitas más, solicita un plan personalizado.

¿Hay límite de flujos activos?

Cada plan tiene un límite de flujos activos. Consulta los Planes Servidores N8N para más detalles.

Glosario

Término	Definición
Flujo (Workflow)	Secuencia de nodos conectados que realizan una automatización
Nodo	Componente individual que realiza una acción (trigger, acción, transformación)
Trigger	Nodo que inicia el flujo cuando ocurre un evento
Webhook	URL que recibe datos de sistemas externos en tiempo real
Credencial	Claves de acceso (API key, token, contraseña) para conectar servicios
Ejecución	Cada vez que un flujo se activa y corre de principio a fin
Instancia	Copias separadas de n8n. Cada instancia tiene sus propios flujos y credenciales
n8n	Plataforma de automatización de código abierto (nodemation)

¿Necesitas ayuda? Abre un ticket en nuestro sistema de soporte y te responderemos en menos de 24 horas. También puedes escribir a Servicio@RedVozTelecom.com.