Connecter Telegram
Recevoir les alertes dans une conversation Telegram, et interroger le projet avec /status ou /check.
Plan Pro et au-delàMis à jour le 11 septembre 2026
Sur cette page
Telegram n'a pas de bouton d'installation : chaque projet parle par son propre bot, qu'il faut créer une fois avec @BotFather. En revanche vous n'avez pas à aller chercher d'identifiant de conversation : le bot enregistre le salon lui-même au premier /start. Comptez une minute.
Créer le bot
Tout se passe dans Telegram, avec le bot officiel @BotFather.
- Ouvrez une conversation avec @BotFather et envoyez
/newbot. - Donnez un nom, puis un identifiant se terminant par « bot ».
- @BotFather répond avec un token de la forme
123456:AbC-…: c'est le token du bot. Ne le partagez pas, il permet d'écrire en son nom.
Le brancher sur PostShip
Deux champs sur la carte Telegram de Projet → Intégrations, dont un seul est obligatoire.
- Collez le token dans « Token du bot Telegram », laissez « Chat ID Telegram » vide, et enregistrez. PostShip enregistre aussitôt son webhook auprès de Telegram et publie le menu des commandes ; si le token est faux, vous lisez « Échec de la connexion à Telegram — vérifiez le token. »
- La carte affiche « En attente de votre /start ». Envoyez
/startà votre bot, depuis une conversation directe ou depuis un groupe où vous l'avez ajouté. - Le bot répond : « PostShip est connecté à ce salon. Vous recevrez les alertes ici. Tapez « / » pour voir les commandes, ou /status tout de suite. » Le salon est enregistré, c'est fini.
Le champ Chat ID
Il ne sert qu'à forcer un salon précis, par exemple pour déplacer les alertes vers un autre groupe sans repasser par /start. Tant qu'il est vide et qu'aucun /start n'est arrivé, la carte affiche « En attente de votre /start ». Laisser un champ vide ne l'efface jamais : il conserve la valeur déjà enregistrée. Le premier /start gagne : un second, venu d'un autre salon, n'écrase pas le premier.
Ce que vous recevez
Un message texte, sans mise en forme : PostShip — Nom du projet, puis le récapitulatif (« 1 en échec, 0 rétablis. »), la note fournisseur s'il y en a une (« Ce n'est peut-être pas vous : Vercel signale un incident »), et une ligne par URL avec la raison en clair. C'est le même texte que la version texte de l'email. Le détail des libellés est sur Email, Discord, Slack, Telegram.
Le même salon reçoit aussi les messages d'équipe : prise en charge, escalade, résumé quotidien, erreurs des visiteurs, alertes multi-régions.
Les commandes
Le bot répond dans le salon enregistré, et seulement dans celui-là : un message venu d'un autre salon est ignoré sans réponse. Le menu « / » de Telegram liste les commandes ; /help les explique.
| Commande | Réponse |
|---|---|
/status | 12 URL · 11 OK · 1 en échec, puis jusqu'à 3 URL en échec |
/check | « Vérification lancée. » — toutes les URL, tout de suite. Deux minutes entre deux /check : « Vérif déjà lancée, patientez. » |
/uptime | 24h : 99,8% · 7j : 99,5% |
/ssl | 42 jour(s) restant(s), ou « pas de check SSL » |
/silence 1h, /silence 4h, /silence 24h, /silence off | « Alertes coupées pour 4h. » ou « Alertes reprises. » Même effet que « Couper » sur la page Incidents. Maximum 168 h : « Pour couper plus longtemps, passez par le projet. » |
/rules | confirm=2 · calme=22-07 : les règles en lecture seule |
/help | La liste, avec l'usage de /silence |
Dans un groupe, Telegram ajoute @VotreBot à la commande (/status@VotreBot) : c'est compris. Une commande inconnue répond l'aide. Le bot ne modifie aucune règle depuis le salon (confirmation, heures calmes) : ces réglages se font dans Projet → Paramètres → Règles, voir Règles.
L'onglet Projet → Paramètres → Bot rappelle l'état de chaque canal et le texte de /help.
Couper
Le bouton « Désactiver » sous la carte Telegram efface le token et le chat ID : plus rien ne part, et le bot ne répond plus. Pour changer de salon sans tout refaire, renseignez le Chat ID du nouveau salon.
Limites et plans
| Free | Pro | Team | |
|---|---|---|---|
| Alertes Telegram | Non | Oui | Oui |
| Commandes du bot | Non | Oui | Oui |
Le plan qui compte est celui du propriétaire du projet. Un projet retombé en Free garde son bot, mais plus rien n'y part et les commandes restent sans réponse. Voir les plans.
Dépannage
Pourquoi le bot ne répond pas à /start ?
Le token n'a pas été enregistré (relisez le message d'erreur sous le formulaire), ou le bot a été créé mais jamais démarré dans cette conversation. Ouvrez la conversation avec le bot et envoyez /start de nouveau : tant que le Chat ID est vide, c'est le premier /start reçu qui compte.
Pourquoi le bot répond dans mon groupe mais pas en privé ?
Le salon enregistré est le groupe. Le bot ne répond qu'à un seul salon par projet : celui du /start, ou celui du Chat ID. Pour recevoir en privé, renseignez le Chat ID de votre conversation directe.
Pourquoi /check répond « Vérif déjà lancée » ?
Deux minutes de délai entre deux vérifications lancées depuis un salon : chaque /check fait tourner toutes les requêtes du projet contre votre site, et n'importe qui dans le groupe peut l'envoyer.