Guide Activepieces

Ajouter un heartbeat Verifagent à un flow Activepieces

Les flows Activepieces échouent en silence quand une connexion expire ou qu’une piece plante. Une dernière piece HTTP prouve un run bout-en-bout réussi.

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 · Send 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 par flow. Copiez l’URL de ping depuis Verifagent.

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

Ajoutez HTTP · Send Request à la fin

Ouvrez le flow builder. Après la dernière piece métier, ajoutez la piece HTTP et choisissez Send Request (le libellé peut varier selon la version).

Configurez la requête

Method GET, URL = votre URL de ping. Laissez les headers vides sauf si vous passez par un proxy.

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

Testez et publiez

Utilisez Test flow / Run. Attendez HTTP 200 et {"ok":true}, puis publiez pour que le planning continue d’envoyer des heartbeats.

{"ok":true}

Gardez la piece HTTP uniquement sur la branche de succès. Alignez la période sur le trigger du flow ; réglez la grâce au-dessus de la latence typique des pieces.

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

Après un test réussi, le monitor est Up. Mettez le flow en pause : Verifagent doit ouvrir un incident une fois période + grâce écoulées.

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