# Fonctions API Telegram

Les fonctions API étendent considérablement les capacités d’un bot dans Telegram. En utilisant les fonctions API, vous pouvez travailler avec les pièces jointes, les groupes et les chats dans Telegram — par exemple, automatiser le blocage ou le déblocage des utilisateurs, et bien plus encore !

{% hint style="info" %}
Source : [API du bot Telegram](https://core.telegram.org/bots/api)
{% endhint %}

{% hint style="warning" %}
Important ! 

Pour comprendre comment travailler avec les fonctions API, nous vous recommandons vivement de consulter les règles de spécification des fonctions et des paramètres dans la calculatrice.

<mark style="color:red;">**NOTATION :**</mark>

<mark style="color:red;">**!**</mark> — un point d’exclamation indique des paramètres obligatoires

**paramètre=None** — cela indique la valeur par défaut du paramètre spécifié.

Il suffit <mark style="color:red;">**incorrect**</mark> de simplement copier le texte de la fonction depuis la documentation, comme ceci : tg\_send\_message(platform\_id, "Some text", client\_message\_id=61818138, reply\_markup=None, parse\_mode=None, disable\_web\_page\_preview=0, protect\_content=False)

Les valeurs après les signes égal représentent les valeurs par défaut de chaque paramètre. Par conséquent, si vous n’avez pas besoin d’un paramètre particulier mais que vous avez besoin de celui qui le suit, vous ne pouvez pas simplement ignorer celui qui n’est pas utilisé — vous devez à la place transmettre explicitement sa valeur par défaut.

Ainsi, la <mark style="color:green;">**bonne**</mark> utilisation serait : tg\_send\_message(platform\_id, "Some text", 61818138, None, None, 0, True)
{% endhint %}

### Où puis-je obtenir le <mark style="color:red;">platform\_id</mark> pour l’envoi de notifications ?

* Vous devez avoir un bot Telegram connecté à votre projet.
* Envoyez n’importe quel message à ce bot depuis le compte Telegram sur lequel vous souhaitez recevoir les notifications.
* Dans la liste des clients du projet, sélectionnez le dialogue client auquel vous souhaitez envoyer des requêtes.
* Copiez la valeur de l’ID depuis le champ du messager.

<div data-with-frame="true"><figure><img src="/files/2f83571b870479407f3c74ea28cf23fa76a2fdb7" alt="" width="359"><figcaption></figcaption></figure></div>

<details>

<summary>Exemple de transmission du <mark style="color:red;">platform_id</mark> paramètre :</summary>

1. Le paramètre platform\_id peut être transmis sans spécifier explicitement de valeurs numériques.

<figure><img src="/files/c5a23aba49bbf5510929ab0ef5b6c94d2a2e42e1" alt=""><figcaption><p>platform_id a été fourni sans aucune valeur</p></figcaption></figure>

`react = tg_set_reaction(platform_id, 1556, '👌')`

Les fonctions avec ce paramètre fonctionneront même sans spécifier explicitement une valeur platform\_id.
\
Important : dans la plupart des fonctions, ce paramètre est requis et ne doit pas être omis. <br>

2\. Si vous devez utiliser la fonction dans un chat, une chaîne ou un groupe spécifique, vous devez fournir le platform\_id sous forme de valeur numérique.

<figure><img src="/files/8082e727db486770bb84087d252895d558bc9729" alt="" width="563"><figcaption></figcaption></figure>

Dans la fonction **tg\_send\_message(!platform\_id, !text)** indiquée ci-dessus, la plateform&#x65;**\_id parameter** est transmis en utilisant des guillemets entourant une valeur numérique :

`tgmess = tg_send_message('1234566788', 'Bonjour !')`&#x20;

<figure><img src="/files/7b8824eb9fc5c499c82595f0ac80e8677479b1f1" alt="" width="563"><figcaption></figcaption></figure>

</details>

### Comment définir des boutons dans le paramètre reply\_markup

**Exemple de boutons de réponse :**

`opts = {"keyboard": [[{"text": "Gauche"}, {"text": "Droite"}]]}`

**Exemple de boutons inline :**

opts = {"inline\_keyboard": \[\[{"text": "Forfait 1","callback\_data":1}, {"text": "Forfait 2","callback\_data":2}]]}

### Comment utiliser le formatage du texte (Markdown) dans le paramètre parse\_mod&#x65;**?**&#x20;

Le **parse\_mode** paramètre met en forme tout le texte ou une partie de celui-ci en *italique* ou **gras**. Il peut prendre les valeurs : html, markdown ou markdownV2.

1. <mark style="color:blue;">**Si vous choisissez html :**</mark>

&#x20;        pour **texte en gras**, utilisez  `"<b>caption</b>"`

&#x20;        pour *texte en italique*, utilisez `"<i>caption</i>"`

2. <mark style="color:blue;">**Pour Markdown :**</mark>

&#x20;        pour **texte en gras**, utilisez  `"*caption*"`

&#x20;        pour *texte en italique*, utilisez  `"_caption_"`

**Exemple d’envoi de texte en italique :**\
`tg_send_message(47615196, "<i>italic</i>",None,None,"html")`

**Exemple d’envoi de texte en gras :**\
`tg_send_message(platform_id, '*test*', None, None, 'markdown')`


---

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