Canaux d'alerte

HelloCron peut vous notifier des événements liés à vos moniteurs (échecs, exécutions manquées, dépassements de délai, rétablissements) via plusieurs canaux. Vous pouvez configurer un nombre illimité de canaux et choisir quels types d’événements chaque canal reçoit.

Tous les canaux se gèrent dans le panneau sous Paramètres -> Canaux de notification. Chaque canal dispose d’un bouton Tester qui envoie une notification de test uniquement à ce canal, ce qui permet de vérifier la configuration avant de s’y fier.

Email

Le canal le plus simple. Laissez le champ d’adresse vide pour utiliser l’email de votre compte, ou saisissez une adresse différente (par exemple un alias d’équipe).

Telegram

Les alertes Telegram sont gratuites et instantanées, et la connexion tient en un clic.

1. Dans le panneau, ajoutez un canal de type Telegram et cliquez sur Connecter Telegram.
2. Scannez le QR code avec votre téléphone (ou cliquez sur Ouvrir dans Telegram) et appuyez sur Démarrer dans la discussion. Pour un groupe, utilisez Ajouter à un groupe et choisissez le groupe.
3. Le formulaire se remplit tout seul et affiche « Connecté ». Enregistrez le canal et cliquez sur Test.

Les alertes sont livrées par le bot officiel HelloCron. Pas de token, pas de chat ID, rien à chercher.

Avancé : votre propre bot. Si vous préférez que les alertes viennent d’un bot sous votre contrôle, dépliez Avancé : votre propre bot dans le formulaire : créez un bot via @BotFather (/newbot, copiez le token au format 123456789:AAF...), récupérez le chat ID sur https://api.telegram.org/bot<TOKEN>/getUpdates (les ID de groupes sont négatifs) et remplissez les deux champs. Un canal avec son propre token envoie toujours via ce bot. HelloCron ne conserve le token que pour la livraison et ne l’écrit jamais dans les logs.

Discord

Les alertes Discord utilisent les webhooks de canal, aucun bot n’est nécessaire.

1. Dans Discord, ouvrez les paramètres du canal cible : Intégrations -> Webhooks -> Nouveau webhook.
2. Copiez l’URL du webhook (elle commence par https://discord.com/api/webhooks/).
3. Dans le panneau, ajoutez un canal de type Discord et collez l’URL.
4. Cliquez sur Tester. Les alertes arrivent sous forme d’embeds, en vert pour les rétablissements et en rouge pour les échecs.

Slack

1. Créez un webhook entrant dans votre espace de travail Slack.
2. Dans le panneau, ajoutez un canal de type Slack et collez l’URL du webhook (elle commence par https://hooks.slack.com/services/).
3. Cliquez sur Tester.

PagerDuty

Les alertes PagerDuty utilisent l’Events API v2 : les pannes ouvrent des incidents et les rétablissements les résolvent automatiquement.

1. Dans PagerDuty, créez un service (ou ouvrez un service existant) et ajoutez une intégration Events API v2 : Service -> Integrations -> Add integration -> Events API v2.
2. Copiez l’Integration Key (aussi appelée routing key, 32 caractères).
3. Dans le panneau, ajoutez un canal de type PagerDuty et collez la clé.
4. Cliquez sur Test.

Correspondance des événements :

• Failed, Missed et Timeout déclenchent un incident de sévérité critical ; Degraded et Still failing utilisent warning.
• Recovered résout l’incident ouvert pour ce moniteur grâce à une clé de déduplication partagée : un moniteur instable n’empile jamais les incidents.
• Chaque incident contient un lien vers le moniteur dans le panneau HelloCron.

Webhook

Envoie une charge utile JSON à n’importe quel point de terminaison HTTP, utile pour s’intégrer à vos propres systèmes, outils d’astreinte, ou automatisations.

{
  "id": 123,
  "type": "failed",
  "monitor_name": "db-backup",
  "message": "Monitor db-backup failed",
  "metadata": {},
  "occurred_at": "2026-07-24T18:00:00+00:00"
}

• Méthode : POST (par défaut) ou GET (charge utile en paramètres de requête).
• En-têtes personnalisés : un par ligne au format Header-Name: value, par exemple un en-tête Authorization pour votre point de terminaison.
• Les URL de webhook Slack et Discord sont rejetées ici volontairement : leurs API attendent un format de charge utile différent. Utilisez plutôt le type de canal dédié Slack ou Discord.

Groupes de notifications

Un groupe de notifications est un ensemble nommé de canaux. Un moniteur affecté à un groupe n’alerte que les canaux de ce groupe ; les moniteurs sans groupe gardent le comportement par défaut et alertent tous les canaux actifs du compte.

Configuration typique : un groupe « backups » pointant vers un chat Telegram dédié et un groupe « www » pointant vers le webhook d’astreinte. Un compte pouvant avoir plusieurs canaux du même type, chaque groupe peut viser son propre chat Telegram.

Gérez les groupes dans Paramètres -> Canaux de notification -> Gérer les groupes : créez un groupe, cochez ses canaux et attachez les moniteurs (ping comme checks HTTP/SSL) sur la même page. Le groupe se choisit aussi dans l’édition d’un moniteur.

Deux détails à connaître :

• Un groupe sans canaux rend ses moniteurs silencieux hors du panneau (la cloche de l’application fonctionne toujours). Le panneau vous en avertit.
• Supprimer un groupe ne supprime rien d’autre : ses moniteurs reviennent à tous les canaux du compte.

Dans les manifestes config-as-code, le groupe voyage sous notification_group (le nom du groupe). Omettre la clé détache le groupe ; les noms inconnus sont rejetés avec le code d’erreur notification_group_invalid.

Types d’événements

Chaque canal s’abonne à un sous-ensemble de types d’événements :