Comment créer un bot Telegram

Cet article explique comment connecter votre bot Telegram et fournit les bases du travail avec les chaînes et les groupes.

Exigences et limites de Telegram

1. Limites des messages

• Message texte uniquement : Maximum de 4 096 caractères.

• Message avec une image : Maximum de 1 024 caractères (pour une image de 1080x1080 px).

2. Exigences relatives aux images

• Format : Les images carrées sont préférées.

• Taille optimale : 900x900 pixels, maximum 5 Mo.

3. Exigences relatives aux fichiers

L’API Telegram impose des exigences spécifiques pour les fichiers téléversés :

• Les bots peuvent envoyer des fichiers jusqu’à 2 Go.

• Vous pouvez utiliser file_id pour travailler avec des fichiers déjà téléversés. Dans ce cas, les limites de fichier suivent la documentation de Telegram.

• Les fichiers peuvent être envoyés à l’aide d’un URL (le bot le télécharge et l’envoie) :

  • Photos : ≤ 5 Mo

  • Autres fichiers : ≤ 20 Mo

• Des limites différentes s’appliquent pour la publication :

  • Photos : 10 Mo

  • Autres fichiers : 2 Go

En savoir plus dans la source originale

Création d’un bot Telegram

Un bot Telegram est créé via BotFather, le système officiel de gestion des bots de Telegram. Cet outil vérifié (indiqué par une coche bleue) vous permet de créer un bot sans aucune connaissance en programmation et vous protège contre les imitateurs frauduleux.

Étapes de création :

1. Démarrez une discussion avec BotFather.

2. Envoyez la commande : /newbot

3. Choisissez un nom pour votre bot (c’est le nom affiché pour les utilisateurs).

4. Choisissez un nom d’utilisateur pour votre bot. Il doit se terminer par bot ou _bot (par ex. : my_test_bot).

Si le nom d’utilisateur est disponible, BotFather vous enverra un message de confirmation contenant un « token »—une clé unique pour l’accès à l’API.

Important : Ce token est le mot de passe de votre bot. Conservez-le en lieu sûr et ne le partagez jamais avec qui que ce soit.

Accédez à la Messageries section, sélectionnez Telegramet collez le token de votre bot dans le champ prévu à cet effet.

Cliquez sur le bouton Terminé bouton pour terminer la configuration du bot et activer la connexion à votre projet.

Travailler avec les groupes/canaux Telegram

Informations utiles

Un groupe Telegram est un canal de communication entre participants : tous les participants peuvent y écrire.

Le canal Telegram est un moyen de communication à sens unique. Seul le propriétaire ou les administrateurs peuvent envoyer des messages, tandis que les autres participants peuvent seulement les consulter et laisser des commentaires.

Comment ajouter un bot à un groupe/canal Telegram

Cette fonction pour le bot est incluse dans BotFather :

Étape 1. Allez dans les paramètres du bot :

Étape 2. Cliquez sur « Autoriser les groupes ? »

Étape 3. Il devrait y avoir un statut activé.

Ajouter un bot en tant qu’administrateur dans un groupe/canal

Afin d’automatiser le travail dans les chats et les canaux, vous devez ajouter votre propre bot en tant qu’administrateur.

Comment faire ?

Étape 1. Allez dans la gestion du groupe/canal et sélectionnez l’ Les administrateurs onglet

Étape 2. Cliquez sur « Ajouter un admin » .

Étape 3. Saisissez le nom d’utilisateur de votre bot dans le champ de recherche.

Étape 4. Pour un fonctionnement complet, assurez-vous que le bot dispose des droits de lecture et de suppression des messages.

Variables pour travailler dans les chats

Veuillez noter !

L’enregistrement des variables dans les chats de groupe pour des événements tels que rejoindre un chat, quitter un chat, nouveau like, etc. n’est pas disponible.

Les variables seront disponibles uniquement à l’intérieur du bloc qui a fonctionné. Vous pouvez afficher ces variables dans le bloc pour suivre le travail.

Cela n’affectera en AUCUN CAS le fonctionnement des chatbots, il sera impossible de suivre qui est entré/sorti dans la section clients.

• Variables contenant des informations sur l’auteur du message

message_from - l’ID de l’auteur du message

message_from_name - le nom de l’auteur du message

message_from_username - le pseudonyme de l’auteur du message dans Telegram

• Variables contenant des informations sur le message transféré

reply_message_id - le numéro du message transféré

reply_from - qui est l’auteur du message transféré

reply_from_name - le nom de la personne dont le message est transféré

reply_from_username - le pseudonyme de la personne dont le message est transféré

reply_from_chat_id - le numéro de la discussion depuis laquelle le message a été transféré

• Ajout et suppression d’un groupe

Dans ce cas, les callbacks new_chat_member et left_chat_member sont déclenchés (les variables ne sont pas enregistrées dans la fiche du client) :

chat_member_name - nom d’utilisateur

chat_member_username - pseudonyme de l’utilisateur

chat_member_id - numéro de l’utilisateur

Callbacks dans Telegram

client_unsubscribed - le client s’est désabonné, a bloqué le bot

client_returned - le client a débloqué le bot

Callbacks dans les groupes/canaux

new_chat_member - un nouvel utilisateur a été ajouté

left_chat_member - l’utilisateur a quitté le canal

kicked_chat_member - l’utilisateur a été supprimé par l’administrateur

chat_join_request - une demande d’ajout au canal a été reçue

edited_channel_post - le message sur le canal a été modifié (edited_channel_post + date et heure de modification)

Les callbacks sont affichés dans la section Clients section

bot_added_to_group - un bot a été ajouté au chat (peu importe lequel, il répondra à n’importe qui, même si le bot connecté a été ajouté au groupe lui-même) ;

bot_left_group - un callback similaire supprime le bot du canal ;

new_like - a aimé la publication

like_deleted - a supprimé un like de la publication

Le numéro dans le callback (new_like; like_deleted) est l’ID du message auquel il a été répondu ou duquel le like a été supprimé.

Veuillez noter !

• Les callbacks pour les réactions ne sont pas affichés dans les canaux Telegram ! Les callbacks pour les réactions arrivent uniquement dans les groupes.

• Si une personne a mis plusieurs likes, puis en a supprimé 1, il n’est pas indiqué lequel a été supprimé.

Lorsque les callbacks avec réactions apparaissent dans les groupes, des variables sont disponibles dans le bloc :

reaction_on_message_id - contient l’ID du message auquel il a été répondu

reaction_from - identifiant de la personne ayant émis la réaction

message_from_username - nom d’utilisateur de la personne ayant émis la réaction (le cas échéant)

reaction_from_name - nom de la personne ayant émis la réaction

De plus, si Telegram répond à un message, la variable reply_text dans la fiche contiendra le texte complet du message auquel il a été répondu.

Si un message a été envoyé en réponse (en citant un message précédent), le système générera également la tg_quote variable, qui contient le texte cité.

Callbacks avec boost

• chat_boost_from utilisateur #{id_user} - a donné un boost au chat (ou au canal) :

Lorsque ce callback est déclenché, des variables sont générées :

• remove_boost_from utilisateur #{id_user} - ils ont retiré le boost du chat (ou du canal) :

Lorsque ce callback est déclenché,, des variables sont générées :

• chat_boost from giveaway - attribué lors du tirage des étoiles dans le canal

• remove_chat_boost from giveaway - la période de boost pour le tirage des étoiles dans le canal est terminée

Comment automatiser la suppression des notifications système dans les groupes

Pour supprimer automatiquement tous les messages système, il suffit d’attribuer une valeur quelconque à la variable del_tg_system_messages (la variable peut être soit une constante du projet, soit une variable de transaction) et de donner au bot l’autorisation de supprimer des messages.

La variable del_tg_system_messages ne peut être utilisée que dans les groupes. Dans les canaux, attribuer une valeur quelconque à cette variable n’entraînera aucun résultat.

Droits d’administrateur dans les paramètres du groupe Telegram

Les types de notifications système suivants sont supprimés :

- Le nom du groupe a été modifié

- La photo du groupe a été modifiée

- La photo du groupe a été supprimée

- Le message est épinglé

- L’utilisateur a rejoint le groupe

- L’utilisateur a quitté le groupe

Si vous souhaitez supprimer uniquement certains types de notifications système, créez alors la variable del_tg_chosen_messages au lieu de del_tg_system_messages et placez-y un tableau contenant les types de notifications à supprimer, séparés par des virgules.

Veuillez noter !

Ces variables ne fonctionneront que pour les groupes Telegram, mais pas pour les canaux.

Options de notification système :

• 'new_chat_member' – l’utilisateur a rejoint le groupe,

• 'left_chat_member' – l’utilisateur a quitté le groupe,

• 'pinned_message' – le message est épinglé,

• 'delete_chat_photo' – photo du groupe supprimée,

• 'new_chat_photo' – la photo du groupe a été modifiée,

• 'new_chat_title' – le nom du groupe a été modifié

Par exemple, vous devez supprimer tous les types de messages système sauf l’ajout à un groupe ; alors vous devez ajouter tous les types de callbacks à la variable de projet (constante) sauf "new_chat_member".

Veuillez noter !

La suppression des notifications système n’affectera pas les callbacks. Seul le message système de la discussion Telegram sera supprimé.

Forum dans Telegram

Un forum est un groupe dans lequel vous pouvez créer des sujets distincts de discussion. Vous pouvez utiliser les fonctions standard du forum : joindre des fichiers multimédias, publier des sondages et configurer des notifications. Vous pouvez également épingler des messages et ajouter des bots individuels à chaque chat.

L’objectif principal d’un forum est de structurer la communication au sein d’une grande communauté.

Dans une discussion de groupe standard avec de nombreux participants, il devient difficile de suivre les conversations et de trouver les messages pertinents. Les forums résolvent cela en organisant les discussions en fils thématiques dédiés. Cela segmente automatiquement la communauté par sujet et par intérêt, rendant la communication plus ciblée et plus facile à gérer.

Seul le propriétaire du groupe peut créer un sujet s’il y a plus de 100 membres dans le groupe. Si le groupe est lié à un canal, vous ne pourrez alors pas créer de thème. Les sujets sont activés dans les Paramètres du groupe:

En tant qu’administrateur, vous pouvez créer un sujet dans les paramètres du groupe de forum :

Après avoir activé les Sujets, l’avatar passera de rond à carré, ce qui permet de distinguer le forum des autres chats Telegram :

Comment configurer un ensemble client Telegram avec un site web ?

En savoir plus sur la façon de lier un client Telegram et un client du site web après un paiement réussi ici.