Retour au blog

Bot Telegram ou API de notifications push pour vos alertes développeurs

Bot Telegram ou API de notifications push pour vos alertes développeurs

Demandez à une équipe de développeurs comment elle reçoit les alertes de ses scripts, et la moitié répondra « un bot Telegram ». C’est gratuit, Telegram est déjà sur le téléphone, et le premier message se configure en dix minutes.

C’est aussi une application de messagerie qui fait le travail d’un bipeur. Cela fonctionne jusqu’au moment où l’alerte importante arrive dans le même flux que les discussions de groupe, ou qu’un nom de fichier contenant un tiret bas casse le message. Cet article détaille honnêtement la mise en place de Telegram, ce qu’elle fait bien, ce qu’elle fait mal, et à quoi ressemble la même alerte envoyée via une API de notifications push.

La mise en place de Telegram, de A à Z

  1. Créez le bot. Écrivez à @BotFather, envoyez /newbot, puis choisissez un nom et un identifiant se terminant par bot. Vous obtenez un token du type 110201543:AAH....
  2. Dites bonjour en premier. Un bot ne peut pas initier une conversation : ouvrez-le et envoyez-lui un message quelconque. Pour un groupe, ajoutez le bot au groupe.
  3. Trouvez votre identifiant de chat. Appelez getUpdates et lisez message.chat.id dans le résultat :
curl -s "https://api.telegram.org/bot$TG_TOKEN/getUpdates" | jq '.result[].message.chat.id'

Les mises à jour sont conservées pendant 24 heures, et getUpdates cesse de fonctionner dès qu’un webhook est défini sur le bot. Les identifiants de groupe sont négatifs, et ceux des supergroupes commencent par -100.

  1. Envoyez l’alerte :
curl -s "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \
  -d chat_id="$TG_CHAT_ID" \
  -d text="Backup failed on db-01"

C’est toute l’intégration : deux secrets dans un fichier d’environnement et un appel HTTP.

Ce que Telegram fait bien

  • C’est gratuit. La FAQ de Telegram indique que les bots peuvent écrire à leurs utilisateurs sans frais.
  • Il est partout où vous êtes. Clients téléphone, ordinateur et web, toujours synchronisés.
  • Les groupes sont gratuits. Ajoutez le bot à un canal d’équipe : tout le monde voit l’alerte et peut en discuter dans le même fil.
  • Vous l’avez déjà ouvert. Pas de nouvelle application, pas de nouveau compte.

Pour les notifications peu critiques, comme « le rapport de nuit est prêt », c’est difficile à battre.

Là où ça se complique

Toutes les alertes sonnent pareil

L’API Bot ne propose qu’un seul réglage de remise : disable_notification, qui envoie un message sans son. Il n’existe ni priorité, ni niveau d’urgence, rien qui passe outre le mode Ne pas déranger. Une sauvegarde en échec à 3 h du matin arrive exactement comme un autocollant dans un groupe, et si vous coupez le son du chat pour échapper au bruit, vous coupez aussi les alertes.

La mise en forme vous jouera des tours

Avec parse_mode=MarkdownV2, les caractères _ * [ ] ( ) ~ > # + - = | { } . ! ainsi que l’apostrophe inverse doivent être échappés par une barre oblique inverse en dehors de la mise en forme. Or les alertes regorgent précisément de ces caractères : noms de fichiers, numéros de version, URL, traces d’exécution. Un seul point non échappé dans db-01.internal et Telegram rejette le message avec une erreur 400, si bien que l’alerte signalant la panne échoue elle aussi. Le mode HTML est plus sûr, mais vous devez tout de même échapper <, > et & dans tout ce que vous envoyez.

Le token, c’est le bot

Le token figure dans le chemin de l’URL de chaque requête, et la documentation de Telegram le dit clairement : quiconque le possède peut contrôler votre bot. En pratique, cette URL finit dans l’historique du shell, dans les journaux de CI et partout où des URL de requêtes sont consignées. En cas de fuite, /token dans BotFather en génère un nouveau, mais chaque script doit alors être mis à jour.

Les boutons exigent un bot en fonctionnement

Les boutons en ligne peuvent ouvrir une URL, ce qui convient. Un bouton qui déclenche une action, comme « redémarrer le service », utilise callback_data, et l’appui affiche un spinner jusqu’à ce que votre bot y réponde. Il faut donc un processus à l’écoute des mises à jour en permanence, ce qu’une tâche cron n’a pas vocation à gérer.

Les rafales atteignent les limites de débit

Telegram demande aux bots de rester sous un message par seconde et par chat, et sous 20 messages par minute dans un groupe. Branchez un webhook bavard sur un groupe et vous obtenez 429 Too Many Requests avec une valeur retry_after, au moment précis où tout va mal et où les alertes affluent le plus vite.

Les services ne peuvent pas publier directement

GitHub, Stripe, Grafana et Sentry envoient leurs webhooks avec leur propre JSON. L’API Bot attend un chat_id et un text. Il faut un intermédiaire pour traduire : un petit serveur, une fonction serverless, ou un flux n8n ou Zapier. Ce relais est une chose de plus à faire tourner.

Les alertes vivent dans une messagerie

Les messages du bot sont des messages Telegram ordinaires, stockés par Telegram et mélangés à vos conversations personnelles. Pour retrouver les incidents du mois dernier, il faut faire défiler une conversation, et non filtrer un historique par source.

La même alerte via une API push

Voici l’alerte de sauvegarde envoyée à Pocket Alert, avec une priorité et un bouton qui ouvre le journal de la tâche :

curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Backup failed",
    "message": "db-01.internal: pg_dump exited with code 1",
    "level": "high",
    "actions": [{ "type": "view", "label": "Open log", "value": "https://ci.example.com/jobs/4821" }]
  }'

Ce qui change :

  • Un seul secret, dans un en-tête. Une clé API dans l’en-tête Token, et non un token dans l’URL plus un identifiant de chat.
  • Du texte brut en entrée, du texte brut en sortie. Aucune règle d’échappement. Les points, tirets bas et crochets arrivent tels quels.
  • Une priorité par message. silent, low, default, high ou critical. Sur iPhone, les niveaux high et critical traversent le mode Concentration sous forme de notifications sensibles au temps, et sur Android une alerte critique passe outre le mode Ne pas déranger. Voir les alertes critiques.
  • Des boutons sans bot. Jusqu’à trois boutons d’action : ouvrir une URL, appeler un point d’accès HTTP ou copier une valeur. Rien n’a besoin d’écouter les appuis.
  • Les services publient directement. Chaque webhook possède sa propre URL. GitHub ou Grafana envoie son propre JSON, et des espaces réservés comme %alerts.0.labels.alertname% insèrent des champs dans la notification. Chaque appel est enregistré dans l’historique des webhooks.
  • Un historique propre. Les alertes sont conservées dans une application et un tableau de bord distincts, regroupés par application, et non mêlés à vos conversations.

Quand Telegram reste le meilleur choix

Pour être honnête :

  • Du volume à petit budget. Telegram est gratuit, sans quota quotidien au-delà de ses limites de débit. L’offre gratuite de Pocket Alert est de 50 messages par jour ; au-delà, il faut une offre payante à partir de 6 $ par mois.
  • Des alertes qui lancent une conversation. Si l’objectif est que l’équipe discute d’une alerte là où elle arrive, un groupe de discussion fait cela, et une notification push non.
  • Ordinateur et web d’abord. Si vous travaillez sur un ordinateur portable, le client Telegram de bureau affiche les alertes là où vous regardez déjà. Les applications Pocket Alert sont destinées à iPhone et Android, avec un tableau de bord web pour l’historique.

Une répartition qui convient à beaucoup d’équipes : garder un groupe Telegram pour les échanges et les synthèses quotidiennes, et envoyer tout ce qui doit réveiller quelqu’un sous forme de notification push avec un niveau d’urgence.

FAQ

Un message de bot Telegram peut-il contourner le mode Ne pas déranger ?

Pas du côté du bot. L’API Bot ne propose aucun réglage de priorité, seulement disable_notification pour rendre un message silencieux. Le seul moyen de passer le mode Concentration sur iPhone est que le destinataire autorise Telegram comme exception d’application, ce qui laisse passer toutes les notifications Telegram, et pas seulement les alertes.

Comment trouver mon identifiant de chat Telegram ?

Envoyez un message quelconque à votre bot, puis appelez https://api.telegram.org/bot<token>/getUpdates et lisez message.chat.id. Si le résultat est vide, la mise à jour est peut-être vieille de plus de 24 heures, ou le bot a un webhook défini, et getUpdates ne fonctionne pas dans ce cas.

Pourquoi mon alerte Telegram échoue-t-elle avec une erreur 400 ?

En général à cause d’un caractère non échappé en mode MarkdownV2 ou HTML. Supprimez parse_mode pour envoyer du texte brut, ou échappez chaque caractère réservé avant l’envoi.

Une API de notifications push est-elle plus difficile à configurer qu’un bot Telegram ?

À peu près aussi simple. Avec Pocket Alert, vous installez l’application, copiez une clé API depuis le tableau de bord et envoyez un seul POST. Il n’y a ni identifiant de chat à chercher ni bot à créer.

Puis-je envoyer vers les deux ?

Oui. Beaucoup d’équipes gardent Telegram pour les échanges et envoient en notification push les alertes qui demandent une réponse. Un script peut appeler les deux API, et la plupart des services qui envoient des webhooks acceptent plusieurs URL.

Créer un compte Pocket Alert gratuit et lancer le curl ci-dessus, ou lire d’abord ce qu’est une API de notifications push. Si vous comparez d’autres options, le comparatif couvre Pushover, ntfy, Bark, Gotify et d’autres.

Partager cet article