Guide de configuration des notifications push Telegram

Principe de configuration et structure de l’interface

L’envoi de messages Telegram repose sur Telegram Bot API. L’URL d’envoi complète est construite en combinant le Bot Token (clé d’accès du robot) et le Chat ID (identifiant unique du destinataire).

Modèle de combinaison standard :

[https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/sendMessage?chat_id=<CHAT_ID>

Étapes d’obtention

Étape 1 : créer un robot et obtenir le Bot Token

1. Ouvrez Telegram, saisissez et suivez le robot officiel @BotFather dans la barre de recherche.
2. Envoyez la commande suivante à @BotFather : /newbot.
3. Saisissez successivement les informations demandées :
   • Bot Name : le nom d’affichage du robot (par exemple : Assistant de notifications).
   • Bot Username : le nom d’utilisateur unique du robot (doit se terminer par bot, par exemple : my_notice_bot).
4. Une fois la création réussie, @BotFather fournira les identifiants d’accès à l’API. Copiez la chaîne HTTP API Token (au format, par exemple : 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

Étape 2 : obtenir le Chat ID du destinataire

Sélectionnez la méthode d’obtention correspondante selon le type de destinataire du message (personne ou groupe) :

Option A : recevoir les notifications à titre personnel

• Méthode 1 : via le robot de recherche officiel (recommandé)
  1. Recherchez et suivez @userinfobot dans Telegram.
  2. Envoyez-lui n’importe quel message ou cliquez sur /start.
  3. Le robot renverra les métadonnées du compte personnel ; le nombre affiché après Id correspond à votre Chat ID personnel (par exemple : 987654321).
• Méthode 2 : via une requête d’interface API
  1. Envoyez volontairement un message au robot que vous venez de créer (par exemple : hello) afin d’activer la conversation.
  2. Ouvrez un navigateur et accédez au lien suivant (remplacez <TOKEN> par l’identifiant obtenu à l’étape 1) :

      [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

  3. Dans la réponse JSON retournée, extrayez la valeur de "result" -> "message" -> "chat" -> "id".

Option B : recevoir les notifications dans un groupe/canal

1. Ajoutez le robot nouvellement créé au groupe Telegram cible.
2. Envoyez un message quelconque dans le groupe (par exemple : test) ou accordez au robot les droits d’administrateur.
3. Accédez au lien suivant dans votre navigateur (remplacez <TOKEN> par l’identifiant obtenu à l’étape 1) :

    [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

4. Dans la réponse JSON retournée, recherchez l’enregistrement contenant le nom du groupe correspondant, puis extrayez le champ "chat" -> "id".

   Remarque : le Chat ID d’un groupe est généralement un nombre négatif commençant par - ou -100 (par exemple : -100123456780) ; lors de la combinaison, le signe négatif et le préfixe doivent être conservés intégralement.

III. Exemples de combinaison d’URL

Après avoir obtenu <TOKEN> et <CHAT_ID>, remplacez-les dans le modèle standard :

1. Exemple d’URL de notification personnelle

• Token : 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID : 987654321
• Résultat final de la combinaison :

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321)

2. Exemple d’URL de notification de groupe

• Token : 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID : -7
• Résultat final de la combinaison :

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780)