# Fonctions d’envoi et de modification des messages

## **Comment envoyer des messages à l’aide d’un compte Telegram Business**

**tg\_send\_message(platform\_id, text,client\_message\_id, reply\_markup, parse\_mode, disable\_web\_page\_preview, protect\_content, disable\_notification**, **message\_thread\_id, entities)** 

Paramètres :

<table><thead><tr><th width="324.87890625">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>ID utilisateur Telegram auquel un message doit être envoyé <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> text</strong></td><td>Texte du message</td></tr><tr><td><strong>client_message_id</strong> </td><td>ID du message à citer</td></tr><tr><td><strong>reply_markup</strong></td><td>Paramètres du bouton  <a href="/pages/abfc096724eeab348d2242b15a18a108ffc54f52#how-to-delete-reply-buttons"><strong>**</strong></a></td></tr><tr><td><strong>parse_mode</strong></td><td>Mise en forme du texte en gras et en italique dans la description<a href="/pages/44ff7bf85a21a27f753656bd6131d63f5c73c46f#markdown-markup"> <strong>***</strong></a><strong>.</strong> Il peut avoir des valeurs telles que html, markdown, markdownV2.</td></tr><tr><td><strong>disable_web_page_preview</strong></td><td>Afficher l’aperçu du lien. Pour le désactiver, passez 1 ; sinon, passez 0 ou laissez-le vide "".</td></tr><tr><td><strong>protect_content</strong></td><td>Indicateur de protection du contenu. Passez une valeur différente de 0, False ou '' pour activer.</td></tr><tr><td><strong>disable_notification</strong></td><td>Indicateur de notification sonore (par défaut : 0). Passez 1 pour désactiver la notification, 0 pour l’activer.</td></tr><tr><td><strong>message_thread_id</strong></td><td>ID du sujet (disponible pour les supergroupes avec la fonctionnalité forum activée)</td></tr><tr><td><strong>entities</strong></td><td>Cela vous permet de copier un texte préformaté avec tous ses styles et de simplement spécifier la plage de caractères où une police particulière doit être appliquée. Un exemple peut être trouvé dans le tg_request sous le champ correspondant. Le paramètre doit être un dictionnaire. Voir l’onglet d’exemple pour référence.</td></tr></tbody></table>

<details>

<summary><mark style="color:orange;"><strong>Exemple détaillé</strong></mark></summary>

Prenons un exemple simple avec un ensemble de paramètres requis :

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

Le platform\_id spécifie l’identifiant d’un client particulier.

Voir le même exemple, mais en utilisant des variables :

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

Dans cet exemple, la variable `soob` contiendra la réponse du serveur après l’envoi d’un message.

<div data-with-frame="true"><figure><img src="/files/168f8f268bb159727080d092ef44069a63834912" alt="" width="356"><figcaption></figcaption></figure></div>

Si vous enregistrez le `message_id` de la réponse reçue, cela vous permettra ensuite de travailler avec ce message (modifier, supprimer, transférer, commenter).

Des difficultés surviennent souvent lors de l’utilisation de tous les paramètres. Examinons l’exemple suivant :

* Tout d’abord, déclarez tous les paramètres utilisés dans la fonction. N’oubliez pas que les paramètres peuvent être transmis non seulement comme valeurs, mais aussi comme variables, ce qui est souvent plus pratique et plus clair. Des variables telles que platform\_id et client\_message\_id peuvent être obtenues à partir de la fiche de profil du client. \
  &#x20;**platform\_id** — ID du client Telegram auquel le message doit être envoyé [**\***](#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii)\ <mark style="color:green;">>Nous répondrons dans le même chat où le client écrit</mark>

  **text** - texte du message. \ <mark style="color:green;">>Nous utilisons une mise en forme du texte - par exemple, une mise en gras.</mark>

  **client\_message\_id** - ID du message à citer\ <mark style="color:green;">>Dans les chats, cette variable reçoit automatiquement sa valeur.</mark>\
  **reply\_markup** — paramètres des boutons [**\*\***](#kak-propisyvat-knopki-v-parametre-reply_markup)**.** \ <mark style="color:green;">>Attribuons-la à la variable opts.</mark>\
  **parse\_mode** — Mise en forme du texte en gras et en italique dans la description [**\*\*\***](#kak-ispolzovat-razmetku-teksta-markdown-v-parametre-parse_mode)**.** Il peut avoir des valeurs telles que html, markdown, markdownV2. Les caractères utilisés pour la mise en forme du texte du message sont décrits[ ici](/doc/fr/chatbot/builder/telegram_messages.md). \ <mark style="color:green;">>Utilisons markdown.</mark> \
  **disable\_web\_page\_preview -** Afficher l’aperçu du lien. Pour le désactiver, passez 1 ; sinon, passez 0 ou laissez-le vide "".\ <mark style="color:green;">>Nous pouvons passer n’importe quelle valeur puisque le texte du message ne contient pas de lien.</mark>\
  **protect\_content** — Indicateur de protection du contenu. Passez une valeur différente de 0, False ou '' pour activer.\ <mark style="color:green;">>Nous n’avons pas besoin de protection du contenu, donc nous passerons une chaîne vide</mark> <mark style="color:green;">''.</mark>\
  **disable\_notification** — Indicateur de notification sonore (par défaut : 0). Passez 1 pour désactiver la notification, 0 pour l’activer.\ <mark style="color:green;">>Une notification est une fenêtre contextuelle affichant le texte du message. Activons-la.</mark>
* Ensuite, nous assemblons la fonction. N’oubliez pas d’assigner la fonction à une variable — cela vous permettra de suivre l’état de l’envoi du message.

<div data-with-frame="true"><figure><img src="/files/6760f1bef863ec0aff84fc4b5569cc27705d45c8" alt="" width="563"><figcaption><p>Le champ "Calculator"</p></figcaption></figure></div>

Voici ce que nous avons obtenu :
\
Après que le client nous a envoyé le mot-clé test, nous répondons en citant son message.

Dans `'ok'` nous voyons l’état de l’envoi ; ensuite viennent les informations sur le message lui-même — son ID, les données de l’expéditeur et son contenu.

Exemple avec le **entities** paramètre
\
Vous pouvez stocker la chaîne d’origine dans une variable, comme indiqué ci-dessous :

`text = "qwert asdfg zxcvb poiuy lkjhg 12345"`\
\
Vous devez écrire le paramètre sous forme de dictionnaire avec les données et spécifier le format souhaité en indiquant les polices :

`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"``    `<mark style="color:red;">**`https://mavibot.ai"}`**</mark>`,{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`

Passez le paramètre en dernier dans la fonction que vous utilisez. Le paramètre peut être transmis aux fonctions tg\_send\_message et tg\_send\_message\_1 :

`x = tg_send_message(platform_id, text, None, None, None, False, False, False, None, entities`)

</details>

{% hint style="info" %}
Pour attribuer du texte avec des retours à la ligne à une variable, spécifiez la valeur comme suit :

`text = "Première ligne de texte" + "\n" + "Deuxième ligne de texte" + "\n" + "Troisième ligne"`
{% endhint %}

## Comment envoyer un message en spécifiant un bot Telegram particulier

tg\_send\_message\_1(token, platform\_id, text, client\_message\_id, reply\_markup, parse\_mode, disable\_web\_page\_preview, protect\_content, disable\_notification, message\_thread\_id, entities, business\_connection\_id)

<table><thead><tr><th width="288.94140625">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> token</strong></td><td>Jeton du bot Telegram obtenu via BotFather</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>ID utilisateur Telegram auquel un message doit être envoyé <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> text</strong></td><td>Texte du message</td></tr><tr><td><strong>client_message_id</strong></td><td>ID du message à citer</td></tr><tr><td><strong>reply_markup</strong></td><td>Paramètres du bouton  <a href="/pages/abfc096724eeab348d2242b15a18a108ffc54f52#how-to-delete-reply-buttons"><strong>**</strong></a></td></tr><tr><td><strong>parse_mode</strong></td><td>Mise en forme du texte en gras et en italique dans la description <a href="/pages/44ff7bf85a21a27f753656bd6131d63f5c73c46f"><strong>***</strong></a><strong>.</strong> Il peut avoir des valeurs telles que html, markdown, markdownV2.</td></tr><tr><td><strong>disable_web_page_preview</strong></td><td>Afficher l’aperçu du lien. Pour le désactiver, passez 1 ; sinon, passez 0 ou laissez-le vide "".</td></tr><tr><td><strong>protect_content</strong></td><td>Indicateur de protection du contenu. Passez une valeur différente de 0, False ou '' pour activer.</td></tr><tr><td><strong>disable_notification</strong></td><td>Indicateur de notification sonore (par défaut : 0). Passez 1 pour désactiver la notification, 0 pour l’activer.</td></tr><tr><td><strong>message_thread_id</strong> </td><td>ID du sujet (disponible pour les supergroupes avec la fonctionnalité forum activée)</td></tr><tr><td><strong>entities</strong></td><td>Cela vous permet de copier un texte préformaté avec tous ses styles et de simplement spécifier la plage de caractères où une police particulière doit être appliquée. Un exemple peut être trouvé dans le tg_request sous le champ correspondant. Le paramètre doit être un dictionnaire.</td></tr><tr><td><strong>business_connection_id</strong></td><td>Le <strong>ID Business</strong> la valeur est utilisée lors de la connexion du bot et affichée dans les canaux. Elle doit être fournie si un jeton de bot est inclus dans les paramètres et que le message doit être envoyé via un compte utilisateur lié au bot.</td></tr></tbody></table>

<details>

<summary>Exemple</summary>

Exemple de passage du paramètre :\
`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"`<mark style="color:red;">**`https://mavibot.ai"},`**</mark>`{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`

L’exemple montre uniquement le dictionnaire, tandis que le texte du message lui-même est attribué à une variable séparée.

</details>

## Comment modifier le texte d’un message Telegram

{% hint style="warning" %}
Veuillez noter !&#x20;

La fonction de modification d’un message n’est disponible que pour les messages nouveaux et récemment envoyés. <br>

La fenêtre de temps pendant laquelle la modification du message est autorisée est déterminée par le messager lui-même et dépend de la charge/activité de votre bot ; elle peut être réduite pour l’édition. <br>

Selon le support technique du messager, la durée optimale pour modifier un message est de 48 heures.
{% endhint %}

tg\_edit\_message\_text(platform\_id, message\_id, text, reply\_markup, parse\_mode, disable\_web\_page\_preview, entities)

<table><thead><tr><th width="270.03125">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>ID utilisateur Telegram auquel un message doit être envoyé <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_id</strong></td><td>ID du message à modifier. Cet ID doit avoir été enregistré au préalable lors de l’envoi du message.</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> text</strong></td><td>Texte du message</td></tr><tr><td><strong>reply_markup</strong></td><td>Paramètres du bouton  <a href="/pages/abfc096724eeab348d2242b15a18a108ffc54f52#how-to-delete-reply-buttons"><strong>**</strong></a></td></tr><tr><td><strong>parse_mode</strong></td><td>Mise en forme du texte en gras et en italique dans la description <a href="/pages/44ff7bf85a21a27f753656bd6131d63f5c73c46f"><strong>***</strong></a><strong>.</strong> Il peut avoir des valeurs telles que html, markdown, markdownV2.</td></tr><tr><td><strong>disable_web_page_preview</strong> </td><td>Afficher l’aperçu du lien. Pour le désactiver, passez 1 ; sinon, passez 0 ou laissez-le vide "".</td></tr><tr><td><strong>entities</strong></td><td>Cela vous permet de copier un texte préformaté avec tous ses styles et de simplement spécifier la plage de caractères où une police particulière doit être appliquée. Un exemple peut être trouvé dans le tg_request sous le champ correspondant. Le paramètre doit être un dictionnaire.</td></tr></tbody></table>

## Comment envoyer une réaction à un message

tg\_set\_reaction(platform\_id, message\_id, reaction)

<table><thead><tr><th width="305.015625">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> platform_id</td><td>ID du chat Telegram</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> message_id</td><td>ID du message</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> réaction</td><td>La réaction requise est transmise sous forme de chaîne.</td></tr></tbody></table>

<details>

<summary>Exemple</summary>

Exemple de code à copier :

react = tg\_set\_reaction(platform\_id, 1556, '👌')

Exemple dans le calculateur :

<div align="center" data-with-frame="true"><figure><img src="/files/55d054c70a25ec58eb82be86f14776384200f05d" alt="" width="563"><figcaption></figcaption></figure></div>

</details>

## Comment modifier la description d’une pièce jointe

**tg\_edit\_message\_caption(platform\_id, message\_id, caption, reply\_markup, parse\_mode, entities, show\_caption\_above\_media)**

<table><thead><tr><th width="305.015625">Paramètre </th><th>Descritption</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> platform_id</td><td>ID utilisateur Telegram auquel un message doit être envoyé <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> message_id</td><td>ID du message à modifier</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> caption</strong></td><td>Texte de la description</td></tr><tr><td><strong>reply_markup</strong></td><td>Paramètres du bouton <a href="#kak-propisyvat-knopki-v-parametre-reply_markup"><strong>**</strong></a></td></tr><tr><td><strong>parse_mode</strong></td><td>Mise en forme du texte en gras et en italique dans la description<a href="/pages/44ff7bf85a21a27f753656bd6131d63f5c73c46f"> <strong>***</strong></a><strong>.</strong>  Il peut avoir des valeurs telles que html, markdown, markdownV2.</td></tr><tr><td><strong>entities</strong> </td><td><p>Cela vous permet de copier un texte préformaté avec tous ses styles et de simplement spécifier la plage de caractères où une police particulière doit être appliquée. Un exemple peut être trouvé dans le tg_request sous le champ correspondant. Le paramètre doit être un dictionnaire.<br><br>Exemple de passage du paramètre :<br><code>entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"</code><mark style="color:red;"><strong><code>https://,mavibot.ai"}</code></strong></mark><code>,{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]</code></p><p></p><p>L’exemple montre uniquement le dictionnaire, tandis que le texte du message lui-même est attribué à une variable séparée.</p></td></tr><tr><td><strong>show_caption_above_media</strong></td><td>Prend la valeur True ; si ce paramètre est spécifié, le texte du message s’affichera au-dessus de la pièce jointe.</td></tr></tbody></table>

## Comment modifier les pièces jointes multimédias dans un message

<table><thead><tr><th width="270.03125">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>ID utilisateur Telegram auquel un message doit être envoyé <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_id</strong></td><td>ID du message à modifier. Cet ID doit avoir été enregistré au préalable lors de l’envoi du message. </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> media</strong></td><td><p>Un dictionnaire décrivant le fichier multimédia :
<br><em>Exemple de dictionnaire JSON pour remplacer une photo envoyée précédemment :</em><br><code>media = '{"type": "photo", "media": "&#x3C;file_to_send>"}'</code></p><p></p><p>où &#x3C;file_to_send> est recommandé d’être le file_id obtenu via le <a href="/pages/c594aeb79bbde67867885616f9d660ef5f77c8c0">webhook Telegram</a>. </p><p></p><p>Pour plus de détails, les paramètres du dictionnaire sont décrits dans la <a href="/pages/9856b217d7e6ce354545e2b44bf411edb87b7db0">documentation Telegram officielle</a>. </p></td></tr><tr><td><strong>reply_markup</strong></td><td>Paramètres du bouton <a href="#kak-propisyvat-knopki-v-parametre-reply_markup"><strong>**</strong></a></td></tr></tbody></table>

## **Comment modifier un clavier inline dans un message**

<table><thead><tr><th width="270.03125">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong></td><td>ID utilisateur Telegram auquel un message doit être envoyé <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_id</strong></td><td>ID du message à modifier. Cet ID doit avoir été enregistré au préalable lors de l’envoi du message. </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> reply_markup</strong></td><td>Paramètres du bouton <a href="#kak-propisyvat-knopki-v-parametre-reply_markup"><strong>**</strong></a></td></tr></tbody></table>

{% hint style="warning" %}
Vous ne pouvez modifier qu’un clavier inline.
{% endhint %}

<details>

<summary><strong>Exemple : modification de message avec l’API Telegram</strong></summary>

Vous trouverez ci-dessous un exemple détaillé de travail avec les fonctions de l’API Telegram pour la modification des messages.&#x20;

</details>

## Comment copier un message

**tg\_copy\_message(platform\_id, from\_chat\_id, message\_id, reply\_to\_message\_id, reply\_markup, parse\_mode, protect\_content, disable\_notification, caption, message\_thread\_id, entities, show\_caption\_above\_media)**

<table><thead><tr><th width="270.03125">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td> <mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>ID utilisateur Telegram VERS lequel un message doit être copié <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> from_chat_id</strong> </td><td>ID utilisateur Telegram DEPUIS lequel un message doit être copié <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_id</strong></td><td>ID du message à copier</td></tr><tr><td><strong>reply_to_message_id</strong> </td><td>ID du message original si le message copié est un commentaire</td></tr><tr><td><strong>reply_markup</strong> </td><td>Paramètres du bouton <a href="#kak-propisyvat-knopki-v-parametre-reply_markup"><strong>**</strong></a></td></tr><tr><td><strong>parse_mode</strong></td><td><p>Mise en forme du texte en gras et en italique dans la description <a href="/pages/44ff7bf85a21a27f753656bd6131d63f5c73c46f"><strong>***</strong></a><strong>.</strong></p><p>Il peut avoir des valeurs telles que html, markdown, markdownV2.</p></td></tr><tr><td><strong>protect_content</strong></td><td>Indicateur de protection du contenu. Passez une valeur différente de 0, False ou '' pour activer.</td></tr><tr><td><strong>disable_notification</strong> </td><td>Indicateur de notification sonore (par défaut : 0). Passez 1 pour désactiver la notification, 0 pour l’activer.                          </td></tr><tr><td><strong>caption</strong> - </td><td>Description jusqu’à 1024 caractères.</td></tr><tr><td><strong>message_thread_id</strong> </td><td>ID du sujet (disponible pour les supergroupes avec la fonctionnalité forum activée)</td></tr><tr><td><strong>entities</strong> </td><td>Cela vous permet de copier un texte préformaté avec tous ses styles et de simplement spécifier la plage de caractères où une police particulière doit être appliquée. Un exemple peut être trouvé dans le tg_request sous le champ correspondant. Le paramètre doit être un dictionnaire.<br><br>Exemple de passage du paramètre : <br><code>entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":</code><mark style="color:red;"><strong><code>"https://mavibot.ai"}</code></strong></mark><code>,{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]</code>  <br><br>L’exemple montre uniquement le dictionnaire, tandis que le texte du message lui-même est attribué à une variable séparée.</td></tr><tr><td><strong>show_caption_above_media</strong> </td><td>Prend la valeur True ; si ce paramètre est spécifié, le texte du message s’affichera au-dessus de la pièce jointe.</td></tr></tbody></table>

## Comment transférer un message

**tg\_forward\_message(platform\_id, from\_chat\_id, message\_id, protect\_content, disable\_notification,** **message\_thread\_id)**&#x20;

<table><thead><tr><th width="312.0703125">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>ID utilisateur Telegram VERS lequel un message doit être envoyé <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> from_chat_id</strong></td><td>ID utilisateur Telegram DEPUIS lequel un message doit être envoyé <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a></td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_id</strong></td><td>ID du message à transférer</td></tr><tr><td><strong>protect_content</strong></td><td>Indicateur de protection du contenu. Passez une valeur différente de 0, False ou '' pour activer.</td></tr><tr><td><strong>disable_notification</strong></td><td>Indicateur de notification sonore (par défaut : 0). Passez 1 pour désactiver la notification, 0 pour l’activer.</td></tr><tr><td><strong>message_thread_id</strong> </td><td>ID du sujet (disponible pour les supergroupes avec la fonctionnalité forum activée)</td></tr></tbody></table>

## Comment supprimer un message

**tg\_delete\_message(platform\_id, message\_id)**&#x20;

<mark style="color:red;">**!**</mark> Utilisez cette méthode pour supprimer un message, y compris les messages de service, avec les restrictions suivantes :

* Un message ne peut être supprimé que s’il a été envoyé il y a moins de 48 heures.
* Les messages avec dés dans un chat privé ne peuvent être supprimés que s’ils ont été envoyés il y a plus de 24 heures.
* Les bots peuvent supprimer les messages sortants dans les chats privés, les groupes et les supergroupes.
* Les bots peuvent supprimer les messages entrants dans les chats privés.
* Les bots disposant de l’autorisation **can\_post\_messages** peuvent supprimer les messages sortants dans les canaux.
* Si un bot est administrateur d’un groupe, il peut y supprimer n’importe quel message.
* Si un bot dispose de l’autorisation **can\_delete\_messages** dans un supergroupe ou un canal, il peut y supprimer n’importe quel message.&#x20;

<table><thead><tr><th width="294.3203125">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> platform_id</strong> </td><td>ID utilisateur Telegram <a href="#gde-vzyat-platform_id-dlya-otpravki-uvedomlenii"><strong>*</strong></a> </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> message_id</strong></td><td>ID du message à supprimer</td></tr></tbody></table>

## **Comment supprimer plusieurs messages**

tg\_delete\_messages(platform\_id, message\_ids)

<mark style="color:red;">**!**</mark> Utilisez cette méthode pour supprimer un message, y compris les messages de service, avec les restrictions suivantes :

* Un message ne peut être supprimé que s’il a été envoyé il y a moins de 48 heures.
* Les messages avec dés dans un chat privé ne peuvent être supprimés que s’ils ont été envoyés il y a plus de 24 heures.
* Les bots peuvent supprimer les messages sortants dans les chats privés, les groupes et les supergroupes.
* Les bots peuvent supprimer les messages entrants dans les chats privés.
* Les bots disposant de l’autorisation **can\_post\_messages** peuvent supprimer les messages sortants dans les canaux.
* Si un bot est administrateur d’un groupe, il peut y supprimer n’importe quel message.
* Si un bot dispose de l’autorisation **can\_delete\_messages** dans un supergroupe ou un canal, il peut y supprimer n’importe quel message.&#x20;

<table><thead><tr><th width="288.06640625">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> platform_id</td><td>ID utilisateur Telegram </td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark> message_ids</td><td>Un tableau d’IDs de messages à supprimer. Maximum de 100 éléments.</td></tr></tbody></table>

## **Exemple : envoi de message avec l’API Telegram**

<details>

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

Exemple 1

```
/*Il est pratique de définir le texte à l’avance dans une variable*/
text='Writing-writing-witing text'
/*Fonction d’envoi de message*/
soob=tg_send_message(platform_id, text)
/*Enregistrer l’ID du message envoyé*/
soob_id=soob['result']['message_id']

```

Exemple 2

```
id_group=-1001847103100
text='Test de l’envoi de message via la méthode API. Par exemple, *texte en gras*'
opts = {"inline_keyboard": [[{"text": "👍","callback_data":1}, {"text": "👎","callback_data":2}]]}
disable_web_page_preview=1
protect_content=''
disable_notification=1
parse_mode='markdown'
soob=tg_send_message(id_group, text,client_message_id, opts, parse_mode, disable_web_page_preview, protect_content, disable_notification) 


```

</details>

## **Exemple : modification de message avec l’API Telegram**

<details>

<summary>Exemple de configuration</summary>

Alors, envoyons-nous un message avec un clavier inline :

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

Ensuite, modifiez le texte du message :

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

Et modifiez les boutons :

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

Essayons de modifier un message avec une image. Pour cela, envoyez un message avec une image et enregistrez l’ID du message envoyé. Lisez les instructions détaillées sur la façon d’obtenir l’URL de l’image [ici](/doc/fr/chatbot/messageries/telegram/api/messages.md):&#x20;

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

Maintenant, modifions l’image et sa description :

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

</details>

<details>

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

```
/*Il est pratique de définir les paramètres à l’avance dans une variable.*/
text='Quel forfait souhaitez-vous choisir ?'
opts = {"inline_keyboard": [[{"text": "Forfait 1","callback_data":1}, {"text": "Forfait 2","callback_data":2}]]}
/*Fonction d’envoi de message*/
soob=tg_send_message(platform_id, text, None, opts)
/*Enregistrer l’ID du message envoyé*/
soob_id=soob['result']['message_id']

/*Modifier le message*/
text='Quel forfait vous intéresse ?'
tg_edit_message_text(platform_id, soob_id, text, opts)  

/*Modifier le clavier inline*/
opts = {"inline_keyboard": [[{"text": "Standard","callback_data":1}, {"text": "Premium","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)


/*Envoyer l’image avec la description*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "Ceci est une image")
/*Enregistrer l’ID du message envoyé*/
soob_id=soob['result']['message_id']

/*Modifier l’image*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*Modifier la description de l’image*/
tg_edit_message_caption(platform_id, soob_id, 'Ceci est MOI !')
```

</details>

## **Exemple : copie de message avec l’API Telegram**

<details>

<summary>Exemple</summary>

Envoyons un message et enregistrons son ID.

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

Et copions le message envoyé précédemment.

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

</details>

<details>

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

```
/*Il est pratique de définir les paramètres à l’avance dans une variable.*/
text='Quel forfait souhaitez-vous choisir ?'
opts = {"inline_keyboard": [[{"text": "Forfait 1","callback_data":1}, {"text": "Forfait 2","callback_data":2}]]}
/*Fonction d’envoi de message*/
soob=tg_send_message(platform_id, text, None, opts)
/*Enregistrer l’ID du message envoyé*/
soob_id=soob['result']['message_id']


/*Copier le message envoyé*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)
```

</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/messages.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.