Connecter Telegram : guide étape par étape
Envoie des alertes en cas d’échec (une par test avec NEXUS_TELEGRAM_NOTIFY=true), ainsi que les rapports et fichiers que vous choisissez de partager, par l’intermédiaire de votre propre bot. Il n’y a pas de bot partagé. Ce guide vous accompagne de la configuration initiale à la vérification de la connexion, et répertorie les erreurs possibles avec leurs causes et leurs solutions.
Dernière mise à jour :
Gardez vos identifiants confidentiels. Ne collez jamais de jeton, de clé, de mot de passe ou d’URL de webhook dans une conversation. Saisissez-les uniquement dans Studio → Paramètres → Intégrations, où ils sont enregistrés dans le fichier .env de votre espace de travail et affichés sous forme de points. Cela vaut aussi pour un assistant IA : il peut vous accompagner dans ce guide, mais il n’a jamais besoin de votre jeton.
Prérequis
- Un compte Telegram.
- Votre propre bot, créé une seule fois avec @BotFather, et son jeton.
- Un téléphone ou l’application Telegram pour scanner le code QR d’association.
- Avant l’activation : Telegram peut recevoir des fichiers tels que des rapports et des PDF, qui sont transmis à ses serveurs. Dans un environnement réglementé, consultez d’abord votre équipe chargée de la conformité.
Obtenir les identifiants
- Dans Telegram, ouvrez https://t.me/BotFather et envoyez /newbot. Donnez au bot un nom et un nom d’utilisateur.
- BotFather répond avec le jeton du bot (par exemple 123456:ABC…). Copiez-le.
- Gardez-le dans votre presse-papiers. Ne le collez nulle part ailleurs que dans le Studio (étape suivante).
Configurer la connexion dans le Studio
- Dans le Studio, ouvrez Paramètres → Intégrations → Connecter Telegram.
- Collez le jeton du bot et enregistrez. Le code QR d’association apparaît.
- Scannez le code QR avec votre téléphone et appuyez sur Démarrer dans Telegram. En quelques secondes, le Studio affiche "les alertes sont envoyées à la conversation …" et le bot indique "Connecté à Nexus StudioQA."
- Activez
TELEGRAM_ENABLED. Pour recevoir une alerte par test en échec, activez aussiNEXUS_TELEGRAM_NOTIFY.
Vérifier le fonctionnement
- Après le scan, le bot envoie "Connecté à Nexus StudioQA. Les tests en échec seront signalés ici." dans votre conversation.
- Le Studio affiche "les alertes sont envoyées à la conversation" avec la conversation masquée.
Erreurs courantes
| Ce que vous voyez | Cause | Solution |
|---|---|---|
| "Telegram est désactivé" | TELEGRAM_ENABLED vaut false et doit être activé pour permettre l’association. | Activez TELEGRAM_ENABLED et appuyez à nouveau sur Connecter Telegram. |
| "Aucun jeton de bot" | TELEGRAM_TOKEN est vide. | Collez le jeton de BotFather dans Paramètres → Intégrations et enregistrez. |
| "Telegram : Non autorisé" (ou "Introuvable") | Le jeton du bot est incorrect, a été révoqué dans BotFather ou a été tronqué lors de la copie. | Envoyez /token à BotFather pour récupérer le jeton (ou créez un nouveau bot), puis enregistrez-le. |
| "Le code QR a expiré avant d'être scanné" | Le code QR n'est valable que quelques minutes. | Appuyez sur Connecter Telegram pour en créer un nouveau et scannez-le immédiatement. |
| Le code QR a été scanné mais le Studio attend toujours | Le scan a ouvert la conversation mais vous n'avez pas appuyé sur Démarrer, ou la fenêtre du Studio a été fermée. | Appuyez sur Démarrer dans la conversation du bot. Si le Studio attend toujours, créez un nouveau code QR. |
| "impossible de joindre Telegram (ENOTFOUND)" ou "aucune réponse dans les 20 s" | Ce PC ne peut pas joindre api.telegram.org : un VPN, un pare-feu ou un proxy bloque l'accès, ou le réseau est indisponible. | Vérifiez le réseau depuis le même PC et réessayez. |
| Aucune alerte n'arrive après un échec | TELEGRAM_ENABLED est défini sur false, aucune conversation n'est associée, ou les alertes par test sont désactivées (NEXUS_TELEGRAM_NOTIFY). | Associez une conversation et activez les deux options. |
Clés de configuration
| Clé | Fonctionnalités | Valeur valide | Comment la vérifier |
|---|---|---|---|
TELEGRAM_ENABLED | Envoyer les alertes à Telegram | true ou false | Cette option doit être activée pour le code QR d'association. |
TELEGRAM_TOKEN | Code d'accès du bot Telegram (secret, enregistré uniquement sur cet ordinateur) | Le jeton du bot fourni par BotFather, par exemple 123456:ABC…, sur une seule ligne | Le code QR n'apparaît que si Telegram l'accepte. |
TELEGRAM_CHAT_ID | Conversation Telegram pour les alertes | Renseignée par l'association via code QR ; ne la saisissez pas | Le Studio affiche "les alertes sont envoyées à la conversation …". |
NEXUS_TELEGRAM_NOTIFY | Alerte Telegram à chaque échec | true ou false | Une alerte est envoyée pour chaque test en échec. |
En savoir plus : toutes les intégrations, le guide des paramètres, dépannage. Autres guides : Jira Cloud, Azure Boards, Slack, Microsoft Teams, GitHub Issues.
Toujours bloqué ? Écrivez à [email protected] en indiquant la ligne d’erreur exacte affichée par le Studio. N’incluez aucun jeton.