Fonctions d'envoi et de modification de messages

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

Le platform_id spécifie l'identifiant d'un client particulier.

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

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

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

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

• Déclarez d'abord tous les paramètres utilisés dans la fonction. N'oubliez pas que les paramètres peuvent être passés 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 client.
  platform_id — ID client Telegram auquel le message doit être envoyé *\ >Nous répondrons dans le même chat où le client écrit

  text - texte du message. \ >Nous utilisons le formatage du texte - par exemple, la mise en gras.

  client_message_id - ID du message à citer\ >Dans les chats, cette variable se voit attribuer sa valeur automatiquement.
  reply_markup — paramètres des boutons **. \ >Assignons-la à la variable opts.
  parse_mode — Formatage du texte en gras et en italique dans la description ***. Peut prendre les valeurs html, markdown, markdownV2. Les caractères utilisés pour le formatage du texte du message sont décrits ici. \ >Utilisons markdown.
  disable_web_page_preview - Afficher l'aperçu du lien. Pour le désactiver, passez 1 ; sinon, passez 0 ou laissez vide "".\ >Nous pouvons passer n'importe quelle valeur car le texte du message ne contient pas de lien.
  protect_content — Indicateur de protection du contenu. Passez n'importe quelle valeur sauf 0, False ou '' pour activer.\ >Nous n'avons pas besoin de protection du contenu, nous passerons donc une chaîne vide ''.
  disable_notification — Indicateur de notification sonore (par défaut : 0). Passez 1 pour désactiver la notification, 0 pour l'activer.\ >Une notification est une fenêtre contextuelle affichant le texte du message. Activons-la.

• Ensuite, nous assemblons la fonction. N'oubliez pas d'assigner la fonction à une variable — cela vous permettra de suivre le statut d'envoi du message.

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 le statut d'envoi ; ensuite viennent les informations sur le message lui-même — son ID, les données de l'expéditeur et le contenu.

Exemple avec le paramètre entities

Vous pouvez stocker la chaîne originale dans une variable, comme indiqué ci-dessous :

text = "qwert asdfg zxcvb poiuy lkjhg 12345"

Vous devez écrire le paramètre comme un dictionnaire avec les données et spécifier le formatage souhaité en indiquant les polices :

entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"`` https://mavibot.ai"},{"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 passé 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)

Exemple de passage du paramètre :
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://mavibot.ai"},{"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 assigné à une variable séparée.

Exemple de code à copier :

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

Exemple dans la calculatrice :

Vous trouverez ci-dessous un exemple détaillé de travail avec les fonctions de l'API Telegram pour la modification de messages.

Exemple 1

/*Il est pratique de définir le texte dans une variable au préalable*/
text='Écrire-écrire-écrire du texte'
/*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 d\'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) 

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

Ensuite, modifions le texte du message :

Et modifions les boutons :

Essayons de modifier un message avec une image. Pour ce faire, 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 :

Maintenant, modifions l'image et sa description :

/*Il est pratique de définir les paramètres dans une variable au préalable.*/
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 une 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, 'C\'est MOI !')

Envoyons un message et enregistrons son ID.

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

/*Il est pratique de définir les paramètres dans une variable au préalable.*/
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)