Aller au contenu principal

Intégration communautaire Nextcloud Talk, gratuite et open source

Intégration Nextcloud Talk pour Gladys Assistant

Discutez avec Gladys depuis Nextcloud Talk : questions, alertes et images.

Voir sur GitHubToutes les intégrations

Discutez avec Gladys depuis Nextcloud Talk : posez des questions sur votre maison, lancez des scènes, et recevez les notifications et les images de caméras que Gladys vous envoie, dans une conversation privée avec un compte bot.

Fonctionnement​

L'intégration se connecte à votre Nextcloud avec un compte dédié à Gladys (le bot). Chaque utilisateur de Gladys ouvre une conversation privée (en tête-à-tête) avec ce compte dans Talk, et la lie à son compte Gladys avec un code court. Dès lors, ce qu'il écrit dans cette conversation parvient à Gladys avec ses droits, et Gladys y répond.

Seules les conversations en tête-à-tête sont prises en compte : dans une conversation de groupe, chaque membre parlerait au nom de l'utilisateur qui l'a liée. Les conversations de groupe du compte bot sont simplement ignorées.

1. Créer le compte bot (administrateur Nextcloud)​

  1. Dans Nextcloud, créez un utilisateur pour Gladys, par exemple gladys, avec un nom d'affichage comme « Gladys ». Vérifiez que l'application Talk lui est accessible.
  2. Connectez-vous avec cet utilisateur, ouvrez Paramètres → Sécurité, et dans Appareils & sessions créez un mot de passe d'application (nommez-le « Gladys »). Copiez-le : il n'est affiché qu'une fois. Un mot de passe d'application se révoque à tout moment sans changer le mot de passe du compte, et fonctionne même avec l'authentification à deux facteurs.

2. Configurer l'intégration (administrateur Gladys)​

  1. Ouvrez l'onglet Configuration de l'intégration Nextcloud Talk.
  2. Renseignez :
    • URL de Nextcloud : l'adresse de votre instance telle que Gladys peut la joindre, par exemple https://cloud.example.com (ajoutez le sous-chemin si Nextcloud n'est pas à la racine, ex. https://example.com/nextcloud) ;
    • Identifiant du bot : l'identifiant du compte créé plus haut ;
    • Mot de passe d'application du bot : le mot de passe d'application créé plus haut.
  3. Enregistrez, puis cliquez sur Tester la connexion : le compte utilisé par Gladys et le nombre de conversations privées visibles s'affichent.

3. Lier votre compte (chaque utilisateur de Gladys)​

  1. Dans Nextcloud Talk, démarrez une conversation privée avec le compte bot (cherchez son nom dans « Démarrer une nouvelle conversation »).
  2. Dans Gladys, ouvrez l'intégration Nextcloud Talk et cliquez sur Lier mon compte : Gladys affiche un code court, valable 15 minutes.
  3. Envoyez ce code dans la conversation Talk. Le bot répond que la conversation est désormais liée à votre compte.

Vous pouvez maintenant écrire à Gladys dans cette conversation (« quelle est la température du salon ? »), et choisir Nextcloud Talk dans les scènes qui vous envoient des messages. Vous pouvez révoquer la liaison à tout moment depuis le même écran.

Bon à savoir​

  • Le bot répond en quelques secondes : il écoute chaque conversation en continu. Une nouvelle conversation est détectée en moins de 30 secondes.
  • Les messages écrits pendant que l'intégration est arrêtée ne sont pas exécutés à son redémarrage, pour qu'un ancien ordre (ouvrir une porte…) ne s'exécute jamais en retard.
  • Les images envoyées par Gladys (captures de caméras) sont déposées dans le dossier Talk du compte bot, puis partagées dans la conversation.

Dépannage​

  • « Nextcloud a refusé les identifiants du bot » : vérifiez l'identifiant, et créez un nouveau mot de passe d'application si besoin. L'identifiant est celui de l'utilisateur, pas son adresse e-mail.
  • « Nextcloud est injoignable » : vérifiez que l'URL est joignable depuis la machine qui fait tourner Gladys (pas seulement depuis votre navigateur) et que son certificat HTTPS est valide.
  • Le bot ne répond pas : vérifiez qu'il s'agit d'une conversation en tête-à-tête avec le compte bot, et consultez les logs de l'intégration dans Gladys.
  • « Ce n'est pas un code de liaison valide, ou il a expiré » : générez un nouveau code dans Gladys et envoyez-le dans les 15 minutes ; chaque code ne sert qu'une fois.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Pour commencersectionNonCréez un compte Nextcloud dédié à Gladys (le bot) et un mot de passe d'application pour ce compte dans Paramètres → Sécurité. Chaque utilisateur de Gladys ouvre ensuite une conversation privée avec ce compte dans Talk et y envoie le code donné par « Lier mon compte ».
URL de NextcloudstringOuiAdresse de votre instance Nextcloud, telle que Gladys peut la joindre.
Identifiant du botstringOuiIdentifiant du compte Nextcloud avec lequel Gladys parle.
Mot de passe d'application du botsecretOuiUn mot de passe d'application de ce compte plutôt que son mot de passe principal.

Comment installer Nextcloud Talk dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Nextcloud Talk 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/bertrandda/gladys-nextcloud-talk:2.0.2), 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/bertrandda/gladys-nextcloud-talk.

Nextcloud Talk nécessite Gladys >=5.1.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​

Nextcloud Talk 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 bertrandda, 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