# Fonctions d’envoi de pièces jointes dans les messages

## Comment envoyer des documents

<details>

<summary>Envoyer un document  tg_send_document() </summary>

<mark style="color:red;">**!**</mark> Ces fonctions vous permettent d’envoyer des fichiers de tout type. Formats recommandés : **GIF, PDF, ZIP** jusqu’à **2 Go**.

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>&#x20;

**tg\_send\_document(platform\_id, document, caption, reply\_markup, parse\_mode,reply\_to\_message\_id, protect\_content, disable\_notification**, **message\_thread\_id, entities)**&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — identifiant du client dans Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii) &#x20;

<mark style="color:red;">**!**</mark>**&#x20;document** - lien vers le document sur le serveur de Telegram. L’obtention du lien via tg\_request est expliquée [ici](/doc/fr/chatbot/messageries/telegram/webhook.md).&#x20;

**caption** - description, jusqu’à 1024 caractères

**reply\_markup** — paramètres des boutons [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)&#x20;

**parse\_mode** — mise en forme du texte dans la description (gras ou italique)  [ **\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)**.** 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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button).&#x20;

</details>

<details>

<summary>Envoyer plusieurs documents ou autres fichiers tg_send_some_document()</summary>

<mark style="color:red;">**!**</mark> 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 :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — identifiant du client dans Telegram auquel le message doit être envoyé  [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)&#x20;

<mark style="color:red;">**!**</mark>**&#x20;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"]]'&#x20;

**Exemple de formatage des données pour un seul document** \
\["Lien du document", "légende", "parse\_mode"]&#x20;

<mark style="color:red;">**L’ordre des paramètres est important !**</mark> Lors de la création d’un tableau de documents, les guillemets " " peuvent être omis.

**Description des paramètres du tableau document\_list :**\ <mark style="color:red;">**!**</mark>**&#x20;Lien du document** - lien du document depuis le serveur Telegram. L’obtention du lien via tg\_request est expliquée [ici](/doc/fr/chatbot/messageries/telegram/webhook.md)   \
**caption** — description jusqu’à 1024 caractères\
**parse\_mode** — mise en forme de la description, c.-à-d. mise en gras ou en italique du texte  [**\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>Exemple</summary>

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.](/doc/fr/chatbot/messageries/telegram/webhook.md#how-to-get-a-media-link-using-a-variable)
2. Créez un bloc et définissez les variables comme indiqué sur la capture d’écran :<br>

   <div data-with-frame="true"><figure><img src="/files/d95fcfe23bac034acfcf57c170643c7fcfe9ecde" alt="" width="563"><figcaption></figcaption></figure></div>
3. Envoyez le bloc à nous-mêmes et voyons le résultat de notre travail :

<div data-with-frame="true"><figure><img src="/files/4fa34ca0b0afe63d5224c32b3970d5eb247e6842" alt="" width="563"><figcaption></figcaption></figure></div>

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 :

<div data-with-frame="true"><figure><img src="/files/59d724a6d3cb6cd86d6e9bcbd2555f3ecba55ba3" alt="" width="563"><figcaption></figcaption></figure></div>

3\. Et regardez le résultat du travail :

<div data-with-frame="true"><figure><img src="/files/20600363a8a6ece6abbd63a4f3eb6c61689b3976" alt="" width="375"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

<mark style="color:red;">N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens</mark>

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)
```

</details>

## Comment envoyer un audio / une note vocale

<details>

<summary>Envoyer un message audio <strong>tg_send_voice(</strong>)</summary>

<mark style="color:red;">!</mark> Cette fonction permet d’envoyer des fichiers vocaux de type .OGG encodés avec OPUS, d’une taille maximale de 2 Go.

<mark style="background-color:green;">**! Fonctionne uniquement avec un compte professionnel Telegram**</mark>

**tg\_send\_voice(platform\_id, voice, caption, reply\_markup, parse\_mode, reply\_to\_message\_id, protect\_content, disable\_notification, message\_thread\_id, entities)**&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — identifiant du client dans Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;voice** - lien vers le message vocal au format .OGG

**caption** - description jusqu’à 1024 caractères

**reply\_markup** — paramètres des boutons [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — mise en forme du texte dans la description en gras ou italique [ **\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)**.** 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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Envoyer plusieurs messages audio <strong>tg_send_some_audio()</strong></summary>

<mark style="color:red;">**!**</mark> Cette fonction permet d’envoyer des fichiers audio de type .MP3 ou .M4A d’une taille maximale de 2 Go.

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>&#x20;

**tg\_send\_some\_audio(platform\_id, audio\_list, disable\_notification, protect\_content, reply\_to\_message\_id, message\_thread\_id)**&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — identifiant du client dans Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;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"]]'&#x20;

**Exemple d’un seul audio :** \
\["Lien audio", "légende", "parse\_mode"]&#x20;

<mark style="color:red;">**L’ordre des paramètres est important !**</mark> Lors de la construction du tableau de fichiers audio, les guillemets "" peuvent être omis

**Description des paramètres :** \ <mark style="color:red;">**!**</mark>**&#x20;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   [**\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>Exemple</summary>

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 **.**&#x66;ichier MP3, vous pouvez le convertir en **.**&#x4F;GG à l’aide du <https://t.me/mp3toolsbot> bot.&#x20;

Ensuite, envoyez le fichier obtenu à vous-même dans le bot pour obtenir le file\_id en suivant l’algorithme [décrit ici. ](#documents-an-example-of-how-to-send-using-the-telegram-api)

Maintenant, assemblez la fonction :

<div data-with-frame="true"><figure><img src="/files/57d95613d823d800f964d0fa61d02d8b190d3063" alt="" width="563"><figcaption></figcaption></figure></div>

Génial ! Bravo !

</details>

<details>

<summary>Exemple à copier</summary>

<mark style="color:red;">N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens</mark>

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

</details>

<details>

<summary>Erreur lors de l’envoi de messages vocaux</summary>

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

<mark style="color:red;">{"ok":false,"error\_code":400,"description":"Bad Request: user restricted receiving of voice messages"}</mark>

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) :

<div data-with-frame="true"><figure><img src="/files/fb935291f495f4c6f372c464a845b0d1e9c89f38" alt="" width="563"><figcaption></figcaption></figure></div>

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.

<mark style="color:green;">**Solution :**</mark>&#x20;

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 :\ <mark style="color:green;">**<https://api.telegram.org/bot\\><TOKEN>/getChat?chat\_id=#{platform\_id}**</mark>

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

</details>

## Comment envoyer des animations

<details>

<summary>Envoyer une animation <strong>tg_send_animation()</strong></summary>

<mark style="color:red;">**!**</mark> 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.

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>

**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 :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé. [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;animation**- lien vers l’animation. La façon d’obtenir un lien via tg\_request est expliquée [ici](/doc/fr/chatbot/messageries/telegram/webhook.md)&#x20;

**caption** - description jusqu’à 1024 caractères

**reply\_markup** — configuration des boutons [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — mise en forme du texte dans la légende en gras ou italique  [**\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)**.** 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.&#x20;

**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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Exemple</summary>

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](/doc/fr/chatbot/messageries/telegram.md)).

<div data-with-frame="true"><figure><img src="/files/266de1fe232303ee4141b27dc76f19433213a3bb" alt="" width="563"><figcaption></figcaption></figure></div>

Enfin, assemblez la fonction :

<div data-with-frame="true"><figure><img src="/files/aff44305195f626869358ecee266b70a3abff000" alt=""><figcaption></figcaption></figure></div>

Et regardez le résultat du travail :

<div data-with-frame="true"><figure><img src="/files/1fc9061095b15b1c206366decc9f88924d876773" alt="" width="563"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

<mark style="color:red;">N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens</mark>

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

</details>

## Comment envoyer des vidéos

<details>

<summary>Envoyer une vidéo via l’API Telegram <strong>tg_send_video()</strong></summary>

<mark style="color:red;">**!**</mark> 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())

<mark style="background-color:green;">**! Travaille avec un compte Telegram Business**</mark>&#x20;

**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 :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;video** - lien vidéo. Pour savoir comment obtenir des liens via tg\_request, voir [ici](/doc/fr/chatbot/messageries/telegram/webhook.md)&#x20;

**caption** - description jusqu’à 1024 caractères

**reply\_markup** — paramètres des boutons  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — mise en forme du texte dans la légende en gras ou italique  [**\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)**.** 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.&#x20;

**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](/doc/fr/chatbot/messageries/telegram/webhook.md). \
\
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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Envoyer plusieurs vidéos via l’API Telegram <strong>tg_send_some_video()</strong></summary>

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>&#x20;

**tg\_send\_some\_video(platform\_id, video\_list, disable\_notification, protect\_content, reply\_to\_message\_id, has\_spoiler, message\_thread\_id)**&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;video\_list** - un tableau de fichiers vidéo (détails ci-dessous)&#x20;

**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"]&#x20;

<mark style="color:red;">**L’ordre des paramètres est important !**</mark> Lors de la construction du tableau de fichiers vidéo, les guillemets "" peuvent être omis

**Description des paramètres :** \ <mark style="color:red;">**!**</mark>**&#x20;Lien vidéo** — URL vidéo interne Telegram. L’obtention du lien via tg\_request est décrite [ici](/doc/fr/chatbot/messageries/telegram/webhook.md#how-to-get-webhook).\
**caption** — légende textuelle jusqu’à 1024 caractères\
**parse\_mode** — mise en forme du texte dans la légende en gras ou italique  [**\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)**.** Valeurs possibles : html, markdown, markdownV2.

</details>

<details>

<summary>Exemple</summary>

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

<div data-with-frame="true"><figure><img src="/files/61164941839b20546dc57cb55b675db4b9dcdb80" alt="" width="563"><figcaption><p>Obtention du lien vidéo via tg_request</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/c94793c69eede1b016a2f905f95dfc5ea4e364ee" alt="" width="563"><figcaption><p>Envoi du paramètre vidéo</p></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/8f6a80805efeb0f9e443af8e782a24c8091ddd76" alt="" width="563"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

<mark style="color:red;">N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens</mark>

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

</details>

## Comment envoyer une vidéo ronde

<details>

<summary>Envoyer une vidéo ronde <strong>tg_send_video_note()</strong></summary>

<mark style="color:red;">**!**</mark> À 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.

<mark style="background-color:green;">**! Travaille avec un compte Telegram Business**</mark>

**tg\_send\_video\_note(platform\_id, video\_note,  reply\_markup, protect\_content, reply\_to\_message\_id, disable\_notification,  message\_thread\_id)** &#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;video\_note** - lien vidéo. La façon d’obtenir le lien via tg\_request est décrite [ici](/doc/fr/chatbot/messageries/telegram/webhook.md) \
**reply\_markup** — paramètres des boutons [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**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 ](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)

</details>

<details>

<summary>Exemple</summary>

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

<figure><img src="/files/279fd324ecefcace82c9421a86e2c5567fc07606" alt=""><figcaption><p>Obtention du bot de conversion en vidéo ronde via @roundNoteBot (https://t.me/roundNoteBot)</p></figcaption></figure>

Une fois que vous avez la vidéo ronde, envoyez-la à vous-même dans le bot pour obtenir le lien (détails [ici](/doc/fr/chatbot/messageries/telegram/api/attachment.md)),  puis configurez la fonction d’envoi de la vidéo ronde :

<figure><img src="/files/7674974d8024527f33843dabfa84702a66e51603" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details>

<summary>Exemple de code à copier</summary>

<mark style="color:red;">N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens</mark>

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

```

</details>

## Comment envoyer une localisation

<details>

<summary>Envoyer une géolocalisation <strong>tg_send_venue()</strong></summary>

<mark style="background-color:green;">**! Travaille avec un compte Telegram Business**</mark>&#x20;

**tg\_send\_venue(platform\_id, latitude, longitude, title, address, protect\_content, disable\_notification, reply\_to\_message\_id, reply\_markup, message\_thread\_id)**&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;latitude** —latitude

<mark style="color:red;">**!**</mark>**&#x20;longitude** — longitude

<mark style="color:red;">**!**</mark>**&#x20;title** — titre

<mark style="color:red;">**!**</mark>**&#x20;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  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Exemple</summary>

Commençons donc par déterminer les coordonnées de l’endroit. Vous pouvez les obtenir à l’aide de  [Google Maps ](https://www.google.com/maps)

<div data-with-frame="true"><figure><img src="/files/98f42726102aaf9d88a41bc7e2dc7915ffba0730" alt=""><figcaption></figcaption></figure></div>

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](https://coordinates-converter.com/en/decimal/51.000000,10.000000?karte=OpenStreetMap\&zoom=8):

<figure><img src="/files/4e4bd6c898d4ae33b04f9cb92152145d5998e8b1" alt="" width="375"><figcaption></figcaption></figure>

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

<div data-with-frame="true"><figure><img src="/files/8b2a038a2f310b728d7b2e40e62a94527bdb37f3" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/cfc56e1af790cbdf73f124e45019bfb9129f2460" alt="" width="375"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

```
soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Les rêves deviennent réalité !", "Paris, tour Eiffel") 
```

</details>

## Comment envoyer des contacts

<details>

<summary>Envoyer un contact <strong>tg_send_contact()</strong></summary>

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>

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)**&#x20;

<mark style="color:red;">**! - paramètre obligatoire de la fonction**</mark>

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;phone** — numéro de téléphone au format international. Par exemple, pour la Russie : +7XXXXXXXXXX

<mark style="color:red;">**!**</mark>**&#x20;prénom** et **nom** - prénom et nom&#x20;

**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 [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Exemple</summary>

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

<div data-with-frame="true"><figure><img src="/files/4828657cbdbfa62d51ae247ead61544270d1615b" alt="" width="563"><figcaption><p>Exemple de remplissage des paramètres pour la fonction d’envoi de contact.</p></figcaption></figure></div>

Voir le résultat :

<div data-with-frame="true"><figure><img src="/files/c4d7e641e3ea6296b610776a28ebdff44bb5e6b1" alt="" width="563"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

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

</details>

## Comment envoyer un autocollant

<details>

<summary>Envoyer un autocollant <strong>tg_send_sticker()</strong></summary>

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>

**tg\_send\_sticker(platform\_id, sticker\_id, protect\_content,  disable\_notification, reply\_to\_message\_id, reply\_markup, message\_thread\_id)**&#x20;

Paramètres :&#x20;

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;sticker\_id** - ID de l’autocollant. La façon d’obtenir un lien via tg\_request est expliquée [ici](/doc/fr/chatbot/messageries/telegram/webhook.md)&#x20;

**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 [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Exemple</summary>

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

<div data-with-frame="true"><figure><img src="/files/5c8400466f345b53e2d967c4706d77ebb55ab694" alt="" width="563"><figcaption><p>Envoi de l’autocollant</p></figcaption></figure></div>

Résultat :

<div data-with-frame="true"><figure><img src="/files/c8fbce7e57af5d31b4c8579c0d3b1cd93ff41161" alt="" width="563"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

<mark style="color:red;">N’oubliez pas que les liens sont uniques pour chaque bot, alors assurez-vous de générer vos propres liens</mark>

```
soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')
```

</details>

## Comment envoyer une photo

{% hint style="warning" %}

#### **Comprendre le `caption` paramètre**

Le **`caption`** paramètre fournit un texte descriptif pour une image (par exemple, un bref résumé ou une explication). Il fonctionne comme suit :

* **Avec une seule image :** si une légende est fournie, le message contiendra à la fois l’image et le texte descriptif.
* **Avec plusieurs images :** chaque image peut avoir sa propre légende individuelle. Dans ce cas, chaque image sera envoyée avec sa description spécifique.

**Expérience utilisateur :** le texte de la légende est généralement affiché lorsqu’un utilisateur clique ou appuie sur l’image.

> **Pour des spécifications techniques détaillées et le comportement de l’API, veuillez vous référer à la documentation officielle de Telegram.**

**Remarque :** si vous suivez un tutoriel vidéo, veuillez revoir les étapes attentivement car les paramètres et les interfaces peuvent évoluer avec le temps.
{% endhint %}

<details>

<summary>Envoyer une photo <strong>tg_send_photo()</strong></summary>

<mark style="color:red;">**!**</mark> 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.

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>

**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 :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** —  ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;photo** - lien vers l’image. La façon d’obtenir un lien via tg\_request est expliquée [ici](/doc/fr/chatbot/messageries/telegram/webhook.md).&#x20;

**caption** - description jusqu’à 1024 caractères

**reply\_markup** — paramètres des boutons  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**parse\_mode** — mise en forme du texte dans la légende en gras ou italique  [**\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)

**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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)&#x20;

</details>

<details>

<summary>Envoyer plusieurs photos <strong>tg_send_some_photo()</strong></summary>

<mark style="color:red;">**!**</mark> 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.

<mark style="background-color:green;">**! Travaille avec un compte Telegram Business**</mark>&#x20;

**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 :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

<mark style="color:red;">**!**</mark>**&#x20;image\_list** - tableau de fichiers image (détails ci-dessous)&#x20;

**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)<br>

**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"]&#x20;

<mark style="color:red;">**L’ordre des paramètres est important !**</mark> Lors de la construction du tableau de fichiers image, les guillemets "" peuvent être omis

**Description des paramètres :&#x20;**&#x20;

<mark style="color:red;">**!**</mark>**&#x20;Lien image 1** - lien de l’image. La façon d’obtenir le lien via tg\_request est expliquée[ ici](/doc/fr/chatbot/messageries/telegram/webhook.md) &#x20;

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

**parse\_mode** — mise en forme du texte dans la légende en gras ou italique [**\*\*\***](/doc/fr/chatbot/builder/telegram_messages.md)

</details>

<details>

<summary>Exemple</summary>

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

commencez par créer un tableau d’images

<div data-with-frame="true"><figure><img src="/files/1323484a9d26455e8162af498f49a218e62cd22f" alt=""><figcaption></figcaption></figure></div>

Ensuite, renseignez les paramètres de la fonction

<div data-with-frame="true"><figure><img src="/files/7df45d53fd2a9d2ffa9441e3afc44a30e2f9db9e" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/fdaed8fa0a89d69860c09741f0d8db6e94a22309" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

<mark style="color:red;">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</mark>

```
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)
```

</details>

## Comment envoyer un dé

<details>

<summary>Envoyer un emoji avec un tirage aléatoire (Dé) <strong>tg_send_dice()</strong> </summary>

**tg\_send\_dice(platform\_id, emoji, reply\_markup, disable\_notification, reply\_to\_message\_id, protect\_content, message\_thread\_id)**

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>&#x20;

Paramètres :

<mark style="color:red;">**!**</mark>**&#x20;platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)

**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  [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)

**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 -**&#x49;D 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](/doc/fr/chatbot/messageries/telegram/buttons.md#telegram-web-application-button)&#x20;

&#x20;

**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&#x20;

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

</details>

<details>

<summary>Exemple</summary>

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

<div data-with-frame="true"><figure><img src="/files/3f9627699b36beebfe288eb919bcbfc145ba652e" alt="" width="563"><figcaption></figcaption></figure></div>

Dans ce cas, le client recevra un dé :

<div data-with-frame="true"><figure><img src="/files/9d0dd81ea750caf33ff22f6dbdd644e002dbf9d7" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/75d906c4d5cb70002c94a7337fb904826034f04a" alt="" width="553"><figcaption></figcaption></figure></div>

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 :

<div data-with-frame="true"><figure><img src="/files/70e75c2d89afed3f176d515a0b5f7ec231af3786" alt="" width="563"><figcaption><p><strong>Premier message :</strong> Proposer de jouer</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/66af43e64da27a4b0e18e4eb645222a2963f29f4" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/6e9d9a6663dd12e033dbcefdaf97bbbee8e2cacb" alt="" width="563"><figcaption><p>Exemple de bot</p></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

Premier exemple :

```
soob=tg_send_dice(platform_id)
```

Deuxième exemple :

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

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

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

</details>

## Comment envoyer un groupe multimédia

<details>

<summary>Envoyer un groupe multimédia tg_send_media_group()</summary>

<mark style="background-color:green;">**! Fonctionne avec un compte professionnel Telegram**</mark>

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

<mark style="color:orange;">**Remarque : les documents et les fichiers audio ne peuvent pas être regroupés avec d’autres types de fichiers !**</mark>

tg\_send\_media\_group(platform\_id, media\_list, disable\_notification, protect\_content, reply\_to\_message\_id, message\_thread\_id)

Paramètres :

<mark style="color:red;">!</mark> platform\_id — ID du client Telegram auquel le message doit être envoyé

<mark style="color:red;">!</mark> 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 :**

<mark style="color:red;">!</mark> type - type de fichier, “photo”, “video”, “audio” ou ”document”

<mark style="color:red;">!</mark> 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”}]

</details>

<details>

<summary>Exemple</summary>

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

commencez par créer un tableau d’images

<div data-with-frame="true"><figure><img src="/files/1323484a9d26455e8162af498f49a218e62cd22f" alt=""><figcaption></figcaption></figure></div>

Ensuite, renseignez les paramètres de la fonction

<div data-with-frame="true"><figure><img src="/files/7df45d53fd2a9d2ffa9441e3afc44a30e2f9db9e" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/fdaed8fa0a89d69860c09741f0d8db6e94a22309" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Exemple de code à copier</summary>

<mark style="color:red;">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</mark>

```
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)
```

</details>

## Comment envoyer des pièces jointes volumineuses

<details>

<summary>Exemple</summary>

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 :

<div data-with-frame="true"><figure><img src="/files/6e764a517a14da800854a48b0c51a12053045b2c" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/60d12f86189eed3b224aeb6933b17dd9a8dce1b9" alt="" width="563"><figcaption></figcaption></figure></div>

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.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/chatbot/messageries/telegram/api/attachment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.