Intégration Telegram

Recevez un message dans Telegram quand vos retours demandent votre attention. Voxtrics publie dans Telegram à partir d’une alerte : une règle qui surveille les réponses entrantes, par exemple « au moins 3 notes de 2 ou moins en une heure ». Les messages viennent d’un bot Telegram à vous et arrivent dans le chat de votre choix : un groupe, un canal ou votre conversation privée avec le bot. Voxtrics a besoin d’une seule adresse qui contient les deux : le jeton du bot et l’identifiant du chat.

Créer un bot

  1. Dans Telegram, ouvrez @BotFather et envoyez /newbot.
  2. Donnez un nom au bot, par exemple Voxtrics alerts, et un nom d’utilisateur qui se termine par bot.
  3. BotFather répond avec le jeton du bot, qui ressemble à 123456789:AAHf0x.... Copiez-le.

Ajouter le bot au chat

  • Un groupe : ajoutez le bot comme membre.
  • Un canal : ajoutez le bot comme administrateur autorisé à publier des messages.
  • Votre conversation privée : ouvrez le bot et appuyez sur Start (« Démarrer »). Un bot ne peut pas écrire à quelqu’un qui ne l’a pas démarré.

Envoyez ensuite un message quelconque dans ce chat, pour que Telegram ait quelque chose à afficher à l’étape suivante.

Trouver l’identifiant du chat

  1. Ouvrez cette adresse dans votre navigateur, avec votre jeton à la place de YOUR_TOKEN :

    https://api.telegram.org/botYOUR_TOKEN/getUpdates

  2. Cherchez "chat":{"id": dans la réponse et copiez le nombre qui suit. L’identifiant d’un groupe ou d’un canal commence par un signe moins, par exemple -1001234567890 : gardez le moins.

Si la réponse est vide ("result":[]), envoyez un autre message dans le chat et rechargez la page : Telegram ne conserve ces données que 24 heures.

Envoyer les alertes vers Telegram

  1. Placez le jeton et l’identifiant du chat dans cette adresse :

    https://api.telegram.org/botYOUR_TOKEN/sendMessage?chat_id=YOUR_CHAT_ID

  2. Allez dans Alertes et cliquez sur Nouvelle alerte, ou sur l’icône en forme de crayon (Modifier) d’une règle existante.

  3. Définissez le nom, la portée, la fenêtre temporelle et la condition de la règle, comme décrit dans Alertes.

  4. Sous Notifier via, sélectionnez Telegram et collez l’adresse dans URL du webhook Telegram.

  5. Cliquez sur Créer l’alerte, ou sur Enregistrer les modifications pour une règle existante.

L’adresse ne publie que dans le chat qu’elle indique. Pour recevoir aussi les mêmes alertes dans un autre chat, formez une adresse pour ce chat et ajoutez-la à la règle avec Ajouter un chat Telegram. Plusieurs règles peuvent utiliser la même adresse.

Ce que dit le message

À chaque déclenchement de la règle, le chat reçoit un court message en texte brut, en anglais, avec le nom de la règle, le domaine, le nombre de réponses correspondantes dans la fenêtre temporelle et la raison du déclenchement. Les réponses elles-mêmes n’y figurent pas : ouvrez le déclenchement dans Alertes pour les voir.

Une règle se déclenche au plus une fois toutes les 30 minutes, ou moins souvent si vous définissez un délai de répétition. Les alertes d’un espace publient au plus 200 messages par jour vers Telegram et Slack réunis. Au-delà, une règle se déclenche toujours et le déclenchement apparaît dans Alertes, mais rien n’est publié.

Si les messages n’arrivent pas

  • Si l’alerte ne s’enregistre pas, vérifiez que l’adresse commence par https://api.telegram.org/. Voxtrics n’accepte que l’adresse de la Bot API de Telegram, pas un lien t.me vers un chat ou un bot.
  • Vérifiez que la règle est activée et s’est déclenchée : chaque déclenchement est listé dans Alertes.
  • Si la règle s’est déclenchée mais que rien n’est arrivé dans Telegram, vérifiez que le bot est toujours dans le chat (et administrateur dans un canal), que l’identifiant du chat a gardé son signe moins et que le jeton n’a pas été révoqué. Quand Telegram transforme un groupe en supergroupe, son identifiant change : retrouvez-le et mettez l’adresse à jour.