Guía Pipedream

Añade un heartbeat de Verifagent a un workflow de Pipedream

Los workflows de Pipedream pueden detenerse cuando una cuenta conectada falla o un paso lanza error. Un paso HTTP final es tu heartbeat.

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 / Axios 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 para el calendario o la tasa de eventos de este workflow. Prefiere una variable de entorno o secret de Pipedream para la URL.

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

Añade una petición HTTP al final

En el constructor del workflow, añade un paso después del último paso de negocio. Elige HTTP / Axios Request (o HTTP Request).

Configura GET hacia Verifagent

Method GET, URL = tu URL de ping (desde una variable de entorno). No hacen falta headers de auth. Continúa solo en la ruta de éxito.

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

# Paso de código Node.js (después de tu trabajo):
import { axios } from "@pipedream/platform";

await axios($, {
  method: "GET",
  url: process.env.VERIFAGENT_URL,
});

Prueba el workflow

Ejecuta el workflow una vez. El paso HTTP debería devolver 200 y {"ok":true}. Confirma Up en Verifagent.

{"ok":true}

Coloca la petición después de cada efecto secundario obligatorio. Ajusta el periodo esperado al trigger de Pipedream; añade margen para cold starts (a menudo 5–15 minutos).

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

Una ejecución manual crea un ping inmediato. Desactiva temporalmente el trigger para confirmar que Verifagent detecta el silencio.

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