Telegram

Un canal de type Telegram envoie chaque alerte comme message de votre propre bot vers un chat, un groupe ou un canal Telegram. C'est la seule destination de chat ici sans webhook ; vous fournissez un token de bot et un identifiant de chat à la place.

Prérequis

• Le rôle Gestionnaire sur le site dans CentralCSP.
• Un compte Telegram.

1. Créer un bot avec BotFather

1. Dans Telegram, ouvrez une discussion avec @BotFather (le bot officiel de Telegram pour créer des bots).
2. Envoyez /newbot, puis suivez les instructions pour choisir un nom d'affichage et un nom d'utilisateur. Le nom d'utilisateur doit se terminer par bot.
3. Copiez le token de bot dans la réponse de BotFather. Il ressemble à 1234567890:AAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

La référence de Telegram est BotFather. Traitez le token comme un secret ; quiconque le détient contrôle le bot. CentralCSP le stocke et ne le renvoie jamais via l'API.

2. Placer le bot dans le chat de destination

L'API Bot ne permet à un bot d'écrire que dans les chats dont il fait partie :

• Groupe : ajoutez le bot comme membre.
• Canal : ajoutez le bot comme administrateur avec la permission de publier.
• Message direct : ouvrez une discussion avec le bot et envoyez-lui /start. Un bot ne peut pas écrire à un utilisateur en premier.

3. Trouver l'identifiant de chat

Pour un groupe ou un canal public, le @username est l'identifiant de chat ; utilisez-le tel quel.

Pour un groupe privé ou un message direct, l'identifiant est numérique :

1. Envoyez un message quelconque dans le chat de destination (dans un groupe, mentionnez le bot ou rendez-le admin pour qu'il voie les messages).
2. Ouvrez https://api.telegram.org/bot<TOKEN>/getUpdates dans un navigateur, en remplaçant <TOKEN> par votre token de bot.
3. Lisez chat.id dans la réponse JSON. L'identifiant d'un groupe est négatif et commence en général par -100.

4. Ajouter le canal dans CentralCSP

1. Dans le tableau de bord, allez dans Alertes > Configuration > Ajouter un canal.
2. Nommez le canal, choisissez le type Telegram et collez le token de bot et l'identifiant de chat.
3. Enregistrez.

Les deux champs sont validés au fur et à mesure de la saisie : le token doit suivre la forme <bot id>:<secret>, et l'identifiant de chat doit être un nombre ou un @username public.

5. Tester le canal

Sélectionnez Tester sur le nouveau canal. Une alerte d'exemple construite à partir d'une fausse violation CSP est envoyée immédiatement.

Si le message n'arrive pas, l'API Bot a refusé l'envoi. Un identifiant de chat erroné, un token révoqué ou un bot retiré du chat échouent tous définitivement ; corrigez la destination et testez à nouveau.

Étapes suivantes

• Créez une règle qui envoie vers ce canal.
• Vue d'ensemble des canaux pour la désactivation automatique et les limites.
• Historique des envois pour auditer ce qui a été envoyé.