Être alerté quand les leads n'arrivent plus
Un scénario Make ou un workflow n8n peut continuer de tourner sans rien envoyer : un jeton expiré, un formulaire modifié, une source vide. Klozeo voit les leads qui arrivent vraiment. Réglez une alerte sur la clé API qu’utilise un scénario, et Klozeo vous prévient quand aucun lead n’est reçu par elle depuis plus longtemps que prévu, puis quand les leads reviennent.
Pour l’instant, ces alertes sont des événements webhook, que vous pouvez envoyer vers Slack, n8n ou Make. Les alertes par email arriveront dans une prochaine version.
Fonctionnement
Section intitulée « Fonctionnement »- Une clé API par scénario. L’alerte surveille une clé. Si plusieurs scénarios partagent une clé, l’un d’eux peut s’arrêter sans que l’alerte le voie. Donnez à chaque scénario sa propre clé.
- Un lead reçu est un lead créé ou fusionné par la clé. Les mises à jour, les notes et les lectures ne comptent pas.
- L’écart maximal est un nombre entier d’heures, de 1 à 720. Il ne compte que les jours actifs de la clé, dans le fuseau horaire de l’espace de travail : avec du lundi au vendredi, un week-end sans lead ne déclenche rien.
- Le propriétaire ou un admin peut modifier le fuseau horaire de l’espace de travail. Après un changement, la vérification suivante recompte tout le silence en cours dans le nouveau fuseau.
- Klozeo vérifie toutes les 15 minutes. Une alerte vous parvient au plus environ 15 minutes après le dépassement de l’écart.
- Une clé qui n’a jamais reçu de lead n’alerte jamais. Le silence part du dernier lead reçu par la clé, ou du moment où vous réglez l’alerte s’il est plus récent.
- Une alerte par silence. Vous recevez un
source.silent, puis unsource.recoveredau premier lead reçu ensuite, jamais de relance entre les deux.
Sources entrantes : quand vous renouvelez l’adresse d’une source, ses réglages d’alerte et une éventuelle coupure en cours passent sur la nouvelle adresse, et le silence continue d’être compté depuis le dernier lead de la source. L’ancienne adresse n’est plus surveillée.
Avant de commencer
Section intitulée « Avant de commencer »Il vous faut :
- une clé API de portée full, créée par le propriétaire de l’espace de travail ou un admin. Les clés de lecture et d’écriture reçoivent
403sur ces routes ; - l’identifiant de la clé à surveiller.
GET /api-keysliste les clés de l’espace de travail avec leurid.
Chaque requête ci-dessous envoie la clé full dans l’en-tête X-API-Key.
1. Choisir l’écart maximal
Section intitulée « 1. Choisir l’écart maximal »Klozeo peut suggérer un écart d’après l’historique de la clé :
curl https://api.klozeo.com/api/v1/api-keys/KEY_ID/alert \ -H "X-API-Key: sk_live_..."{ "api_key_id": "KEY_ID", "time_zone": "Europe/Paris", "settings": { "mode": "off", "max_gap_hours": null, "active_days": ["mon", "tue", "wed", "thu", "fri", "sat", "sun"], "snoozed_until": null }, "suggestion": { "state": "ready", "max_gap_hours": 6, "sessions": 41, "history_days": 30, "window_days": 14 }}time_zone est le fuseau horaire de l’espace de travail, celui dans lequel active_days est compté. Il est en lecture seule : vous ne l’envoyez pas avec PUT.
La suggestion est prête quand la clé reçoit des leads depuis au moins 14 jours, en au moins 8 sessions (des leads à moins de 10 minutes d’écart forment une session). Avant, state vaut insufficient_history. Klozeo ne l’applique jamais à votre place.
2. Régler l’alerte
Section intitulée « 2. Régler l’alerte »curl -X PUT https://api.klozeo.com/api/v1/api-keys/KEY_ID/alert \ -H "X-API-Key: sk_live_..." \ -H "Content-Type: application/json" \ -d '{ "mode": "manual", "max_gap_hours": 6, "active_days": ["mon", "tue", "wed", "thu", "fri"], "snoozed_until": null }'| Champ | Valeur |
|---|---|
mode |
manual pour alerter, off pour arrêter. Passer à off termine un silence en cours sans événement. |
max_gap_hours |
Obligatoire avec manual : de 1 à 720. |
active_days |
Les jours où le silence compte, dans le fuseau horaire de l’espace de travail. Absent : tous les jours. |
snoozed_until |
Pause facultative, au plus 7 jours à l’avance. Absent ou null : pas de pause. |
PUT remplace tous les réglages : envoyez chaque champ à chaque fois, sinon ceux que vous omettez reprennent leur valeur par défaut.
Mettre l’alerte en pause
Section intitulée « Mettre l’alerte en pause »Pendant un arrêt prévu, renvoyez les mêmes réglages avec une pause :
{ "mode": "manual", "max_gap_hours": 6, "active_days": ["mon", "tue", "wed", "thu", "fri"], "snoozed_until": "2026-11-20T08:00:00Z" }Rien n’est envoyé pendant la pause. Si les leads n’arrivent toujours pas à sa fin, un source.silent suit. Envoyez "snoozed_until": null pour terminer la pause plus tôt.
Vérifier vos clés
Section intitulée « Vérifier vos clés »GET /api-keys/health donne l’état de chaque clé (ok, silent, snoozed, no_lead_received, unmonitored ou disabled) et son dernier lead reçu. GET /api-keys/incidents liste les silences encore ouverts. Ajoutez ?state=all pour y inclure ceux qui sont clos, sur les 13 derniers mois.
3. Choisir où vont les alertes
Section intitulée « 3. Choisir où vont les alertes »Créez un webhook qui nomme les deux événements. "*" ne les inclut jamais : un webhook ne les reçoit que si son events les cite.
curl -X POST https://api.klozeo.com/api/v1/webhooks \ -H "X-API-Key: sk_live_..." \ -H "Content-Type: application/json" \ -d '{ "url": "VOTRE_URL", "events": ["source.silent", "source.recovered"] }'Un seul webhook couvre toutes les clés de l’espace de travail. Utilisez le nom de la clé dans le message pour les distinguer.
Slack, en direct
Section intitulée « Slack, en direct »Créez dans Slack un webhook entrant pour le canal voulu, puis utilisez son URL (https://hooks.slack.com/services/...) comme url. Klozeo publie un message court, en anglais :
Klozeo: leads stopped arriving API key: Make: formulaire du site Workspace: Acme Silent since: 16 Nov 2026, 08:12 UTC
source.recovered publie « Klozeo: leads are arriving again » avec Back at, l’heure du premier lead reçu ensuite. Les heures sont en UTC. Les URL de webhook Discord reçoivent le même message.
n8n ou Make
Section intitulée « n8n ou Make »Passez par n8n ou Make pour choisir votre texte et votre langue, un autre canal (Teams, email, SMS) ou d’autres étapes. Ils reçoivent ce corps :
{ "event": "source.silent", "payload": { "incident_id": "6f1c2a4e-0d8b-4c1e-9a57-3b2f6c1d9e10", "api_key": { "id": "KEY_ID", "name": "Make: formulaire du site" }, "workspace": { "id": "WORKSPACE_ID", "name": "Acme" }, "silent_since": "2026-11-16T08:12:00Z", "opened_at": "2026-11-16T14:15:00Z", "max_gap_hours": 6 }, "time": 1794838500}workspace.namevautnullquand l’espace de travail n’a pas de nom.silent_sinceest le dernier lead reçu avant le silence,opened_atle moment où Klozeo a constaté le dépassement de l’écart. Les heures sont en UTC.source.recoveredporte les mêmes champs, plusrecovered_at, l’heure du premier lead reçu ensuite. Sonincident_idest celui dusource.silentqu’il clôt.- La livraison est « au moins une fois ». Ignorez un doublon grâce à l’en-tête
X-Webhook-Event-ID.
Les URL que donnent n8n et Make sont le seul secret : quiconque en a une peut y envoyer des requêtes, gardez-la privée. Un secret sur le webhook signe chaque requête (voir Vérifier les signatures), pour un serveur à vous qui la vérifie.
Exemple n8n
Section intitulée « Exemple n8n »Ce workflow publie chaque alerte dans un canal Slack, avec votre propre texte. Dans n8n, ouvrez un nouveau workflow, collez le JSON ci-dessous sur le canevas, puis :
- Dans Klozeo alert, remplacez le chemin par une longue chaîne aléatoire.
- Dans Post to Slack, choisissez votre identifiant Slack et le canal.
- Cliquez sur Publish (Activate avant n8n 2.0), puis utilisez la Production URL du webhook comme
urldu webhook Klozeo.
{ "name": "Alertes de flux de leads Klozeo", "nodes": [ { "parameters": { "httpMethod": "POST", "path": "klozeo-alertes-remplacez-par-une-longue-chaine-aleatoire", "options": {} }, "name": "Klozeo alert", "type": "n8n-nodes-base.webhook", "typeVersion": 2, "position": [0, 0] }, { "parameters": { "select": "channel", "channelId": { "__rl": true, "value": "", "mode": "list" }, "text": "={{ $json.body.event === 'source.silent' ? ':red_circle: Aucun lead reçu par *' + $json.body.payload.api_key.name + '* depuis le ' + DateTime.fromISO($json.body.payload.silent_since).setZone('Europe/Paris').toFormat(\"dd/MM/yyyy 'à' HH:mm\") : ':large_green_circle: Les leads arrivent de nouveau par *' + $json.body.payload.api_key.name + '* depuis le ' + DateTime.fromISO($json.body.payload.recovered_at).setZone('Europe/Paris').toFormat(\"dd/MM/yyyy 'à' HH:mm\") }}{{ $json.body.payload.workspace.name ? ' · ' + $json.body.payload.workspace.name : '' }}", "otherOptions": {} }, "name": "Post to Slack", "type": "n8n-nodes-base.slack", "typeVersion": 2.2, "position": [260, 0] } ], "connections": { "Klozeo alert": { "main": [[{ "node": "Post to Slack", "type": "main", "index": 0 }]] } }}Le corps se trouve sous $json.body. Remplacez Post to Slack par n’importe quel nœud : Microsoft Teams, Gmail, Twilio. Les heures du corps sont en UTC, et le message les affiche en Europe/Paris : remplacez Europe/Paris par le fuseau horaire voulu, par exemple celui de votre espace de travail.
Exemple Make
Section intitulée « Exemple Make »Ce scénario publie chaque alerte dans un canal Slack, avec une route par événement.
-
Webhooks › Custom webhook. Cliquez sur Create a webhook et nommez-le
Alertes Klozeo. -
Dans la même fenêtre, activez Advanced settings, cliquez sur Create a data structure, puis sur Generate, et collez le corps
source.recoveredci-dessous. Cliquez sur Generate, puis sur Save dans les deux fenêtres. Make connaît alors chaque champ sans attendre une première alerte. Copiez l’adresse du webhook (https://hook.eu1.make.com/...) : c’est l’urldu webhook Klozeo.{"event": "source.recovered","payload": {"incident_id": "6f1c2a4e-0d8b-4c1e-9a57-3b2f6c1d9e10","api_key": { "id": "KEY_ID", "name": "Make: formulaire du site" },"workspace": { "id": "WORKSPACE_ID", "name": "Acme" },"silent_since": "2026-11-16T08:12:00Z","opened_at": "2026-11-16T14:15:00Z","recovered_at": "2026-11-16T16:40:00Z","max_gap_hours": 6},"time": 1794847200} -
Ajoutez un Router après le webhook, avec deux routes :
Route Filtre Slack › Send a Message, texte Arrêt eventEqual tosource.silent:red_circle: Aucun lead reçu par *{{1.payload.api_key.name}}* depuis le {{formatDate(1.payload.silent_since; "DD/MM/YYYY [à] HH:mm"; "Europe/Paris")}}{{if(1.payload.workspace.name; " · "; "")}}{{1.payload.workspace.name}}Reprise eventEqual tosource.recovered:large_green_circle: Les leads arrivent de nouveau par *{{1.payload.api_key.name}}* depuis le {{formatDate(1.payload.recovered_at; "DD/MM/YYYY [à] HH:mm"; "Europe/Paris")}}{{if(1.payload.workspace.name; " · "; "")}}{{1.payload.workspace.name}} -
Activez le scénario, en mode Immediately as data arrives.
1. est le numéro du module webhook. Si le vôtre diffère, sélectionnez les champs dans le panneau plutôt que de les taper. Les textes affichent les heures en Europe/Paris : remplacez "Europe/Paris" par le fuseau horaire voulu, par exemple celui de votre espace de travail.
Inutile d’attendre une vraie panne :
- Créez une clé de test de portée write et envoyez un lead avec elle (
POST /leads). Cette clé sert seulement à envoyer des leads : les requêtes ci-dessous utilisent toujours votre clé full. - Réglez une alerte sur cette clé avec
"max_gap_hours": 1et le jour même, dans le fuseau horaire de l’espace de travail, parmi sesactive_days. - Environ une heure plus tard, dans les 15 minutes qui suivent,
source.silentarrive. - Envoyez un autre lead avec la clé de test :
source.recoveredsuit dans les 15 minutes. - Supprimez le lead de test et révoquez la clé de test. Révoquer une clé termine son silence sans événement.
GET /webhooks/deliveries montre chaque livraison et la réponse renvoyée par votre URL.