Paramètres du chat Telegram et de la messagerie
Travailler avec les ID de plateforme dans MaviBot
Dans MaviBot, toutes les entités Telegram (utilisateurs, groupes, canaux) sont identifiées par une platform_id variable générique. Cette variable ne fait pas de distinction entre les types d’entités.
Problème : Pour utiliser des fonctions comme accept ou reject qui nécessitent des types d’entités spécifiques, vous devez connaître à la fois le chat ID et le user ID séparément.
Solution : Lorsque vous recevez un callback ou un message, stockez immédiatement la platform_id valeur dans deux variables distinctes, nommées selon leur usage :
chat_id– pour stocker l’ID du groupe/canal.user_id– pour stocker l’ID de l’utilisateur individuel.
Cela vous permet de faire référence au bon ID plus tard dans la logique de votre application.
Comment changer le nom du chat via un bot Telegram
Description
tg_set_group_title(platform_id, title) -
Paramètres :
! platform_id
l’ID du chat dans Telegram *
! title
nouveau nom du chat
Comment changer la description du chat via un bot Telegram
Description
tg_set_chat_description(platform_id, description)
! platform_id
l’ID du chat dans Telegram *
! description
nouveau nom du chat
Comment définir un avatar dans un groupe/chat sur Telegram
Description
tg_set_chat_photo(platform_id, photo)
! platform_id
ID du chat dans Telegram *, dans lequel vous souhaitez définir un avatar
! photo
photo via lien
Comment supprimer un avatar dans un groupe/chat sur Telegram
Description
tg_delete_chat_photo(platform_id)
! platform_id
ID du chat dans Telegram *, dans lequel vous devez définir un avatar
Comment bannir un groupe Telegram
Description
tg_ban_chat_sender_chat(platform_id, sender_chat_id)
Paramètres :
! platform_id
ID du chat dans Telegram *que vous devez bannir
! sender_chat_id
ID du chat qui va bannir
En même temps, le propriétaire du chat banni ne peut pas écrire au nom de ses autres chats tant qu’il/elle n’est pas débanni(e).
Comment débloquer un groupe Telegram
Description
tg_unban_chat_sender_chat(platform_id, sender_chat_id)
Paramètre :
! platform_id
ID du chat dans Telegram *, dans lequel vous débloquez
! sender_chat_id
ID du chat que vous débloquez
Comment créer un lien d’invitation pour rejoindre un chat Telegram
Description
tg_create_chat_invite_link(platform_id, member_limit, hours, request, name)
Paramètre :
! platform_id
ID du chat dans Telegram *
member_limit
limite sur le nombre de participants
hours
Temps d’expiration du lien (en heures)
request
un paramètre indiquant qu’après avoir cliqué sur le lien, une demande de rejoindre le chat doit être générée.
name
nom du lien
Lors du passage du member_limit paramètre, la valeur du request paramètre est automatiquement modifiée en Faux. Si vous devez accepter les demandes d’adhésion, laissez alors le member_limit paramètre vide.
Création du lien d’invitation du chat
Comment supprimer un lien d’invitation de chat dans Telegram
Description
tg_revoke_chat_invite_link(platform_id, invite_link)
Paramètres :
! platform_id
ID du chat dans Telegram *
! invite_link
lien que vous devez supprimer
Comment désactiver tous les liens existants et les remplacer par un seul lien
Description
tg_export_chat_link(platform_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
! invite_link
lien que vous devez supprimer
Le résultat est qu’un lien sera le seul moyen d’accéder au groupe jusqu’à ce que des liens supplémentaires soient créés par d’autres moyens.
Utilisez avec prudence. Tous les liens de connexion existants vers votre groupe deviendront inactifs.
Comment accepter une demande et ajouter un utilisateur dans un canal/chat Telegram
Comment refuser une demande dans un canal/chat Telegram
Comment bloquer un utilisateur dans Telegram
Comment débloquer un utilisateur dans Telegram
Comment vérifier le statut d’abonnement dans Telegram
Comment déterminer le nombre de membres dans un canal/chat
Description
tg_get_chat_member_count(platform_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
Comment vérifier si un membre du chat figure dans une liste spécifique
some_client_in_list(list_id, recepient)
Paramètres :
! list_id
numéro de la liste
! recepient
ID de l’utilisateur dans Telegram *. Pour les clients de chat, cette valeur se trouve dans la variable chat_member_id.
Comment afficher les actions du bot à l’utilisateur (écrire/sélectionner un autocollant, etc.)
Description
tg_send_chat_action(platform_id, bot_action, message_thread_id)
! Travaille avec un compte Telegram Business
Paramètres :
! platform_id
ID du chat dans Telegram *
! bot_action
action du bot à partir de la liste
message_thread_id
ID du sujet (disponible pour les supergroupes si la fonctionnalité forum est activée).
Liste des actions disponibles bot_action
typing pour les messages texte, upload_photo pour les photos, record_video ou upload_video pour les vidéos, record_voice ou upload_voice pour les notes vocales, upload_document pour les documents courants, choose_sticker pour les autocollants, find_location pour les données de localisation, record_video_note ou upload_video_note pour la note vidéo.
Cette notification s’affichera jusqu’à ce qu’une réponse soit reçue du bot, mais pendant 5 secondes maximum.
Comment afficher une notification d’alerte à l’utilisateur
Description
tg_answer_callback_query(callback_query_id, text,show_alert,cache_time)
! callback_query_id (obligatoire)
Cet ID vous permet d’identifier la personne qui a cliqué sur le bouton et de lui afficher la notification d’alerte.
! text (obligatoire)
Texte de la notification d’alerte.
show_alert
Indication d’une notification persistante (False — une notification de type infobulle qui s’estompe, True — une fenêtre de notification persistante)
cache_time
Durée maximale, en secondes, pendant laquelle le résultat d’une requête callback peut être mis en cache côté client. Les applications Telegram prendront en charge la mise en cache à partir de la version 3.14. La valeur par défaut est 0
Exemple
Les notifications d’alerte s’affichent uniquement à la suite d’un clic sur le bouton callback dans Telegram.
Par exemple, nous utilisons les boutons suivants :
[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]
Après avoir cliqué sur un bouton, un callback arrive avec le texte contenu dans le champ correspondant. Lorsque vous cliquez sur le bouton « 111 », vous recevrez un callback avec le texte « first ».
Créons un bloc Start et indiquons le texte souhaité dans le déclencheur. Dans notre cas : "first
Si dans le Matches champ vous sélectionnez Ignorer les erreurs et les imprécisions, ce bloc pourra ensuite être réutilisé pour toutes les variantes similaires qui diffèrent de 1 à 2 caractères. Par exemple, pour remercier l’utilisateur d’avoir fourni une note avec un tel bouton.
Ensuite, dans la calculatrice, utilisez la tg_answer_callback_query fonction et passez les paramètres suivants : callback_query_id - cet ID vous permet d’identifier l’utilisateur qui a appuyé sur le bouton et de lui afficher une notification d’alerte text - texte de la notification d’alerte.
Exemple de code à copier :
tg_answer_callback_query('#{callback_query_id}', "Vous avez appuyé sur le bouton 111")
Attention ! Le paramètre callback_query_id doit être transmis exactement comme indiqué dans l’exemple, c’est-à-dire à l’intérieur de '#{}'
Si tout est configuré correctement, l’appui sur le bouton entraînera une notification d’alerte avec le texte spécifié. Dans la version mobile, le nom du bot apparaîtra comme en-tête au-dessus du texte.
Si vous souhaitez afficher un simple message contextuel à la place, passez Faux comme troisième paramètre, comme indiqué dans l’exemple ci-dessous : tg_answer_callback_query('#{callback_query_id}', "Vous avez validé le bouton 222", False)
Ajouter une redirection de bot avec un tag en tant que réponse du bouton callback
Description
tg_callback_url_open(callback_query_id, url, cache_time)
Paramètres :
! callback_query_id
Cet ID vous permet d’identifier la personne qui a cliqué sur le bouton et de lui afficher la notification d’alerte.
! url
URL pointant vers le bot et un paramètre (format : t.me/your_bot?start=XXXX, où your_bot est le nom du bot)
cache_time
Durée maximale, en secondes, pendant laquelle le résultat d’une requête callback peut être mis en cache côté client. Les applications Telegram prendront en charge la mise en cache à partir de la version 3.14. La valeur par défaut est 0
Exemple
ВDans la réponse du bouton callback, vous pouvez ajouter une transition vers le bot à l’aide du tag thetg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX')
Par exemple, utilisons les boutons suivants :
[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]
Après avoir cliqué sur un bouton, un callback arrive avec le texte contenu dans le champ correspondant. Lorsque vous cliquez sur le bouton « 111 », vous recevrez un callback avec le texte « first ».
Créez un bloc avec une vérification de condition principale et indiquez le texte souhaité dans la condition. Dans notre cas : « first » :
Si dans le Option correspondante champ vous sélectionnez Ignorer les erreurs et les imprécisions, ce bloc pourra ensuite être réutilisé pour toutes les variantes similaires qui diffèrent de 1 à 2 caractères. Par exemple, pour remercier l’utilisateur d’avoir fourni une note avec un tel bouton.
Ensuite, dans la calculatrice du bloc, indiquez tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX') :
Comment promouvoir un utilisateur au rang d’administrateur dans un supergroupe ou un canal
Paramètre requis : promote_options_list
Les autorisations suivantes peuvent être spécifiées dans le promote_options_list :
is_anonymous — masque la présence de l’administrateur dans le chat,
can_manage_chat — l’administrateur peut accéder au journal des événements du chat, aux statistiques du chat, aux statistiques des messages dans les canaux, voir les membres du canal, voir les administrateurs anonymes dans les supergroupes et contourner le mode lent. Ce niveau d’autorisation est accordé par défaut si l’un des privilèges suivants est spécifié
can_post_messages — l’administrateur peut créer des publications de canal (canaux uniquement)
can_edit_messages — l’administrateur peut modifier les messages d’autres utilisateurs et épingler des messages (canaux uniquement)
can_delete_messages — l’administrateur peut supprimer les messages d’autres utilisateurs
can_manage_video_chats — l’administrateur peut gérer les discussions vidéo,
can_restrict_members — l’administrateur peut restreindre des membres, les bannir/débannir dans le chat,
can_promote_members — l’administrateur peut nommer de nouveaux administrateurs avec un sous-ensemble de ses propres privilèges, ou rétrograder les administrateurs qu’il a nommés directement ou indirectement (par exemple, des administrateurs nommés par lui)
can_change_info — l’administrateur peut modifier le titre du chat, la photo et d’autres paramètres
can_invite_users — l’administrateur peut inviter de nouveaux utilisateurs dans le chat
can_pin_messages — l’administrateur peut épingler des messages (supergroupes uniquement).
Exemple
Exemple : promotion d’un utilisateur au rang d’administrateur dans un supergroupe :
Dans cet exemple, en plus des autorisations spécifiées, l’autorisation can_manage_chat sera accordée par défaut.
Exemple de code à copier
Comment modifier un titre d’administrateur à l’aide d’un bot dans Telegram
Description
tg_set_administrator_title(platform_id, user_id, title)
Paramètres :
IMPORTANT !
Cela fonctionne uniquement pour les utilisateurs qui ont été promus administrateurs dans le supergroupe par le bot
Exemple de code à copier :
Restrictions générales pour les membres réguliers du chat ou pour des utilisateurs Telegram spécifiques
Description
tg_chat_permission(platform_id, permission, media_permissions)
Paramètres :
! platform_id
identifiant du chat dans Telegram *
! permission
un tableau de valeurs provenant de la liste des restrictions (voir ci-dessous).
1 = l’action est autorisée
0 = l’action est interdite
L’index du tableau correspond à la position dans la liste des restrictions
! media_permissions
un tableau de valeurs définissant les autorisations liées aux médias (voir les détails ci-dessous).
1 = l’action est autorisée
0 = l’action est interdite
L’index du tableau correspond à la position dans la liste des autorisations média
Liste des restrictions pour le paramètre requis permission
Liste des restrictions pour permission : 1. ! can_send_messages - autorisation d’envoyer des messages texte, des contacts, des emplacements et des lieux. 2. ! can_send_media_messages - autorisation d’envoyer des fichiers audio, documents, photos, vidéos, notes vidéo et notes vocales. Elle nécessite can_send_messages 3. ! can_send_polls - autorisation d’envoyer des sondages. Elle nécessite can_send_messages 4. ! can_send_other_messages - autorisation d’envoyer des animations, des jeux, des autocollants et d’utiliser des bots inline. Elle nécessite can_send_media_messages 5. ! can_add_web_page_previews - autorisation d’ajouter des aperçus de pages Web aux messages. Elle nécessite can_send_media_messages 6. ! can_change_info - autorisation de modifier le titre du chat, la photo et d’autres paramètres. Ceci est ignoré dans les supergroupes publics. 7. ! can_invite_users - autorisation d’inviter des utilisateurs 8. ! can_pin_messages - autorisation d’épingler des messages. Ceci est ignoré dans les supergroupes publics. 9. can_manage_topics - autorisation de créer des sujets dans les groupes de forum. Si elle est utilisée dans un groupe du mauvais type, la fonction échouera et renverra une erreur.
Liste des valeurs pour le paramètre requis media_permissions
Valeurs pour accorder des autorisations liées aux médias media_permissions :
1. can_send_audios - autorisation d’envoyer des fichiers audio 2. can_send_documents - autorisation d’envoyer des documents 3. can_send_photos - autorisation d’envoyer des photos 4. can_send_videos - autorisation d’envoyer des vidéos 5. can_send_video_notes - autorisation d’envoyer des messages vidéo circulaires 6. can_send_voice_notes - autorisation d’envoyer des messages vocaux
Restrictions personnelles Telegram pour les utilisateurs réguliers du chat ou pour des utilisateurs Telegram spécifiques
Description
tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions).
Paramètres :
! platform_id
ID du chat dans Telegram *
! user_id
ID de l’utilisateur dans Telegram *
minutes
le nombre de minutes pendant lesquelles la restriction restera active. Si vous ne définissez pas de valeur, la valeur par défaut est 3600qui équivaut à 60 heures. Si vous le définissez à 0, la restriction devient permanente
permission
un tableau de valeurs provenant de la liste des restrictions d’autorisations.
media_permissions
une liste de valeurs pour accorder des autorisations liées aux médias
Liste des restrictions pour le paramètre requis permission
Liste des restrictions pour permission : 1. ! can_send_messages - autorisation d’envoyer des messages texte, des contacts, des emplacements et des lieux. 2. ! can_send_media_messages - autorisation d’envoyer des fichiers audio, documents, photos, vidéos, notes vidéo et notes vocales. Elle nécessite can_send_messages 3. ! can_send_polls - autorisation d’envoyer des sondages. Elle nécessite can_send_messages 4. ! can_send_other_messages - autorisation d’envoyer des animations, des jeux, des autocollants et d’utiliser des bots inline. Elle nécessite can_send_media_messages 5. ! can_add_web_page_previews - autorisation d’ajouter des aperçus de pages Web aux messages. Elle nécessite can_send_media_messages 6. ! can_change_info - autorisation de modifier le titre du chat, la photo et d’autres paramètres. Ceci est ignoré dans les supergroupes publics. 7. ! can_invite_users - autorisation d’inviter des utilisateurs 8. ! can_pin_messages - autorisation d’épingler des messages. Ceci est ignoré dans les supergroupes publics. 9. can_manage_topics - autorisation de créer des sujets dans les groupes de forum. Si elle est utilisée dans un groupe du mauvais type, la fonction échouera et renverra une erreur.
Liste des valeurs pour le paramètre requis media_permissions
Valeurs pour accorder des autorisations liées aux médias media_permissions :
1. can_send_audios - autorisation d’envoyer des fichiers audio 2. can_send_documents - autorisation d’envoyer des documents 3. can_send_photos - autorisation d’envoyer des photos 4. can_send_videos - autorisation d’envoyer des vidéos 5. can_send_video_notes - autorisation d’envoyer des messages vidéo circulaires 6. can_send_voice_notes - autorisation d’envoyer des messages vocaux
Exemple
Exemple d’utilisation de la fonction, où l’utilisateur est restreint de tout pendant 3 minutes :
Lorsque l’utilisateur entre dans le chat, il verra une notification indiquant qu’il ne peut pas envoyer de messages dans le chat. Si une limite de temps est définie, il verra également la durée de cette restriction.
Exemple de code à copier :
Comment épingler un message
Description
tg_pin_chat_message(platform_id, message_id, disable_notification)
Paramètres :
! platform_id
ID du chat dans Telegram *
message_id
ID du message à épingler
disable_notification
Le paramètre définit si une notification doit être envoyée à tous les membres du chat au sujet d’un nouveau message épinglé (les notifications sont toujours désactivées dans les canaux et les chats privés). Si vous ne souhaitez pas envoyer de notifications, définissez le paramètre disable_notification à 1. Sinon, définissez-le à 0.
Comment désépingler un message
Description
tg_unpin_chat_message(platform_id, message_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
message_id
ID du message qui doit être désépinglé. Si message_id n’est pas fourni, le message épinglé le plus récent (par date d’envoi) sera désépinglé
Comment désépingler tous les messages épinglés
Description
tg_unpin_all(platform_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
ATTENTION !
Telegram a une limitation pour les fonctions d’épinglage/désépinglage des messages.
Les limites de temps pour l’utilisation de tg_pin_chat_message / tg_unpin_chat_message / tg_unpin_all ne sont PAS définies par le système MaviBot.
Si le temps autorisé pour épingler un message est écoulé, la fonction renverra quand même true, mais Telegram n’appliquera pas le changement.
Il est également important de noter que les messages épinglés peuvent rester en cache, ils peuvent donc ne pas disparaître visuellement immédiatement.
Comment créer un sondage dans Telegram
Description
tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
! question
question
! options
un tableau d’options de réponse
is_anonymous
1 - sondage anonyme, '' - non anonyme
allows_multiple_answers
1 - plusieurs réponses sont possibles, '' - une seule réponse
reply_markup
clavier ou '' - sans clavier
disable_notification
indicateur d’envoi avec notification sonore (par défaut 0) 1 – désactiver la notification à la réception, 0 – envoyer avec notification
protect_content
1 pour protéger contre la copie et les captures d’écran, '' aucune protection
token
jeton du bot ; s’il n’est pas fourni, celui en cours est utilisé
reply_to_message_id
ID du message cité
message_thread_id
ID du sujet (disponible pour les supergroupes si la fonctionnalité forum existe)
business_connection_id
valeur lors de la connexion d’un bot (Business ID). S’affiche dans les canaux. Doit être fourni si le jeton du bot est utilisé et que le message doit être envoyé via un compte utilisateur connecté au bot
Important à savoir !
Remarques
1. La fonction renvoie une réponse de Telegram avec message_id. Il est préférable de la sauvegarder. En utilisant message_id, vous pouvez arrêter le sondage avec tg_stop_poll (voir la description ci-dessous) et obtenir le résultat.
2. Si un utilisateur ajoute un sondage dans un messager, un callback est envoyé au chat :
poll_added - partie inchangée YOUR QUESTION - texte de la question du sondage
Exemple de callback lors de l’ajout d’un sondage dans un canal
Exemple de callback lors de l’ajout d’un sondage dans un chat
Le deuxième callback après poll_added contient des chiffres - ce n’est rien d’autre que l’identifiant de l’utilisateur dans Telegram qui a ajouté le sondage.
Lors de la création d’un sondage par le bot, aucun callback n’est envoyé.
3. Dans un canal, on peut créer uniquement des sondages anonymes
Attention, il est recommandé d’envoyer dans le groupe uniquement des sondages anonymes !
4. Après avoir créé le sondage, enregistrez son identifiant dans une variable afin de comprendre à quel sondage le callback est arrivé.
Exemple
Les retours clients sont essentiels à notre croissance. Les sondages offrent une méthode simple pour recueillir ces retours et les transformer en conclusions commerciales concrètes.
Exemple de code à copier :
Fonction pour créer un sondage dans Telegram :
Le sondage que nous avons créé dans Telegram
Comment créer un quiz dans Telegram
Description
tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )
Paramètres :
! platform_id
ID du chat dans Telegram *
! question
question
! options
un tableau d’options de réponse
! explanation
texte affiché lorsqu’un utilisateur sélectionne une mauvaise réponse ou clique sur l’icône de la lampe dans un quiz, 0 à 200 caractères avec pas plus de deux sauts de ligne après l’analyse des entités.
! correct_option_id
numéro de la bonne réponse, numérotation à partir de 1
is_anonymous
1 - sondage anonyme, '' - non anonyme
reply_markup
clavier ou '' - sans clavier
parse_mode
format d’explication : markdown, html, ou '' (chaîne vide pour aucun formatage)
protect_content
1 pour protéger contre la copie et les captures d’écran, '' aucune protection
disable_notification
indicateur d’envoi avec notification sonore (par défaut 0) 1 – désactiver la notification à la réception, 0 – envoyer avec notification
token
jeton du bot ; s’il n’est pas fourni, celui en cours est utilisé
reply_to_message_id
ID du message cité
message_thread_id
ID du sujet (disponible dans les supergroupes avec les fonctions forum actives)
Important à savoir !
Remarques
1. Enregistrez le message_id
La fonction API renvoie une réponse de Telegram contenant un message_id. Enregistrez toujours cet ID, car il est nécessaire pour :
Terminer le quiz à l’aide de la
tg_stop_pollfonction (voir la description ci-dessous).Récupérer les résultats finaux.
2. Callback poll_added
Si un utilisateur ajoute un sondage à un canal, le bot reçoit un callback :
Format :
poll_added+ Question du sondageS’il est ajouté à un chat de groupe : le callback inclut également le Telegram User ID de la personne qui a ajouté le sondage.
S’il est créé par le bot : Aucun poll_added callback n’est envoyé.
3. Restriction de canal
Seuls les quiz anonymes peuvent être créés dans les canaux.
4. Callback poll_answer (vote de l’utilisateur)
Lorsqu’un utilisateur vote dans un quiz envoyé à un chat privé ou group, un callback est envoyé au dialogue du bot avec ce client :
Format :
poll_answer+ ID du sondage + [Index de la réponse]Exemple :
poll_answer 5325838371359031648 [3]Remarque : la numérotation des réponses commence à 0.
[3]signifie que l’utilisateur a sélectionné la quatrième option de réponse.
5. Webhook pour les sondages de groupe non anonymes
Pour les sondages non anonymes dans les groupes où le bot est administrateur, un webhook est envoyé pour chaque vote. À la réception, le bot transmettra le poll_answer callback (comme au point 4) à son dialogue avec le client correspondant.
6. Exigence d’activation et bonne pratique
Exigence : un bot ne peut pas initier une conversation. Si un client n’a jamais contacté le bot, vous ne pouvez pas lui envoyer de message direct en réponse à son vote tant qu’il n’a pas activé le bot au préalable (par exemple, en envoyant une
/startcommande).
Recommandation : pour éviter cette limitation, il est fortement recommandé d’envoyer uniquement des quiz anonymes aux groupes.
7. Suivez vos sondages
Immédiatement après avoir créé un quiz, enregistrez son ID du sondage unique dans une variable. Cela vous permet d’identifier à quel sondage précis se réfère un callback entrant.
Comment terminer un sondage
Description
tg_stop_poll(platform_id, message_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
! message_id
ID du message du sondage/quiz. Il peut être obtenu à partir du webhook
Appeler cette fonction pour terminer un sondage/quiz renvoie un dictionnaire contenant les résultats finaux.
Comment travailler avec les sujets dans Telegram
Important : le sujet principal du groupe n’a pas d’ID et nécessite des fonctions distinctes pour être utilisé.
Comment renommer le Sujet Général du groupe
Description
tg_edit_general_forum_topic(platform_id, topic_name)
Paramètres :
! platform_id
ID du chat dans Telegram *
! topic_name
nouveau nom du sujet
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Exemple
Le Sujet Général des groupes peut être modifié à l’aide de la tg_edit_general_forum_topic() fonction. Elle requiert deux paramètres obligatoires : l’ID du chat et le nouveau nom du Sujet du Groupe :
Exemple de code à copier
renommer le chat du Sujet Général/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')
Comment fermer le Sujet Général
Description
tg_close_general_forum_topic(platform_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Exemple de code à copier
/fermer le chat du Sujet Général/
answer = tg_close_general_forum_topic(-1001839380031)
Comment rouvrir un Sujet Général précédemment fermé
Description
tg_reopen_general_forum_topic(platform_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Exemple de code à copier
/rouvrir le chat du Sujet Général/
answer = tg_reopen_general_forum_topic(-1001839380031)
Comment masquer le Sujet Général
Description
tg_hide_general_forum_topic(platform_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Le chat du Sujet Général peut être fermé pour les participants du sujet (ils peuvent lire mais pas écrire) et masqué de la liste générale des chats Telegram pour les nouveaux utilisateurs.
Exemple de code à copier
/masquer le chat du Sujet Général/
answer = tg_hide_general_forum_topic(-1001839380031)
Comment afficher le Sujet Général ou restaurer sa visibilité
Description
tg_unhide_general_forum_topic(platform_id)
Paramètres :
! platform_id
ID du sujet dans Telegram *
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Important !
Cette fonction ne rouvre pas le Sujet Général ; elle le rend seulement visible.
Exemple de code à copier
/afficher le chat du Sujet Général/
answer = tg_unhide_general_forum_topic(-1001839380031)
Comment créer un nouveau sujet dans Telegram
Description
tg_create_forum_topic(platform_id, name, icon, icon_color)
Paramètres :
! platform_id
ID du chat dans Telegram *
! name
nouveau nom du sujet
icon
identifiant emoji à définir pour le sujet. Passé sous forme de chaîne. Vous ne pouvez utiliser que les emojis de la liste récupérée par la tg_get_forum_icon fonction.
icon_color
couleur de l’emoji parmi la liste : 7322096, 16766590, 13338331, 9367192, 16749490, 16478047. Tous les emojis ne prennent pas en charge les changements de couleur.
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
La couleur définie ne peut pas être modifiée ; la couleur ne peut être attribuée qu’au moment de la création du sujet.
Une fois exécutée, la fonction renverra une réponse contenant les paramètres du nouveau sujet, y compris l’ID du sujet (nécessaire pour diverses fonctions).
Exemple de code à copier
Pour créer un chat de sujet supplémentaire
answer = tg_create_forum_topic(-1001839380031, 'second_bot_topic', None, 7322096)
Pour enregistrer l’ID du chat de sujet supplémentaire créé
answer={"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}/
idtema1=answer['result']['message_thread_id']
Comment modifier un sujet. Comment renommer et/ou changer l’emoji d’un sujet
Description
tg_edit_forum_topic(platform_id, message_thread_id, name, icon)
Paramètres :
! platform_id
ID du chat dans Telegram *
! message_thread_id
ID du chat du sujet supplémentaire
name
nouveau nom du sujet
icon
identifiant emoji à définir pour le sujet. Passé sous forme de chaîne. Vous ne pouvez utiliser que les emojis de la liste récupérée par la tg_get_forum_icon fonction.
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Comment fermer un sujet sélectionné
Description
Fermer un sujet signifie le rendre en lecture seule ; l’écriture dans un sujet fermé n’est pas autorisée.
tg_close_forum_topic(platform_id, message_thread_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
! message_thread_id
ID du chat du sujet supplémentaire
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Comment rouvrir un sujet précédemment fermé
Description
tg_reopen_forum_topic(platform_id, message_thread_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
! message_thread_id
ID du chat du sujet supplémentaire
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Comment supprimer un sujet et tous ses messages
Description
tg_delete_forum_topic(platform_id, message_thread_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
! message_thread_id
ID du chat du sujet supplémentaire
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Comment désépingler tous les messages d’un sujet
Description
tg_unpin_topic_messages(platform_id, message_thread_id)
Paramètres :
! platform_id
ID du chat dans Telegram *
! message_thread_id
ID du chat du sujet supplémentaire
bot_name
paramètre facultatif : nom du bot.
Lorsque vous travaillez avec des sujets, vous pouvez préciser quel bot doit exécuter la fonction. C’est utile si votre projet utilise plusieurs bots Telegram. Trouvez le nom du bot dans la section « Channels », dans le champ « Group ID ».
Comment obtenir la liste des emojis pour un sujet Telegram
Description
Comment obtenir la liste des emojis
tg_get_forum_icon() – cette fonction renvoie une liste d’emojis disponibles pour être utilisés comme icônes de sujet de forum. Le résultat doit être assigné à une variable, car elle renvoie un dictionnaire où chaque clé est un emoji et sa valeur correspondante est l’identifiant unique de l’emoji (id).
Paramètres : aucun.
Le contenu de la liste des emojis
Pour obtenir la liste des emojis pour un chat de sujet, envoyez la commande au chat concerné.
La fonction renverra la liste des emojis dans sa réponse. Cela signifie que la variable answer contiendra un dictionnaire comme valeur.
{'📰': '5434144690511290129', '💡': '5312536423851630001', '⚡️': '5312016608254762256', '🎙': '5377544228505134960', '🔝': '5418085807791545980', '🗣': '5368697802761185083', '🆒': '5420216386448270341', '❗️': '5379748062124056162', '📝': '5357193964787081133', '📆': '5433614043006903194', '📁': '5357315181649076022', '🔎': '5309965701241379366', '📣': '5309984423003823246', '🔥': '5312241539987020022', '❤️': '5312138559556164615', '❓': '5377316857231450742', '📈': '5350305691942788490', '📉': '5350713563512052787', '💎': '5309958691854754293', '💰': '5350452584119279096', '💸': '5309929258443874898', '\U0001fa99': '5377690785674175481', '💱': '5310107765874632305', '⁉️': '5377438129928020693', '🎮': '5309950797704865693', '💻': '5350554349074391003', '📱': '5409357944619802453', '🚗': '5312322066328853156', '🏠': '5312486108309757006', '💘': '5310029292527164639', '🎉': '5310228579009699834', '‼️': '5377498341074542641', '🏆': '5312315739842026755', '🏁': '5408906741125490282', '🎬': '5368653135101310687', '🎵': '5310045076531978942', '🔞': '5420331611830886484', '📚': '5350481781306958339', '👑': '5357107601584693888', '⚽️': '5375159220280762629', '🏀': '5384327463629233871', '📺': '5350513667144163474', '👀': '5357121491508928442', '\U0001fae6': '5357185426392096577', '🍓': '5310157398516703416', '💄': '5310262535021142850', '👠': '5368741306484925109', '✈️': '5348436127038579546', '\U0001f9f3': '5357120306097956843', '🏖': '5310303848311562896', '⛅️': '5350424168615649565', '🦄': '5413625003218313783', '🛍': '5350699789551935589', '👜': '5377478880577724584', '🛒': '5431492767249342908', '🚂': '5350497316203668441', '🛥': '5350422527938141909', '🏔': '5418196338774907917', '🏕': '5350648297189023928', '🤖': '5309832892262654231', '\U0001faa9': '5350751634102166060', '🎟': '5377624166436445368', '🏴\u200d☠️': '5386395194029515402', '🗳': '5350387571199319521', '🎓': '5357419403325481346', '🔭': '5368585403467048206', '🔬': '5377580546748588396', '🎶': '5377317729109811382', '🎤': '5382003830487523366', '🕺': '5357298525765902091', '💃': '5357370526597653193', '\U0001fa96': '5357188789351490453', '💼': '5348227245599105972', '\U0001f9ea': '5411138633765757782', '👨\u200d👩\u200d👧\u200d👦': '5386435923204382258', '👶': '5377675010259297233', '🤰': '5386609083400856174', '💅': '5368808634392257474', '🏛': '5350548830041415279', '\U0001f9ee': '5355127101970194557', '🖨': '5386379624773066504', '👮\u200d♂️': '5377494501373780436', '\U0001fa7a': '5350307998340226571', '💊': '5310094636159607472', '💉': '5310139157790596888', '\U0001f9fc': '5377468357907849200', '\U0001faaa': '5418115271267197333', '🛃': '5370947704199323325', '🍽': '5350344462612570293', '🐟': '5384574037701696503', '🎨': '5310039132297242441', '🎭': '5350658016700013471', '🎩': '5357504778685392027', '🔮': '5350367161514732241', '🍹': '5350520238444126134', '🎂': '5310132165583840589', '☕️': '5350392020785437399', '🍣': '5350406176997646350', '🍔': '5350403544182694064', '🍕': '5350444672789519765', '\U0001f9a0': '5312424913615723286', '💬': '5417915203100613993', '🎄': '5312054580060625569', '🎃': '5309744892677727325'}
Mis à jour