Connecter Telegram à Elido

Elido envoie des notifications Telegram via un bot que vous créez. Le bot envoie des messages à un chat spécifique — soit une DM privée avec vous-même, soit un groupe. Vous possédez le jeton du bot ; 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 invites : choisissez un nom d'affichage, puis un nom d'utilisateur (doit se terminer par bot, ex. AcmeElidoBot).
4. BotFather répond avec votre jeton API. Il ressemble à 123456789:AABBccDD.... Copiez-le maintenant — vous pouvez le récupérer plus tard depuis /mybots, mais c'est plus rapide de le copier tout de suite.

Étape 2 — Trouver votre ID de chat#

Vous avez besoin de l'ID numérique du chat où vous souhaitez envoyer des messages.

Pour les DMs (vous seul) :

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. Trouvez "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 un message dans le groupe qui @-mentionne le bot (ex. @AcmeElidoBot bonjour).
3. Ouvrez la même URL getUpdates ci-dessus. Les IDs de chat de groupe sont des nombres négatifs (ex. -1001234567890).

Étape 3 — Configurer Elido#

1. Allez dans Paramètres → Notifications → Telegram → Ajouter un canal.
2. Collez le jeton du bot et l'ID de chat.
3. Cliquez sur Enregistrer. Elido envoie un message test. Attendez-le dans Telegram en moins de 2 secondes.

Choisir les événements#

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

• threshold.exceeded — point de départ recommandé.
• scan.failed — immédiatement utile pour tout lien dont vous ne contrôlez pas la destination.
• link.created — utile pour les workspaces partagés où vous souhaitez une visibilité sur les nouveaux liens.

Supprimer l'intégration#

Allez dans Paramètres → Notifications → Telegram → Supprimer. Cela supprime le jeton du bot de la base de données Elido. Optionnellement, révoquez le bot lui-même dans BotFather avec /revoke.

Résolution des problèmes#

"Unauthorized" dans le journal de livraison — Le jeton est incorrect. Vérifiez en collant https://api.telegram.org/botTOKEN/getMe dans un navigateur. S'il renvoie {"ok":false,...}, le jeton est invalide.

"Chat not found" — L'ID de chat est incorrect, ou le bot n'a jamais été ajouté au groupe. Pour les groupes, confirmez que le bot est membre et envoyez un message le mentionnant avant d'appeler getUpdates.

Aucun message après avoir cliqué sur Test — Vérifiez getUpdates pour confirmer que le bot a reçu une interaction. Si la réponse est vide, Telegram n'a pas encore enregistré de contact entre l'utilisateur/groupe et le bot.

Les messages dans le groupe sont invisibles — Certains groupes Telegram ont le "slow mode" ou la publication réservée aux admins. Faites du bot un administrateur avec la permission "Poster des messages".