Aller au contenu principal

Intégration ntfy pour Gladys Assistant

Intégration ntfy pour Gladys Assistant

Envoyez des notifications push via ntfy (ntfy.sh ou auto-hébergé).

Voir sur GitHubToutes les intégrations externes

Présentation​

Cette intégration permet à Gladys Assistant d'envoyer des notifications push via ntfy, un service de notifications très simple. Lorsqu'une scène vous envoie un message, il est poussé sur votre téléphone via l'application ntfy.

Elle fonctionne avec le serveur public gratuit https://ntfy.sh comme avec votre propre serveur ntfy auto-hébergé.

C'est un canal envoi uniquement : Gladys envoie seulement des notifications, elle ne reçoit pas de messages en retour. Chaque utilisateur Gladys configure son propre topic ntfy dans son compte, pour recevoir ses notifications sur son propre téléphone.

Prérequis​

  • L'application ntfy installée sur votre téléphone (Android / iOS), ou tout client ntfy.
  • Un accès Internet depuis votre instance Gladys (pour joindre https://ntfy.sh), ou un serveur ntfy auto-hébergé joignable.
  • Un topic et un jeton d'accès pour ce topic. Un topic est un canal : choisissez un nom long et difficile à deviner et protégez-le avec un jeton (tk_…) autorisé à y publier.

Configuration​

La configuration se fait en deux parties :

1. Réglages de l'intégration (communs, une seule fois)​

  • URL du serveur ntfy — https://ntfy.sh par défaut, ou votre serveur auto-hébergé ;
  • Priorité par défaut — la priorité des notifications envoyées par Gladys ;
  • Titre par défaut — le titre affiché sur ces notifications.

2. Mon compte (par utilisateur)​

Chaque utilisateur Gladys ouvre l'intégration et remplit son bloc « Mon compte » :

  • Votre topic ntfy — le topic sur lequel vos notifications sont envoyées ;
  • Jeton d'accès — un jeton d'accès ntfy (tk_…) autorisé à publier sur ce topic.

Puis abonnez-vous à ce topic dans l'application ntfy sur votre téléphone pour recevoir les notifications.

Envoyer des notifications​

Utilisez une scène Gladys avec une action « Envoyer un message », choisissez cette intégration et l'utilisateur à notifier : le message est publié sur le topic ntfy de cet utilisateur et poussé sur son téléphone.

Dépannage​

  • Un utilisateur ne reçoit rien — vérifiez que son topic et son jeton d'accès sont renseignés dans son bloc « Mon compte », et que l'application ntfy de son téléphone est abonnée au même topic et au même serveur.
  • La publication échoue (403) — le jeton d'accès est absent ou non autorisé à publier sur le topic ; créez-le ou renouvelez-le sur votre serveur ntfy.
  • Les notifications arrivent sans titre — renseignez le Titre par défaut dans les réglages de l'intégration.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
URL du serveur ntfystringOuiL'URL de base du serveur ntfy, commune à tous. Utilisez le service public https://ntfy.sh ou votre propre serveur auto-hébergé.
Priorité par défautselectNonPriorité appliquée aux notifications envoyées par Gladys.
Titre par défaut des notificationsstringNonTitre affiché sur les notifications envoyées par Gladys.

Comment installer ntfy dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : ntfy 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/callemand/gladys-ntfy:1.0.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/callemand/gladys-ntfy.

ntfy nécessite Gladys >=4.62.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​

ntfy 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 callemand, 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