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.

! Fonctionnement avec un compte Telegram Business

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 Telegram auquel le message doit être envoyé *

! document - lien vers le document sur le serveur 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 — formatage du texte dans la description (gras ou italique) ***. Valeurs possibles : html, markdown, markdownV2. lien

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citation)

protect_content — indicateur pour protéger le contenu contre la copie. Pour activer, transmettez toute 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 fonctionnalité de forum)

entities — vous permet de réutiliser du texte pré-formaté avec des styles. Définissez simplement le décalage des caractères et la plage pour le formatage. Un exemple est disponible dans tg_request dans le champ correspondant. 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 distincte.

Pour simplifier la description d'un ensemble de boutons, vous pouvez utiliser l'astuce suivante.

! 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 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 activer, transmettez toute valeur autre que 0, False ou des guillemets vides ''.

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citation)

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

Exemple de construction d'un tableau document_list :
'[["Lien du document", "description", "parse_mode"], ["Lien du document 2"], ["Lien du document 3", "description"]]'

Exemple de formatage des données pour un seul document
["Lien du document", "description", "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 pour le 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 — formatage de la description, c'est-à-dire mettre le texte en gras ou en italique ***

Parcourons un exemple d'envoi d'un seul document, en ajoutant des boutons en ligne et une description au document :

1. Tout d'abord, obtenez le lien vers votre document. Une explication détaillée de la façon de procéder se trouve ici.

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

   

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

Examinons maintenant l'envoi de plusieurs documents.

1. Ici aussi, vous devez obtenir un lien Telegram interne pour chaque document et former un tableau.
   lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
2. Enfin, assemblez la fonction d'envoi de documents :

3. Et vérifiez 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 envoyer 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 de document", opts) 

Exemple de code pour envoyer 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, jusqu'à 2 Go.

! Fonctionne uniquement avec un compte Telegram Business

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 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 — formatage du texte dans la description (gras ou italique) ***. Valeurs possibles : html, markdown, markdownV2.

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citation)

protect_content — indicateur pour protéger le contenu contre la copie. Pour l'activer, transmettez toute valeur sauf 0, False ou des guillemets vides ''.

disable_notification — indicateur pour envoyer un message avec ou sans notification sonore (par défaut : 0) 1 - désactiver la notification à la réception, 0 - envoyer avec notification

message_thread_id — identifiant du sujet (disponible dans les supergroupes si la fonctionnalité de forum est activée).

entities — avec ce paramètre, vous pouvez simplement copier du texte formaté avec toutes ses caractéristiques et spécifier à partir de quel caractère et jusqu'à quel caractère il sera affiché avec un style particulier. Vous pouvez vérifier 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 défini dans une variable.

Pour simplifier la description d'un ensemble de boutons, vous pouvez utiliser l'astuce suivante.

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

! Fonctionne avec un compte Telegram Business

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 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 activer, transmettez toute valeur sauf 0, False ou des guillemets vides ''.

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citation)

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

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

Exemple pour un seul audio :
["Lien audio", "description", "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 — formatage du texte dans la description (gras ou italique) ***

Comme indiqué ci-dessus, la fonction fonctionne avec les 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 en utilisant le bot https://t.me/mp3toolsbot.

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

Assemblez maintenant la fonction :

Super ! Bien joué !

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

tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")

Si un message ne peut pas être envoyé 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 uniquement de certains utilisateurs) :

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

! 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 client Telegram auquel le message doit être envoyé. *

!** animation** - lien vers l'animation. Comment obtenir un lien via tg_request est expliqué ici

caption - description jusqu'à 1024 caractères

reply_markup — configuration des boutons **

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

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citation)

protect_content — indicateur pour protéger le contenu contre la copie. Pour activer, transmettez toute valeur autre que 0, False ou des guillemets vides ''.

has_spoiler — active le spoiler. Pour 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é de forum)

entities — avec ce paramètre, vous pouvez simplement copier du texte formaté avec toutes ses caractéristiques et spécifier à partir de quel caractère et jusqu'à quel caractère il sera affiché avec un style particulier. Vous pouvez vérifier 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 sera affichée au-dessus du média

Exemple de passage de 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 des ensembles de boutons, vous pouvez utiliser l'astuce suivante

Complexifions la tâche et envoyons une animation avec protection contre la copie et le spoiler.

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

Enfin, assemblez la fonction :

Et vérifiez 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

animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "Bonne année !"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)

! Cette fonction permet d'envoyer des fichiers MPEG4 jusqu'à 2 Go.
(Les autres formats peuvent être envoyés sous forme de fichiers en utilisant tg_send_document())

! Fonctionne avec un compte professionnel Telegram

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 client Telegram auquel le message doit être envoyé *

!** video** - lien vidéo. Comment obtenir des liens via tg_request voir ici

caption - description jusqu'à 1024 caractères

reply_markup — paramètres des boutons **

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

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citation)

protect_content — indicateur pour protéger le contenu contre la copie. Pour activer, transmettez toute valeur autre que 0, False ou des guillemets vides ''.

has_spoiler — active le spoiler. Pour 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é de forum)

entities — avec ce paramètre, vous pouvez simplement copier du texte formaté avec toutes ses caractéristiques et spécifier à partir de quel caractère et jusqu'à quel caractère il sera affiché avec un style particulier. Vous pouvez vérifier 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 de 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 des ensembles de boutons, vous pouvez utiliser l'astuce suivante

! 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 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'est-à-dire citation)

has_spoiler — active le formatage spoiler (optionnel ; définir sur True pour activer)

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité de 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.
légende — légende textuelle jusqu'à 1024 caractères
parse_mode — formatage du texte dans la légende en gras ou en italique *****. Valeurs possibles : html, markdown, markdownV2.

Alors, commencez par obtenir le lien vers le fichier que vous souhaitez envoyer, puis remplissez les paramètres requis de la fonction :

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

video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video

! À 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.

! Fonctionne avec un compte professionnel Telegram

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 client Telegram auquel le message doit être envoyé *

!** video_note** - lien vidéo. Comment obtenir le lien via tg_request est décrit ici
reply_markup — paramètres des boutons **

protect_content — indicateur pour protéger le contenu contre la copie. Pour activer, transmettez toute valeur autre que 0, False ou des guillemets vides ''

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citation)

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é de forum)

Pour simplifier les descriptions des ensembles de boutons, vous pouvez utiliser l'astuce suivante

Si vous avez une vidéo carrée, vous pouvez la convertir en vidéo ronde en utilisant le bot https://t.me/roundNoteBot :

Une fois que vous avez la vidéo ronde, envoyez-la-vous 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

tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')

! Fonctionne avec un compte professionnel Telegram

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 — Identifiant 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 activer, transmettez toute 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'est-à-dire citer)

reply_markup — paramètres des boutons **

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

Pour simplifier les descriptions des ensembles de boutons, vous pouvez utiliser l'astuce suivante

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

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

Maintenant, procédons au remplissage des paramètres de la fonction et obtenons le résultat souhaité :

soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Dreams come true!", "Paris, Eiffel Tower") 

! Travailler avec un compte Telegram Business

Telegram offre 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 du 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 de fonction obligatoire

Paramètres :

! platform_id — Identifiant 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

! first_name et last_name - prénom et nom

protect_content — indicateur pour protéger le contenu contre la copie. Pour activer, transmettez toute 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'est-à-dire citer)

reply_markup — paramètres des boutons **

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

Pour simplifier les descriptions des ensembles de boutons, vous pouvez utiliser l'astuce suivante

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

Consultez le résultat :

soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1) 

! Travailler avec un compte Telegram Business

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

Paramètres :

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

! sticker_id - ID du sticker. Comment obtenir un lien via tg_request est expliqué ici

protect_content — indicateur pour protéger le contenu contre la copie. Pour activer, transmettez toute 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'est-à-dire citer)

reply_markup — paramètres des boutons **

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

Pour simplifier les descriptions des ensembles de boutons, vous pouvez utiliser l'astuce suivante

L'envoi d'un sticker n'est pas différent de l'envoi de toute autre pièce jointe :\

1. Obtenez le lien interne Telegram (détails ici)\
2. Remplissez les paramètres de la fonction\
3. Envoyez le bloc à vous-même et vérifiez 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

soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')

! 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.

! Travailler avec un compte Telegram Business

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 — Identifiant du client Telegram auquel le message doit être envoyé *

! photo - lien vers l'image. Comment obtenir un lien via tg_request est expliqué ici.

caption - description jusqu'à 1024 caractères

reply_markup — paramètres des boutons **

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

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citer)

protect_content — indicateur pour protéger le contenu contre la copie. Pour activer, transmettez toute valeur autre que 0, False ou des guillemets vides ''

has_spoiler — active le formatage spoiler, définissez sur True pour 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é de forum)

entities — avec ce paramètre, vous pouvez simplement copier le texte formaté avec toutes ses caractéristiques et spécifier à partir de quel caractère et jusqu'à quel caractère il sera affiché avec un style particulier. Vous pouvez vérifier 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 de 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 des ensembles de boutons, vous pouvez utiliser l'astuce suivante

! 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.

! Travailler 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 — Identifiant 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 activer, transmettez 1 comme valeur)

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citer)

has_spoiler — active le formatage spoiler (facultatif ; définissez sur True pour activer)

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

Exemple image_list :

'[["Lien de l'image 1", "caption", "parse_mode"], ["Lien de l'image 2"], ["Lien de l'image 3", "caption"]]'

Exemple de données pour une seule image :
["Lien de l'image 1", "caption", "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 de l'image 1 - lien de l'image. Comment obtenir un lien via tg_request est expliqué ici

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

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

Examinons un exemple de fonction pour envoyer plusieurs images :

Tout d'abord, créez un tableau d'images

Ensuite, remplissez 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

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

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

! Fonctionne avec un compte Telegram Business

Paramètres :

! platform_id — Identifiant 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étrage des boutons **

disable_notification — indicateur pour envoyer le message sans 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'est-à-dire citer)

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

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

Pour simplifier les descriptions des ensembles de boutons, vous pouvez utiliser cette astuce

Liste des emojis possibles : \

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 emojis 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 bouton Points. Lorsque le bouton est pressé, nous recevrons le total des points du client :

Premier exemple :

soob=tg_send_dice(platform_id)

Deuxième exemple :

/* Premier exemple */
tg_send_message(platform_id,'Cliquez sur la machine à sous pour tenter votre chance !')
opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* Deuxième bloc - Message texte */
 #{res[1]} points obtenus
/* Deuxième bloc - Calculatrice */
res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* Troisième bloc - Message texte */
Vous avez un total de #{balls} points

! Fonctionne avec un compte Telegram Business

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 retourné.

Remarque : les documents et 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 — Identifiant 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 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 activer, passez toute valeur autre que 0, False ou des guillemets vides ''

reply_to_message_id - ID du message auquel répondre (c'est-à-dire citer)

message_thread_id — ID du fil de discussion (disponible dans les supergroupes avec fonctionnalité de 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 qui existe déjà sur les serveurs Telegram (recommandé), une URL HTTP pour que Telegram récupère le fichier depuis Internet ou « attach://<file_attach_name> », pour télécharger un nouveau fichier en utilisant 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 — formatage 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”}]

Examinons un exemple de fonction pour envoyer plusieurs images :

D'abord, créez un tableau d'images

Ensuite, remplissez 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

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

Dans Telegram (aussi bien pour les comptes professionnels que pour les comptes normaux), 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 de votre bloc :

Terminé. Ainsi, vous pouvez envoyer des pièces jointes de tout type et de toute taille.