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 !

Source : API du bot Telegram

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.

NOTATION :

! — 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 incorrect 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 bonne utilisation serait : tg_send_message(platform_id, "Some text", 61818138, None, None, 0, True)

Où puis-je obtenir le platform_id 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.

Exemple de transmission du platform_id paramètre :

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

platform_id a été fourni sans aucune valeur

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.

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.

Dans la fonction tg_send_message(!platform_id, !text) indiquée ci-dessus, la plateforme_id parameter est transmis en utilisant des guillemets entourant une valeur numérique :

tgmess = tg_send_message('1234566788', 'Bonjour !')

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_mode?

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. Si vous choisissez html :

pour texte en gras, utilisez "<b>caption</b>"

pour texte en italique, utilisez "<i>caption</i>"

1. Pour Markdown :

pour texte en gras, utilisez "*caption*"

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