Configurer Telegram

1. Ce que demande la page

Sous « Configuration de base », un « Nom de l’intégration » et l’« Environnement ». Sous « Identifiants » : le « Jeton du bot » (étape 1), le « Nom d’utilisateur du bot », qui se termine par « bot » et sert au lien « Connecter Telegram », et le « Secret du webhook », que vous inventez (étapes 2 et 5).

Après « Enregistrer la configuration », « Tester la connexion » et « Enregistrer le webhook » apparaissent. Chaque entreprise utilise son propre bot.

2. Étapes 1 à 3 : créer le bot

Étape 1. Dans Telegram, ouvrez @BotFather (le compte officiel, avec la coche bleue), tapez /newbot et répondez avec le nom affiché du bot et un nom d’utilisateur se terminant par « bot » (par exemple, previna_notif_bot). BotFather renvoie un jeton qui ressemble à 123456789:AAE… ; copiez-le dans « Jeton du bot » et le nom d’utilisateur, sans le @, dans « Nom d’utilisateur du bot ». Quiconque possède le jeton contrôle le bot : ne le partagez pas.

Étape 2. Inventez une longue chaîne aléatoire (32 caractères ou plus) et saisissez-la dans « Secret du webhook ».

Étape 3 (facultative). Dans @BotFather, vous pouvez donner au bot une description et une photo avec /setdescription et /setuserpic.

3. Étape 4 : enregistrer et tester

Appuyez sur « Enregistrer la configuration » puis sur « Tester la connexion ». Si le jeton est valide, l’intégration devient active. Dès lors, goPrevina peut envoyer des notifications à toute personne dont le compte Telegram est lié.

4. Étape 5 : enregistrer le webhook

Pour que la liaison de chaque utilisateur fonctionne, Telegram doit transmettre à goPrevina le /start que l’utilisateur envoie. L’intégration étant enregistrée, appuyez sur « Enregistrer le webhook » : la plateforme l’enregistre avec l’adresse publique de votre API et le secret de l’étape 2, et vous indique si Telegram l’a accepté.

Telegram n’accepte que des adresses HTTPS accessibles depuis Internet ; sur une installation qui n’en a pas, l’enregistrement échoue. Sans le webhook, l’envoi fonctionne, mais le bouton « Connecter Telegram » des utilisateurs ne finalise pas la liaison.

5. Étape 6 : chaque utilisateur connecte son Telegram

C’est chaque personne qui le fait, pas l’administrateur. Dans Préférences de notification, appuyez sur « Connecter Telegram » : le bot s’ouvre avec un lien à usage unique. Appuyez sur « Démarrer » dans Telegram et la carte passe de « Non connecté » à « Connecté ». Cochez ensuite la colonne Telegram pour les notifications que vous souhaitez y recevoir.

Si « Tester la connexion » échoue, vérifiez le jeton. Si la liaison ne se finalise pas, le webhook doit encore être enregistré (étape 5).