n8n
Conecte n8n con una clave de API y una URL de webhook para que un agente pueda iniciar su flujo de trabajo durante una llamada.
Qué conseguirá
n8n mostrará Connected y sabrá cómo se inician los flujos de trabajo.
Descripción general y casos de uso
La conexión puede enumerar sus flujos de trabajo y sus ejecuciones, e iniciar un flujo mediante su disparador Webhook. Así n8n puede llegar a cientos de aplicaciones más.
Requisitos previos
- Una instancia de n8n (en la nube o autoalojada) con la API pública activada. La API de n8n no está disponible en la prueba gratuita.
- Un flujo de trabajo que empiece con un nodo Webhook, si quiere iniciar flujos.
Configuración de la cuenta externa (en n8n)
n8n controla estas pantallas. La guía de n8n: API authentication.
- En n8n, elija Settings, n8n API y Create an API key. Cópiela.
- Para un flujo que quiera iniciar: abra su nodo Webhook y copie la Production URL (contiene
/webhook/). No use la Test URL (/webhook-test/): solo responde mientras el editor está abierto y escuchando, así que las llamadas a ella fallan al azar. - Si el nodo Webhook usa Header Auth, anote el nombre y el valor de la cabecera.
Conéctelo en Phynxa
- Integrations, Connect en n8n.
- Escriba la Instance URL (por ejemplo
https://acme.app.n8n.cloud) y la API key. - Opcionalmente escriba Webhook URL, Webhook auth header y Webhook auth value.
- Elija Check and connect.
Permisos y ajustes
| Campo | Significado |
|---|---|
| Instance URL | La dirección de su n8n. Se tolera una ruta de API pegada o un host sin más. |
| API key | Se envía en la cabecera X-N8N-API-KEY a <instance>/api/v1. Obligatoria. |
| Webhook URL | Opcional. La URL de Production del flujo. |
| Webhook auth header / value | Opcional. Para un nodo Webhook con Header Auth. La clave de API nunca se envía al webhook. |
Se rechazan las direcciones http sin cifrar y las direcciones de redes privadas.
Úselo en una llamada
En la pestaña Tools de un agente, Add tool, Integration, n8n:
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Trigger workflow | Inicia el flujo de trabajo cuyo URL de webhook guardó con la conexión y le entrega el name, el phone, el email y los details de quien llama. El agente no puede elegir otro flujo ni otra dirección. | En segundo plano |
El flujo los recibe como campos en su nodo Webhook. Listar flujos y ejecuciones se queda en el panel y no se ofrece a los agentes.
Pruébelo
Test connection debe responder «n8n is responding.»
Resultado esperado
La tarjeta muestra Connected.
Solución de problemas
- La comprobación falla con 401. La clave de API es incorrecta, o la API pública no está activada en su plan.
- «Could not reach the service.» Revise la URL de la instancia y que sea accesible desde internet.
- Una llamada al webhook falla a veces. Usó la Test URL; cambie a la Production URL y active el flujo.
Seguridad y credenciales
La clave de API y el valor del webhook se almacenan cifrados. Revoque la clave en n8n para cortar el acceso. Remove los elimina aquí.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.