API de n8n: qué puedes hacer y cómo usarla con agentes de IA
n8n es una herramienta de automatización de flujos que se puede usar en la nube o instalar en el servidor de la empresa. Su API pública permite gestionar workflows y ejecuciones, y cada workflow puede exponer un webhook propio. La usan equipos técnicos que ya tienen automatizaciones y quieren activarlas desde otros sistemas.
Qué ofrece la API de n8n
Workflows
Listado, creación, activación y desactivación de workflows.
Ejecuciones
Consulta del historial y del resultado de las ejecuciones.
Webhooks de workflow
Disparadores HTTP que inician un workflow con los datos enviados.
Credenciales
Gestión de las credenciales que usan los workflows.
Etiquetas y proyectos
Organización de los workflows por etiqueta o proyecto.
Cómo acceder a la API de n8n
- Con las credenciales de tu empresaLa API pública usa una clave de API creada en la configuración de n8n. Los webhooks de workflow pueden tener su propia autenticación, como una cabecera o autenticación básica.
- La disponibilidad de la API pública puede variar según el plan y la versión de n8n.
- Los webhooks sin autenticación pueden ser activados por cualquiera: protégelos.
- En una instalación propia, mantén n8n actualizado y con acceso restringido.
Documentación oficial: docs.n8n.io/api
Qué hace un agente de iTeam con la API de n8n
Reutilizar automatizaciones que ya funcionan
A partir de una petición en lenguaje natural, el agente activa los workflows que la empresa ya mantiene en n8n, como generar una propuesta o sincronizar un registro.
Vigilar las ejecuciones con error
El agente consulta las ejecuciones que fallaron, resume el error y avisa al responsable del workflow.
Un paso humano dentro del flujo
Cuando el workflow necesita una decisión, llama a iTeam, el agente pide la aprobación al responsable y devuelve la respuesta.
Inventario de automatizaciones
El agente lista los workflows activos, sin responsable o detenidos desde hace tiempo, para que el equipo los revise.
De la credencial al agente trabajando, con aprobación
Genera la clave de la API y mapea los webhooks
En n8n, crea la clave de API e identifica los webhooks de los workflows que el agente podrá activar.
Regístrala en la bóveda de iTeam
La clave y las URL quedan en la bóveda. Cada agente recibe la lista exacta de workflows que puede lanzar.
Prueba con datos de ejemplo
Ejecuta cada workflow con datos de prueba, revisa la respuesta y mantén la aprobación en los que mueven dinero o afectan a clientes.
Equipos de IA listos para este trabajo
Reportes e indicadores
Nina junta los datos, Darwin revisa los números y el informe de indicadores llega a Slack con lo que cambió y por qué.
Gestión de inventario
Nina vigila cada referencia, Darwin calcula cuánto reponer y la orden de compra sale solo cuando una persona la aprueba.
Compras y cotizaciones
Darwin pide cotizaciones y las compara en una tabla, Henry revisa las condiciones y la orden de compra sale con la aprobación registrada.
Logística y entregas
Nina arma las rutas y sigue a cada conductor por WhatsApp; Jaca avisa al cliente del estado de su pedido antes de que llame.
Preguntas sobre la API de n8n
¿La API de n8n es gratuita?
Depende de cómo se use n8n. En la versión instalada por la empresa, el costo es la infraestructura. En la nube, sigue el plan contratado. Revisa las condiciones de tu edición.
¿Necesito programar para usar la API de n8n con iTeam?
No necesariamente. iTeam lee la documentación y las URL de los webhooks, y el equipo de implantación conecta los workflows con los agentes.
¿Por qué usar iTeam si ya tengo n8n?
n8n ejecuta flujos definidos. El agente de iTeam entiende las peticiones, decide qué flujo usar, pide aprobación y conversa con las personas. Los dos se complementan.
