Guía Activepieces

Añade un heartbeat de Verifagent a un flujo de Activepieces

Los flujos de Activepieces fallan en silencio cuando las conexiones caducan o un piece da error. Un piece HTTP final demuestra una ejecución de extremo a extremo correcta.

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 · Send Request. Colócalo después de la última acción útil en la ruta de éxito.

Configuración

Copia la URL del monitor

Crea un monitor por flujo. Copia la URL de ping desde Verifagent.

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

Añade HTTP · Send Request al final

Abre el constructor del flujo. Después del último piece de negocio, añade el piece HTTP y elige Send Request (el nombre puede variar ligeramente según la versión).

Configura la petición

Method GET, URL = tu URL de ping. Deja los headers vacíos salvo que pases por un proxy.

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

Prueba y publica

Usa Test flow / Run. Espera HTTP 200 y {"ok":true}, luego publica para que el calendario siga enviando heartbeats.

{"ok":true}

Mantén el piece HTTP solo en la rama de éxito. Alinea el periodo con el trigger del flujo; define el margen por encima de la latencia típica de los pieces.

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

Tras una ejecución de prueba correcta, el monitor está Up. Pausa el flujo: Verifagent debería abrir un incidente cuando pasen periodo + margen.

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