Fonctions pour envoyer des pièces jointes dans les messages

! Ces fonctions vous permettent d’envoyer des fichiers de tout type. Formats recommandés : GIF, PDF, ZIP jusqu’à 2 Go.

! Fonctionne avec un compte professionnel Telegram

tg_send_document(platform_id, document, caption, reply_markup, parse_mode,reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

Paramètres :

! platform_id — identifiant du client dans Telegram auquel le message doit être envoyé *

! document - lien vers le document sur le serveur de Telegram. L’obtention du lien via tg_request est expliquée ici.

caption - description, jusqu’à 1024 caractères

reply_markup — paramètres des boutons **

parse_mode — mise en forme du texte dans la description (gras ou italique) ***. Valeurs possibles : html, markdown, markdownV2. ссылка

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''.

disable_notification — indicateur pour contrôler les notifications sonores (par défaut : 0). 1 - envoyer sans notification, 0 - envoyer avec notification

message_thread_id — identifiant du fil de discussion (disponible dans les supergroupes avec la fonctionnalité forum) entities — permet de réutiliser un texte préformaté avec des styles. Il suffit de définir le décalage et la plage de caractères pour la mise en forme. Un exemple est disponible dans tg_request dans le champ correspondant. Le paramètre doit être un dictionnaire. Exemple de passage du paramètre : entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}] Dans cet exemple, seul le dictionnaire est affiché, tandis que le texte réel du message est défini dans une variable séparée.

Pour simplifier la description d’un ensemble de boutons, vous pouvez utiliser le astuce.

! Ces fonctions vous permettent d’envoyer des fichiers de tout type. Formats recommandés : GIF, PDF, ZIP jusqu’à 2 Go.

tg_send_some_document(platform_id, document_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Paramètres :

! platform_id — identifiant du client dans Telegram auquel le message doit être envoyé *

! document_list - un tableau de documents. Un exemple de construction d’un tel tableau est fourni ci-dessous

disable_notification — indicateur pour contrôler les notifications sonores (par défaut : 0). 1 - envoyer sans notification, 0 - envoyer avec notification

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''.

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

message_thread_id — identifiant du fil de discussion (disponible dans les supergroupes avec la fonctionnalité forum)

Exemple de construction d’un tableau document_list : '[["Lien du document", "légende", "parse_mode"], ["Lien du document 2"], ["Lien du document 3", "légende"]]'

Exemple de formatage des données pour un seul document ["Lien du document", "légende", "parse_mode"]

L’ordre des paramètres est important ! Lors de la création d’un tableau de documents, les guillemets " " peuvent être omis.

Description des paramètres du tableau document_list : ! Lien du document - lien du document depuis le serveur Telegram. L’obtention du lien via tg_request est expliquée ici caption — description jusqu’à 1024 caractères parse_mode — mise en forme de la description, c.-à-d. mise en gras ou en italique du texte ***

Passons en revue un exemple d’envoi d’un seul document, en ajoutant des boutons inline et une description au document :

1. Commencez par obtenir le lien vers votre document. Une explication détaillée de la façon de procéder peut être trouvée ici.

2. Créez un bloc et définissez les variables comme indiqué sur la capture d’écran :

   
3. Envoyez le bloc à nous-mêmes et voyons le résultat de notre travail :

Voyons maintenant l’envoi de plusieurs documents.

1. Ici aussi, vous devez obtenir un lien interne Telegram pour chaque document et former un tableau. lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'

2. Enfin, assemblez la fonction pour l’envoi de documents :

3. Et regardez le résultat du travail :

N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens

Exemple de code pour l’envoi d’un seul document :

lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "Excellent","callback_data":"Answer1"}, {"text": "Non accepté","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Envoi du document", opts) 

Exemple de code pour l’envoi de plusieurs documents :

lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)

! Cette fonction permet d’envoyer des fichiers vocaux de type .OGG encodés avec OPUS, d’une taille maximale de 2 Go.

! Fonctionne uniquement avec un compte professionnel Telegram

tg_send_voice(platform_id, voice, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

Paramètres :

! platform_id — identifiant du client dans Telegram auquel le message doit être envoyé *

! voice - lien vers le message vocal au format .OGG

caption - description jusqu’à 1024 caractères

reply_markup — paramètres des boutons **

parse_mode — mise en forme du texte dans la description en gras ou italique ***. Valeurs possibles : html, markdown, markdownV2.

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur sauf 0, False ou des guillemets vides ''.

disable_notification — indicateur pour envoyer le message avec ou sans notification sonore (par défaut : 0) 1 - envoyer sans notification, 0 - envoyer avec notification

message_thread_id — identifiant du sujet (disponible dans les supergroupes si la fonctionnalité forum est activée). entities —avec ce paramètre, vous pouvez simplement copier un texte formaté avec toutes ses fonctionnalités et indiquer de quel caractère à quel caractère il sera affiché avec un style particulier. Vous pouvez consulter un exemple dans tg_request dans le champ correspondant. Le paramètre doit être un dictionnaire. Exemple de passage du paramètre : entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}] L’exemple montre uniquement un dictionnaire, tandis que le texte du message lui-même est stocké dans une variable.

Pour simplifier la description de l’ensemble de boutons, vous pouvez utiliser le astuce

! Cette fonction permet d’envoyer des fichiers audio de type .MP3 ou .M4A d’une taille maximale de 2 Go.

! Fonctionne avec un compte professionnel Telegram

tg_send_some_audio(platform_id, audio_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Paramètres :

! platform_id — identifiant du client dans Telegram auquel le message doit être envoyé *

! audio_list - un tableau de fichiers audio (détails ci-dessous)

disable_notification — indicateur pour envoyer le message avec ou sans notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur sauf 0, False ou des guillemets vides ''.

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

message_thread_id — ID du sujet (disponible dans les supergroupes avec fonctionnalité forum)

Exemple de construction du tableau audio_list : '[["Lien audio 1", "légende", "parse_mode"], ["Lien audio 2"], ["Lien audio 3", "légende"]]'

Exemple d’un seul audio : ["Lien audio", "légende", "parse_mode"]

L’ordre des paramètres est important ! Lors de la construction du tableau de fichiers audio, les guillemets "" peuvent être omis

Description des paramètres : ! Lien audio - lien vers un fichier audio au format .OGG caption — description (jusqu’à 1024 caractères) parse_mode — mise en forme du texte dans la légende en gras ou italique ***

Comme indiqué ci-dessus, la fonction fonctionne avec des fichiers .OGG. Par conséquent, la première tâche consiste à obtenir un enregistrement audio dans ce format. Si vous avez un .fichier MP3, vous pouvez le convertir en .OGG à l’aide du https://t.me/mp3toolsbot bot.

Ensuite, envoyez le fichier obtenu à vous-même dans le bot pour obtenir le file_id en suivant l’algorithme décrit ici.

Maintenant, assemblez la fonction :

Génial ! Bravo !

N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens

Si l’envoi d’un message échoue en raison des paramètres de confidentialité, l’erreur suivante est renvoyée :

{"ok":false,"error_code":400,"description":"Bad Request: user restricted receiving of voice messages"}

Cause de l’erreur : les paramètres de confidentialité de l’utilisateur contiennent l’option « Ne pas recevoir de messages vocaux » (soit de tout le monde, soit seulement de certains utilisateurs) :

Même si l’utilisateur désactive cette restriction de confidentialité, l’erreur continuera à apparaître.

En fait, seul le retrait complet du client de la base de données Mavibot aide à surmonter cette erreur, même si l’utilisateur a déjà activé les autorisations.

Solution :

Après que l’utilisateur a modifié ses paramètres de confidentialité, vous devez attendre une pause de 30 à 60 secondes (jusqu’à ce que les serveurs du messager traitent les changements), et seulement ensuite envoyer une requête API à Telegram via le bot : https://api.telegram.org/bot<TOKEN>/getChat?chat_id=#{platform_id}

Après cela, les données utilisateur seront actualisées et les messages vocaux seront envoyés correctement.

! Cette fonction permet d’envoyer des GIF ou des vidéos H.264/MPEG-4 AVC sans son, d’une taille maximale de 2 Go.

! Fonctionne avec un compte professionnel Telegram

tg_send_animation(platform_id, animation, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé. *

! animation- lien vers l’animation. La façon d’obtenir un lien via tg_request est expliquée ici

caption - description jusqu’à 1024 caractères

reply_markup — configuration des boutons **

parse_mode — mise en forme du texte dans la légende en gras ou italique ***. Valeurs possibles : html, markdown, markdownV2

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''.

has_spoiler — active le spoiler. Pour l’activer, définissez True.

disable_notification — indicateur pour envoyer le message avec ou sans notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum) entities — avec ce paramètre, vous pouvez simplement copier un texte formaté avec toutes ses fonctionnalités et indiquer de quel caractère à quel caractère il sera affiché avec un style particulier. Vous pouvez consulter un exemple dans tg_request dans le champ correspondant. Le paramètre doit être un dictionnaire.

show_caption_above_media - si défini sur True, la légende du message s’affichera au-dessus du média Exemple de passage du paramètre : entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}] Dans cet exemple, seul le dictionnaire est affiché, tandis que le texte du message lui-même est stocké dans une variable

Pour simplifier les descriptions de l’ensemble de boutons, vous pouvez utiliser le astuce

Rendons la tâche plus complexe et envoyons une animation avec protection contre la copie et spoiler.

Comme toujours, le processus commence par l’obtention du lien interne Telegram pour l’animation sélectionnée (détails ici).

Enfin, assemblez la fonction :

Et regardez le résultat du travail :

N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens

! Cette fonction vous permet d’envoyer des fichiers MPEG4 d’une taille maximale de 2 Go. (Les autres formats peuvent être envoyés comme fichiers à l’aide de tg_send_document())

! Travaille avec un compte Telegram Business

tg_send_video(platform_id, video, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media, cover )

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

! video - lien vidéo. Pour savoir comment obtenir des liens via tg_request, voir ici

caption - description jusqu’à 1024 caractères

reply_markup — paramètres des boutons **

parse_mode — mise en forme du texte dans la légende en gras ou italique ***. Valeurs possibles : html, markdown, markdownV2.

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''.

has_spoiler — active le spoiler. Pour l’activer, définissez True

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum) entities — avec ce paramètre, vous pouvez simplement copier un texte formaté avec toutes ses fonctionnalités et indiquer de quel caractère à quel caractère il sera affiché avec un style particulier. Vous pouvez consulter un exemple dans tg_request dans le champ correspondant. Le paramètre doit être un dictionnaire.

show_caption_above_media - si défini sur True, le texte du message sera affiché au-dessus du média.

cover - image de couverture de la vidéo dans le message. L’obtention de l’URL via tg_request est ici. Exemple de passage du paramètre : entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}] Dans cet exemple, seul le dictionnaire est affiché, tandis que le texte du message lui-même est stocké dans une variable

Pour simplifier les descriptions de l’ensemble de boutons, vous pouvez utiliser le astuce

! Fonctionne avec un compte professionnel Telegram

tg_send_some_video(platform_id, video_list, disable_notification, protect_content, reply_to_message_id, has_spoiler, message_thread_id)

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

! video_list - un tableau de fichiers vidéo (détails ci-dessous)

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

has_spoiler — active le format spoiler (facultatif ; définissez True pour l’activer)

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum)

Exemple de construction d’un tableau vidéo video_list : '[["Lien vidéo1", "légende", "parse_mode"], ["Lien vidéo2"], ["Lien vidéo3", "légende"]]'

Exemple de construction d’un seul audio : ["Lien vidéo", "légende", "parse_mode"]

L’ordre des paramètres est important ! Lors de la construction du tableau de fichiers vidéo, les guillemets "" peuvent être omis

Description des paramètres : ! Lien vidéo — URL vidéo interne Telegram. L’obtention du lien via tg_request est décrite ici. caption — légende textuelle jusqu’à 1024 caractères parse_mode — mise en forme du texte dans la légende en gras ou italique ***. Valeurs possibles : html, markdown, markdownV2.

Commençons donc par obtenir le lien du fichier que nous voulons envoyer, puis remplissons les paramètres de la fonction requis :

Après vérification, nous obtenons la vidéo :

N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens

! À partir de la version 4.0, Telegram prend en charge l’envoi de vidéos MPEG4 rondes d’une durée maximale d’une minute.

! Travaille avec un compte Telegram Business

tg_send_video_note(platform_id, video_note, reply_markup, protect_content, reply_to_message_id, disable_notification, message_thread_id)

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

! video_note - lien vidéo. La façon d’obtenir le lien via tg_request est décrite ici reply_markup — paramètres des boutons **

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum)

Pour simplifier les descriptions de l’ensemble de boutons, vous pouvez utiliser le astuce

Si vous avez une vidéo carrée, vous pouvez la convertir en vidéo ronde à l’aide du https://t.me/roundNoteBot bot :

Une fois que vous avez la vidéo ronde, envoyez-la à vous-même dans le bot pour obtenir le lien (détails ici), puis configurez la fonction d’envoi de la vidéo ronde :

N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens

! Travaille avec un compte Telegram Business

tg_send_venue(platform_id, latitude, longitude, title, address, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

! latitude —latitude

! longitude — longitude

! title — titre

! address — adresse

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

reply_markup — paramètres des boutons **

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum)

Pour simplifier les descriptions de l’ensemble de boutons, vous pouvez utiliser le astuce

Commençons donc par déterminer les coordonnées de l’endroit. Vous pouvez les obtenir à l’aide de Google Maps

Ensuite, convertissez les coordonnées obtenues des degrés décimaux au format géographique à l’aide de n’importe quel convertisseur de coordonnées:

Passons maintenant au remplissage des paramètres de la fonction et à l’obtention du résultat souhaité :

! Fonctionne avec un compte professionnel Telegram

Telegram fournit un moyen rapide de partager des contacts depuis votre carnet d’adresses. Le messager prend en charge l’envoi de vCard — une carte de visite électronique

La fonction tg_send_contact permet d’envoyer un numéro de téléphone avec un prénom (ou un nom d’organisation), ainsi que d’ajouter des boutons et d’activer la protection du contenu pour le message.

tg_send_contact(platform_id, phone, first_name, last_name, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

! - paramètre obligatoire de la fonction

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

! phone — numéro de téléphone au format international. Par exemple, pour la Russie : +7XXXXXXXXXX

! prénom et nom - prénom et nom

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

reply_markup — paramètres des boutons **

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum)

Pour simplifier les descriptions de l’ensemble de boutons, vous pouvez utiliser le astuce

Renseignez les paramètres : numéro de téléphone, prénom et nom.

Voir le résultat :

! Fonctionne avec un compte professionnel Telegram

tg_send_sticker(platform_id, sticker_id, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

! sticker_id - ID de l’autocollant. La façon d’obtenir un lien via tg_request est expliquée ici

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

reply_markup — paramètres des boutons **

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum)

Pour simplifier les descriptions de l’ensemble de boutons, vous pouvez utiliser le astuce

L’envoi d’un autocollant n’est pas différent de l’envoi de toute autre pièce jointe : 1. Obtenir le lien interne Telegram (détails ici) 2. Renseigner les paramètres de la fonction 3. Envoyer le bloc à vous-même et vérifier le résultat

Résultat :

N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens

! La photo ne doit pas dépasser 10 Mo. La largeur et la hauteur totales ne doivent pas dépasser 10 000 pixels. Le rapport largeur/hauteur ne doit pas dépasser 20.

! Fonctionne avec un compte professionnel Telegram

tg_send_photo(platform_id, photo, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

! photo - lien vers l’image. La façon d’obtenir un lien via tg_request est expliquée ici.

caption - description jusqu’à 1024 caractères

reply_markup — paramètres des boutons **

parse_mode — mise en forme du texte dans la légende en gras ou italique ***

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''

has_spoiler — active le format spoiler, définissez True pour l’activer

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum) entities — avec ce paramètre, vous pouvez simplement copier un texte formaté avec toutes ses fonctionnalités et indiquer de quel caractère à quel caractère il sera affiché avec un style particulier. Vous pouvez consulter un exemple dans tg_request dans le champ correspondant. Le paramètre doit être un dictionnaire.

show_caption_above_media - si défini sur True, le texte du message sera affiché au-dessus du média Exemple d’envoi du paramètre : entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}] Dans cet exemple, seul le dictionnaire est affiché, tandis que le texte du message lui-même est stocké dans une variable

Pour simplifier les descriptions de l’ensemble de boutons, vous pouvez utiliser le astuce

! La photo ne doit pas dépasser 10 Mo. La largeur et la hauteur totales ne doivent pas dépasser 10 000 pixels. Le rapport largeur/hauteur ne doit pas dépasser 20.

! Travaille avec un compte Telegram Business

tg_send_some_photo(platform_id, image_list, disable_notification=0, protect_content=False, reply_to_message_id=0, has_spoiler=False,message_thread_id)

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

! image_list - tableau de fichiers image (détails ci-dessous)

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

protect_content — indicateur pour protéger le contenu contre la copie (paramètre facultatif, pour l’activer passez 1 comme valeur)

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

has_spoiler — active le format spoiler (facultatif ; définissez True pour l’activer)

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum)

Exemple image_list :

'[["Lien image 1", "légende", "parse_mode"], ["Lien image 2"], ["Lien image 3", "légende"]]'

Exemple de données pour une seule image : ["Lien image 1", "légende", "parse_mode"]

L’ordre des paramètres est important ! Lors de la construction du tableau de fichiers image, les guillemets "" peuvent être omis

Description des paramètres :

! Lien image 1 - lien de l’image. La façon d’obtenir le lien via tg_request est expliquée ici

caption — légende jusqu’à 1024 caractères

parse_mode — mise en forme du texte dans la légende en gras ou italique ***

Voyons un exemple de fonction pour l’envoi de plusieurs images :

commencez par créer un tableau d’images

Ensuite, renseignez les paramètres de la fonction

Envoyez le bloc à vous-même et profitez du résultat

N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens pour la vidéo

tg_send_dice(platform_id, emoji, reply_markup, disable_notification, reply_to_message_id, protect_content, message_thread_id)

! Fonctionne avec un compte professionnel Telegram

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé *

emoji - l’emoji à envoyer. Si vous laissez le paramètre vide, un dé sera envoyé par défaut. Vous pouvez passer soit l’emoji lui-même sous forme de chaîne, soit le mot-clé utilisé pour le représenter

reply_markup — paramètres des boutons **

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

reply_to_message_id -ID du message auquel répondre (c.-à-d. citer)

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum)

Pour simplifier les descriptions de l’ensemble de boutons, vous pouvez utiliser le astuce

Liste possible des emoji : 1) 'darts' ou '🎯', valeurs de 1 à 6 2) 'dice' ou '🎲', valeurs de 1 à 6 3) 'bowling' ou '🎳', valeurs de 1 à 6 4) 'basketball' ou '🏀', valeurs de 1 à 5 5) 'football' ou '⚽', valeurs de 1 à 5 6) 'slots' ou '🎰', valeurs de 1 à 64

De plus, si un client envoie l’un de ces emoji au bot, vous recevrez un callback contenant des informations sur le score et l’emoji utilisé.

L’option la plus simple est d’appeler la fonction avec un seul paramètre obligatoire :

Dans ce cas, le client recevra un dé :

Si le client lance le dé (en cliquant sur l’emoji reçu), le bot recevra un callback avec le nombre de points obtenus :

Vous pouvez expérimenter avec cette fonction. Par exemple, créons une machine à sous et ajoutons un Points bouton. Lorsque le bouton est pressé, nous recevrons le total des points du client :

Premier exemple :

Deuxième exemple :

! Fonctionne avec un compte professionnel Telegram

Une méthode pour envoyer un groupe de photos, vidéos, documents ou fichiers audio sous forme d’album. En cas de succès, un tableau des fichiers envoyés est renvoyé.

Remarque : les documents et les fichiers audio ne peuvent pas être regroupés avec d’autres types de fichiers !

tg_send_media_group(platform_id, media_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Paramètres :

! platform_id — ID du client Telegram auquel le message doit être envoyé

! media_list - un tableau contenant de 2 à 10 photos, vidéos, documents ou fichiers audio (détails ci-dessous) ;

disable_notification — indicateur pour envoyer le message avec une notification sonore (par défaut : 0). 1 — envoyer sans notification, 0 — envoyer avec notification

protect_content — indicateur pour protéger le contenu contre la copie. Pour l’activer, passez n’importe quelle valeur autre que 0, False ou des guillemets vides ''

reply_to_message_id - ID du message auquel répondre (c.-à-d. citer)

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité forum) ;

Contenu des éléments du tableau media_list :

! type - type de fichier, “photo”, “video”, “audio” ou ”document”

! media - fichier à envoyer. Passez un file_id pour envoyer un fichier déjà présent sur les serveurs de Telegram (recommandé), une URL HTTP pour que Telegram récupère le fichier sur Internet ou «attach://<file_attach_name>», pour téléverser un nouveau fichier via multipart/form-data avec le nom <file_attach_name>.

En savoir plus : https://core.telegram.org/bots/api#sending-files

caption — titre du fichier envoyé, 0–1024 caractères.

parse_mode — mise en forme du texte dans la légende en gras ou italique

En savoir plus : https://core.telegram.org/bots/api#sending-files

Exemple de tableau media_list :

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "vidéo de fantômes"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “vidéo de lièvre”}]

Voyons un exemple de fonction pour l’envoi de plusieurs images :

commencez par créer un tableau d’images

Ensuite, renseignez les paramètres de la fonction

Envoyez le bloc à vous-même et profitez du résultat

N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens pour la vidéo

Dans Telegram (tant pour les comptes professionnels que pour les comptes ordinaires), vous pouvez envoyer des pièces jointes via un lien :

1. Vous pouvez envoyer des pièces jointes de n’importe quelle taille, en contournant les limites de taille de fichier.

2. Vous pouvez également envoyer tout type de pièce jointe dont vous avez besoin.

Comment faire :

Copiez le lien vers une pièce jointe déjà accessible publiquement :

Ensuite, collez le lien copié dans la fonction de pièce jointe dans votre bloc :

C’est fait. De cette façon, vous pouvez envoyer des pièces jointes de n’importe quel type et de n’importe quelle taille.