Aller au contenu

Ê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.


  • 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 un source.recovered au 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.


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 403 sur ces routes ;
  • l’identifiant de la clé à surveiller. GET /api-keys liste les clés de l’espace de travail avec leur id.

Chaque requête ci-dessous envoie la clé full dans l’en-tête X-API-Key.


Klozeo peut suggérer un écart d’après l’historique de la clé :

Fenêtre de terminal
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.


Fenêtre de terminal
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.

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.

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.


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.

Fenêtre de terminal
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.

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.

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.name vaut null quand l’espace de travail n’a pas de nom.
  • silent_since est le dernier lead reçu avant le silence, opened_at le moment où Klozeo a constaté le dépassement de l’écart. Les heures sont en UTC.
  • source.recovered porte les mêmes champs, plus recovered_at, l’heure du premier lead reçu ensuite. Son incident_id est celui du source.silent qu’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.


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 :

  1. Dans Klozeo alert, remplacez le chemin par une longue chaîne aléatoire.
  2. Dans Post to Slack, choisissez votre identifiant Slack et le canal.
  3. Cliquez sur Publish (Activate avant n8n 2.0), puis utilisez la Production URL du webhook comme url du 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.


Ce scénario publie chaque alerte dans un canal Slack, avec une route par événement.

  1. Webhooks › Custom webhook. Cliquez sur Create a webhook et nommez-le Alertes Klozeo.

  2. Dans la même fenêtre, activez Advanced settings, cliquez sur Create a data structure, puis sur Generate, et collez le corps source.recovered ci-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’url du 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
    }
  3. Ajoutez un Router après le webhook, avec deux routes :

    Route Filtre Slack › Send a Message, texte
    Arrêt event Equal to source.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 event Equal to source.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}}
  4. 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 :

  1. 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.
  2. Réglez une alerte sur cette clé avec "max_gap_hours": 1 et le jour même, dans le fuseau horaire de l’espace de travail, parmi ses active_days.
  3. Environ une heure plus tard, dans les 15 minutes qui suivent, source.silent arrive.
  4. Envoyez un autre lead avec la clé de test : source.recovered suit dans les 15 minutes.
  5. 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.