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 a des exigences spécifiques pour les fichiers téléchargés :

  • Les bots peuvent envoyer des fichiers jusqu'à 2 Go.
  • Vous pouvez utiliser file_id pour travailler avec des fichiers déjà téléchargés. Dans ce cas, les limites de fichiers suivent la documentation Telegram.
  • Les fichiers peuvent être envoyés via une URL (le bot télécharge et 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 des imitateurs frauduleux.

Étapes de création :

  1. Démarrez une conversation avec BotFather.
  2. Envoyez la commande : /newbot
  3. Choisissez un nom pour votre bot (c'est le nom d'affichage pour les utilisateurs).
  4. Choisissez un nom d'utilisateur pour votre bot. Il doit se terminer par bot ou _bot (par exemple, 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 un mot de passe pour votre bot. Sauvegardez-le en toute sécurité et ne le partagez jamais avec personne.

Accédez à la section Messagers, sélectionnez Telegram, et collez le token de votre bot dans le champ prévu.

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

Travailler avec les groupes/chaînes Telegram

Informations utiles

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

La chaîne Telegram est un moyen de communication unidirectionnel. Seul le propriétaire ou les administrateurs peuvent envoyer des messages, tandis que les autres participants peuvent uniquement les consulter et laisser des commentaires.

Comment ajouter un bot à un groupe/une chaîne Telegram

Cette fonctionnalité pour le bot est incluse dans BotFather :

Étape 1. Accédez aux paramètres du bot :

Étape 2. Cliquez sur "Autoriser les groupes ?"

Étape 3. Le statut doit être activé.

Ajouter un bot en tant qu'administrateur dans un groupe/une chaîne

Pour automatiser le travail dans les discussions et les chaînes, vous devez ajouter votre propre bot en tant qu'administrateur.

Comment faire ?

Étape 1. Accédez à la gestion du groupe/de la chaîne et sélectionnez l'onglet Administrateurs

Étape 2. Cliquez sur le bouton "Ajouter un administrateur".

Étape 3. Saisissez le nom d'utilisateur de votre bot dans la zone de recherche.

Étape 4. Pour une fonctionnalité complète, assurez-vous que le bot dispose des droits de lecture et de suppression des messages.

Variables pour travailler dans les discussions

Veuillez noter !

L'enregistrement des variables dans les discussions de groupe pour des événements tels que rejoindre une discussion, quitter une discussion, 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 PAS le fonctionnement des chatbots, il sera impossible de suivre qui est entré/sorti dans la section clients.

  • Variables avec 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 pseudo de l'auteur du message dans Telegram

  • Variables avec 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 pseudo de la personne dont le message est transféré

reply_from_chat_id - le numéro du dialogue à partir duquel 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 - pseudo 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/chaînes

new_chat_member - un nouvel utilisateur a été ajouté

left_chat_member - l'utilisateur a quitté la chaîne

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

chat_join_request - une demande d'ajout à la chaîne a été reçue

edited_channel_post - le message sur la chaîne a été modifié (edited_channel_post + date et heure de la modification)

Les callbacks sont affichés dans la section Clients

bot_added_to_group - un bot a été ajouté à la discussion (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 est la suppression du bot de la chaîne ;

new_like - a aimé le message

like_deleted - a supprimé un like du message

Le nombre dans le callback (new_like ; like_deleted) est l'ID du message auquel on a répondu ou qui a été supprimé.

Veuillez noter !

  • Les callbacks pour les réactions ne sont pas affichés dans les chaînes Telegram ! Les callbacks pour les réactions ne viennent que dans les groupes.
  • Si une personne a mis plusieurs likes, puis en a supprimé 1, cela n'indique pas lequel a été supprimé.

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

reaction_on_message_id - contient l'ID du message auquel on a répondu

reaction_from - id de la personne dont provient la réaction

message_from_username - pseudo de la personne dont provient la réaction (si existant)

reaction_from_name - nom de la personne dont provient 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 on a répondu.

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

Callbacks avec boost

  • chat_boost_from user #{id_user} - a donné un boost à la discussion (ou à la chaîne) :

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

  • remove_boost_from user #{id_user} - ils ont retiré le boost de la discussion (ou de la chaîne) :

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

  • chat_boost from giveaway - émis lors du tirage au sort d'étoiles dans la chaîne
  • remove_chat_boost from giveaway - la période de boost pour le tirage au sort d'étoiles dans la chaîne 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 n'importe quelle valeur à la variable del_tg_system_messages (la variable peut être soit une constante de 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 chaînes, attribuer une valeur à cette variable n'aura 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

- Photo du groupe 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 la variable del_tg_chosen_messages au lieu de la variable del_tg_system_messages et placez-y un tableau avec 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 chaînes.

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'adhésion à 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 du dialogue Telegram sera supprimé.

Forum dans Telegram

Un forum est un groupe où vous pouvez créer des sujets séparés pour la discussion. Vous pouvez utiliser les fonctions standard dans le 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 discussion.

Le but 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, suivre les conversations et trouver des messages pertinents devient difficile. Les forums résolvent ce problème en organisant les discussions en fils thématiques dédiés. Cela segmente automatiquement la communauté par sujet et intérêt, rendant la communication plus ciblée et gérable.

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é à une chaîne, vous ne pourrez 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 forum :

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

Comment configurer un bundle 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.