Telegram

Les notifications via Telegram passent par un bot propre au contrôleur. Un administrateur le configure une fois ; ensuite, chaque personne lie son propre Telegram à son compte. Les profils envoient alors :

• aux personnes par le canal Telegram d'un profil,
• à un groupe Telegram par un service du type Groupe Telegram.

Le contrôleur envoie directement à Telegram, pas par le cloud nomos.

Configurer le bot

Seuls les administrateurs configurent le bot.

1. Dans Telegram, créez un bot avec @BotFather et /newbot. BotFather vous donne ensuite son jeton.
2. Dans la configuration, ouvrez Notifications → Services et cliquez sur Nouveau service.
3. Sous Service, choisissez Bot Telegram. Ce type n'est proposé que tant qu'aucun bot n'est configuré. L'éditeur n'a alors que le champ Jeton : ni nom, ni URL, ni message de test.
4. Saisissez le jeton et cliquez sur Enregistrer en haut. Si Telegram accepte le jeton, le bot occupe la première ligne de la liste des services : son nom Telegram comme Nom, par exemple @MaMaisonBot, et Bot Telegram comme Service.

Configurer le bot sur l'onglet Telegram d'un profil ouvre Nouveau service avec le type Bot Telegram déjà choisi.

Le jeton n'est plus affiché ensuite. Quiconque le connaît peut écrire au nom du bot et lire ce qui lui est écrit.

Modifier ou supprimer le bot

• Modifier dans la ligne du bot affiche son nom et le champ Nouveau jeton. Laissé vide, le bot reste tel quel. Le jeton d'un autre bot supprime toutes les liaisons ; elles doivent être refaites.
• Supprimer dans la ligne du bot ou dans la barre de l'éditeur demande confirmation (Supprimer le bot Telegram ?) puis supprime le bot. Les personnes et les groupes ne reçoivent plus de messages Telegram ; toutes les liaisons sont supprimées et doivent être refaites avec un nouveau bot.

Lier Telegram

Chaque personne lie son propre Telegram dans son compte. Les administrateurs peuvent aussi le faire pour d'autres utilisateurs.

1. Ouvrez le menu utilisateur en haut à droite et choisissez Profil. En tant qu'administrateur, ouvrez Utilisateurs → Modifier pour un autre utilisateur (voir Utilisateurs).
2. Dans la section Telegram, cliquez sur Lier Telegram. Un lien et un code QR apparaissent.
3. Ouvrez le lien sur votre téléphone ou scannez le code QR, puis appuyez sur Démarrer dans Telegram. Le lien est valable 15 minutes ; Créer un nouveau lien en crée un nouveau.
4. Dès que Telegram signale le démarrage, la section affiche Lié en tant que … avec le nom Telegram.

Délier supprime la liaison après confirmation ; le compte ne reçoit alors plus de messages Telegram jusqu'à ce qu'il soit à nouveau lié. Si quelqu'un bloque le bot dans Telegram, le contrôleur supprime la liaison de lui-même.

Sans bot configuré, la section indique Aucun bot Telegram configuré pour l'instant (Notifications › Services › Nouveau service).

INFO

L'utilisateur "guest" est un accès partagé et anonyme : il ne peut pas lier Telegram et n'est pas proposé comme destinataire dans les profils.

Telegram dans un profil

Sur l'onglet Telegram d'un profil, vous cochez Envoyer via Telegram et choisissez les destinataires : Tous (tous ceux qui ont lié Telegram), Administrateurs ou des utilisateurs individuels. À côté de chaque utilisateur figure son nom Telegram ou non lié. Un utilisateur sans l’autorisation Notification push est grisé et marqué sans l’autorisation « Notification push ».

Un message Telegram parvient à qui est choisi, a lié son Telegram, a un compte actif et dispose de Accès complet pour Notification push dans les autorisations.

Groupe Telegram

Si une notification doit aller dans un groupe Telegram, par exemple le groupe de la famille, configurez le groupe comme service :

1. Ouvrez Notifications → Services et cliquez sur Nouveau service.
2. Sous Service, choisissez Groupe Telegram. Ce type n'est proposé qu'une fois un bot Telegram configuré.
3. Dans Telegram, ajoutez le bot au groupe ou envoyez dans le groupe /start@ suivi du nom du bot. Si le bot était déjà dans le groupe, retirez-le puis ajoutez-le à nouveau.
4. Cliquez sur Chercher des groupes. Le contrôleur cherche pendant 2 minutes ; chaque groupe dans lequel le bot se manifeste pendant ce temps apparaît sous Groupe. Le premier groupe trouvé est choisi d'emblée, et son nom est repris comme Nom si ce champ est encore vide.
5. Vérifiez le groupe avec Envoyer un message de test et cliquez sur Enregistrer en haut.

Choisissez ensuite le groupe dans un profil sur l'onglet Services.

Remise au client

Configuration pour les nouveaux utilisateurs (voir Configuration) supprime le bot Telegram et toutes les liaisons : le téléphone de l'intégrateur ne doit pas recevoir les notifications du client, et quiconque possède le jeton du bot lit ce qui lui est écrit. Le client configure ensuite son propre bot.

Une notification transférée part, sur les contrôleurs gérés, par leur propre bot à tous ceux qui y ont lié leur Telegram.