Aller au contenu principal

Intégration Telegram pour Gladys Assistant

Intégration Telegram pour Gladys Assistant

Discutez avec Gladys depuis Telegram : interrogez votre maison et recevez vos notifications.

Voir sur GitHubToutes les intégrations externes

Discutez avec Gladys depuis Telegram : posez des questions sur votre maison, déclenchez vos scènes et recevez les notifications que Gladys vous envoie, directement depuis l'application Telegram, sur votre téléphone ou votre ordinateur.

Vue d'ensemble​

Cette intégration fait tourner votre propre bot Telegram. Rien ne passe par un bot Gladys partagé : vous créez le bot avec @BotFather, le robot officiel de Telegram, et l'intégration s'y connecte avec le token qu'il vous donne.

Une fois qu'un utilisateur Gladys a lié son compte Telegram, tout ce qu'il écrit au bot est transmis au cerveau de Gladys avec son identité — comme s'il l'avait tapé dans le chat de Gladys. Les réponses, ainsi que les notifications que Gladys lui envoie, arrivent dans la même conversation Telegram.

Prérequis​

  • Un compte Telegram.
  • Un bot créé avec @BotFather (gratuit, une minute suffit — voir ci-dessous).

Créer votre bot​

  1. Dans Telegram, ouvrez une conversation avec @BotFather.
  2. Envoyez /newbot.
  3. Choisissez un nom affiché (par exemple Gladys), puis un nom d'utilisateur se terminant par bot (par exemple ma_maison_gladys_bot). Ces noms sont uniques sur tout Telegram : il faudra peut-être en essayer plusieurs.
  4. @BotFather répond avec un token de la forme 123456789:AAE.... Gardez-le secret : quiconque le possède contrôle le bot.

Quelques commandes optionnelles utiles de @BotFather : /setuserpic pour donner un avatar à votre bot, /setdescription pour le texte affiché avant le premier message, et /setprivacy (laissez la confidentialité activée — de toute façon, cette intégration ne répond qu'en conversation privée).

Configuration​

  1. Ouvrez l'onglet Configuration de l'intégration Telegram dans Gladys.
  2. Collez le token donné par @BotFather dans le champ Token du bot Telegram, puis enregistrez.
  3. Cliquez sur Tester le token du bot : Gladys vérifie le token auprès de l'API Telegram et affiche le nom de votre bot si tout va bien.

L'état de connexion affiché sur cet écran reflète l'état réel du bot : si Telegram refuse le token, l'intégration le dit au lieu d'échouer en silence.

Lier votre compte Telegram​

Chaque utilisateur Gladys lie son propre compte Telegram, et seuls les comptes liés peuvent parler à Gladys :

  1. Dans le même onglet Configuration, cliquez sur Lier mon compte. Gladys affiche un code court, valable 15 minutes et utilisable une seule fois.
  2. Ouvrez la conversation avec votre bot dans Telegram (cherchez son nom d'utilisateur, puis appuyez sur Démarrer).
  3. Envoyez le code au bot. Il confirme la liaison, et vous pouvez lui poser vos questions immédiatement.

Vous pouvez révoquer une liaison à tout moment depuis le même écran : le contact est délié et le bot cesse de lui répondre.

Dépannage​

Le bot ne répond pas du tout. Vérifiez l'état de connexion dans l'onglet Configuration, puis cliquez sur Tester le token du bot. Un token révoqué ou mal recopié est la cause habituelle : générez-en un nouveau avec /token dans @BotFather et collez-le à nouveau.

« Votre compte Telegram n'est pas encore lié ». Ce message signifie que le bot ne connaît pas votre compte Telegram : générez un nouveau code depuis Gladys et envoyez-le au bot. Les codes expirent au bout de 15 minutes et ne fonctionnent qu'une fois.

« Ce code est invalide ou a expiré ». Même solution : générez un nouveau code. Vérifiez que vous l'envoyez bien dans la conversation privée avec le bot, et non dans un groupe.

Rien ne se passe dans une conversation de groupe. C'est volontaire : un contact lié parle avec l'autorité de son utilisateur Gladys, donc l'intégration ne répond qu'en conversation privée.

Deux instances Gladys, un seul bot. Un bot Telegram ne peut être interrogé que par un seul client à la fois. Utiliser le même token dans deux instances Gladys leur fait perdre des messages à toutes les deux : créez plutôt un second bot.

Pour le reste, ouvrez les logs de l'intégration depuis l'interface de Gladys : l'intégration journalise ce qu'elle fait, et LOG_LEVEL=debug donne le détail complet.

Paramètres de configuration​

Voici les paramètres demandés par Telegram dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Token du bot TelegramsecretOuiCréez un bot avec @BotFather sur Telegram (/newbot) et collez ici le token qu'il vous donne.

Comment installer Telegram dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Telegram apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/gladysassistant/gladys-telegram:1.1.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/GladysAssistant/gladys-telegram.

Telegram nécessite Gladys >=4.83.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Telegram est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par GladysAssistant, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le