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

> Un bot Telegram est le moyen gratuit et familier de vous envoyer vos propres alertes. Mise en place complète, points forts, limites (un seul son pour tout, règles d’échappement, un token dans chaque URL) et cas où une API de notifications push est le meilleur outil.

*08.10.2026*

<!-- source: https://pocketalert.app/fr/blog/telegram-bot-vs-push-notifications -->

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 :

```bash
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`.

4. **Envoyez l’alerte :**

```bash
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 :

```bash
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](/use-cases/critical-alerts).
- **Des boutons sans bot.** Jusqu’à trois [boutons d’action](/features/action-buttons) : 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](/use-cases/webhook-notifications) 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](/features/webhook-history).
- **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](/signup) et lancer le curl ci-dessus, ou lire d’abord [ce qu’est une API de notifications push](/blog/what-is-a-push-notification-api). Si vous comparez d’autres options, le [comparatif](/alternatives) couvre Pushover, ntfy, Bark, Gotify et d’autres.
