Guide Pipedream

Ajouter un heartbeat Verifagent à un workflow Pipedream

Un workflow Pipedream peut s’arrêter si un compte connecté casse ou qu’une étape lève une erreur. Une dernière étape HTTP est votre heartbeat.

Avant de commencer

Créez un monitor avec la fréquence réelle de votre workflow, puis copiez son URL depuis le dashboard. Son token est secret : ne le publiez pas.

Module à utiliser : HTTP / Axios Request. Placez-le après la dernière action utile du chemin de succès.

Installation

Copiez l’URL du monitor

Créez un monitor pour la cadence ou le débit d’événements de ce workflow. Préférez une variable d’environnement ou un secret Pipedream pour l’URL.

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

Ajoutez une requête HTTP à la fin

Dans le builder, ajoutez une étape après la dernière étape métier. Choisissez HTTP / Axios Request (ou HTTP Request).

Configurez un GET vers Verifagent

Method GET, URL = votre URL de ping (depuis une env var). Aucun header d’auth requis. Continuez uniquement sur le chemin de succès.

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

# Étape code Node.js (après votre travail) :
import { axios } from "@pipedream/platform";

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

Testez le workflow

Lancez le workflow une fois. L’étape HTTP doit renvoyer 200 et {"ok":true}. Confirmez Up dans Verifagent.

{"ok":true}

Placez la requête après chaque effet de bord requis. Alignez la période attendue sur le trigger Pipedream ; ajoutez de la grâce pour les cold starts (souvent 5–15 minutes).

Routes disponibles

L’URL de base suffit pour un heartbeat. Les variantes enrichissent l’historique si votre plateforme gère plusieurs branches.

GET https://VOTRE_URL_DE_PING

POST https://VOTRE_URL_DE_PING/success

POST https://VOTRE_URL_DE_PING/fail?msg=Erreur

Vérification

Un run manuel crée un ping immédiat. Désactivez temporairement le trigger pour confirmer que Verifagent détecte le silence.

Réponse attendue : 200 {"ok":true}. Le monitor passe de Pending à Up.