Connecter Telegram à Elido

Elido envoie des notifications Telegram via un bot que vous créez. Le bot envoie des messages vers un chat précis - soit une conversation privée avec vous-même, soit un groupe. Le jeton du bot vous appartient ; Elido ne le stocke que chiffré.

Étape 1 - Créer un bot avec BotFather

1. Ouvrez Telegram et recherchez @BotFather, ou ouvrez https://t.me/BotFather.
2. Envoyez /newbot.
3. Suivez les instructions : choisissez un nom d'affichage, puis un nom d'utilisateur (qui doit se terminer par bot, p. ex. AcmeElidoBot).
4. BotFather répond avec votre jeton d'API. Il ressemble à 123456789:AABBccDD.... Copiez-le maintenant - vous pourrez le récupérer plus tard via /mybots, mais il est plus rapide de le copier tout de suite.

Étape 2 - Trouver votre ID de chat

Il vous faut l'ID de chat numérique de la destination des messages.

Pour un message privé (juste vous) :

1. Envoyez n'importe quel message à votre nouveau bot.

2. Ouvrez cette URL dans un navigateur, en remplaçant TOKEN par votre jeton :

   https://api.telegram.org/botTOKEN/getUpdates
   

3. Repérez "chat":{"id":...} dans la réponse. Ce nombre est votre ID de chat. C'est généralement un entier positif à 9 chiffres pour les chats personnels.

Pour un groupe :

1. Ajoutez le bot au groupe.
2. Envoyez dans le groupe un message qui mentionne le bot avec @ (p. ex. @AcmeElidoBot hello).
3. Ouvrez la même URL getUpdates que ci-dessus. Les ID de chat de groupe sont des nombres négatifs (p. ex. -1001234567890).

Étape 3 - Configurer Elido

1. Allez dans Settings → Notifications → Telegram → Add channel.
2. Collez le jeton du bot et l'ID de chat.
3. Cliquez sur Save. Elido envoie un message de test. Il devrait arriver dans Telegram en moins de 2 secondes.

Choisir les événements

Une fois connecté, cliquez sur Configure events pour sélectionner les événements qui déclenchent un message :

• link.broken - point de départ recommandé : le moniteur de liens cassés a trouvé une destination qui ne fonctionne plus.
• usage.threshold_80 et usage.threshold_100 - l'espace de travail a consommé 80 % ou 100 % du quota de son forfait.
• link.expired et link.cap_reached - un lien a expiré ou a atteint son plafond de clics.
• link.created - utile pour les espaces de travail partagés où vous voulez de la visibilité sur les nouveaux liens.
• domain.verified et domain.ssl_failed - état des domaines personnalisés.

La liste complète des types d'événements figure dans le guide des webhooks.

Supprimer l'intégration

Allez dans Settings → Notifications → Telegram → Remove. Cela supprime le jeton du bot de la base de données d'Elido. Vous pouvez en plus révoquer le bot lui-même dans BotFather avec /revoke.

Dépannage

« Unauthorized » dans le journal de livraison - Le jeton est erroné. Vérifiez-le en collant ceci dans un navigateur :

https://api.telegram.org/botTOKEN/getMe

S'il renvoie {"ok":false,...}, le jeton est invalide.

« Chat not found » - L'ID de chat est erroné, ou le bot n'a jamais été ajouté au groupe. Pour les groupes, confirmez que le bot en est membre et envoyez un message qui le mentionne avant d'appeler getUpdates.

Aucun message après un clic sur Test - Consultez getUpdates pour confirmer que le bot a reçu une interaction. Si la réponse est vide, Telegram n'a encore enregistré aucun contact entre l'utilisateur/groupe et le bot.

Les messages du groupe sont invisibles - Certains groupes Telegram ont le « mode lent » ou réservent la publication aux administrateurs. Faites du bot un administrateur avec la permission « Publier des messages ».