Guía n8n

Añade un heartbeat a un workflow de n8n

Un nodo HTTP Request al final confirma que la ejecución ocurrió de verdad. Si n8n deja de iniciar el workflow, esa señal desaparece y Verifagent abre un incidente.

Antes de empezar

Crea un monitor con la frecuencia real de tu workflow y copia su URL desde el panel. Su token es secreto: no lo publiques.

Módulo a usar : HTTP Request. Colócalo después de la última acción útil en la ruta de éxito.

Configuración

Copia la URL del monitor

En Verifagent, abre la página del monitor y copia la URL de ping completa. Usa un monitor distinto por workflow.

https://verifagent.com/api/ping/your-ping-token

Añade HTTP Request al final

En el editor de n8n, añade un nodo HTTP Request después de la última acción de negocio. Conecta la salida principal de esa acción al nuevo nodo.

Configura la llamada

Elige Method GET, pega la URL, deja Authentication en None. No hacen falta headers ni body.

GET https://verifagent.com/api/ping/your-ping-token

Ejecuta el nodo

Haz clic en Execute step. n8n debería mostrar HTTP 200 y el cuerpo JSON devuelto por Verifagent.

{"ok":true}

Coloca el heartbeat después del último paso obligatorio, no en una rama lateral. Si varias ramas deben tener éxito, únelas antes del nodo HTTP Request.

Rutas disponibles

La URL base basta para un heartbeat. Las variantes enriquecen el historial si tu plataforma tiene varias ramas.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

POST https://YOUR_PING_URL/fail?msg=Error

Verificar

Ejecuta el workflow manualmente y vuelve a su página en Verifagent. El estado pasa a Up y la última señal muestra la hora de esta prueba.

Respuesta esperada: 200 {"ok":true}. El monitor pasa de Pending a Up.