Funciones para enviar y editar mensajes

Consideremos un ejemplo simple con un conjunto de parámetros requeridos:

El platform_id especifica el identificador de un cliente específico.

Vea el mismo ejemplo, pero usando variables:

En este ejemplo, la variable soob contendrá la respuesta del servidor después de enviar un mensaje.

Si guarda el message_id de la respuesta recibida, le permitirá trabajar posteriormente con este mensaje (editar, eliminar, reenviar, comentar).

A menudo surgen dificultades al usar todos los parámetros. Consideremos el siguiente ejemplo:

• Primero, declare todos los parámetros utilizados en la función. Recuerde, los parámetros se pueden pasar no solo como valores, sino también como variables, lo que a menudo es más conveniente y claro. Variables como platform_id y client_message_id se pueden obtener de la tarjeta de perfil del cliente.
  platform_id — ID del cliente de Telegram al que se debe enviar el mensaje *\ >Responderemos en el mismo chat donde escribe el cliente

  text - texto del mensaje. \ >Usamos formato de texto, por ejemplo, resaltado en negrita.

  client_message_id - ID del mensaje a citar\ >En los chats, esta variable se asigna automáticamente.
  reply_markup — configuración de botones **. \ >Asignémoslo a la variable opts.
  parse_mode — Formato de texto en negrita y cursiva en la descripción ***. Puede tener valores como html, markdown, markdownV2. Los caracteres utilizados para formatear el texto del mensaje se describen aquí. \ >Usemos markdown.
  disable_web_page_preview - Mostrar vista previa del enlace. Para deshabilitarlo, pase 1; de lo contrario, pase 0 o déjelo vacío "".\ >Podemos pasar cualquier valor ya que el texto del mensaje no contiene un enlace.
  protect_content — Indicador de protección de contenido. Pase cualquier valor excepto 0, False o '' para habilitarlo.\ >No necesitamos protección de contenido, así que pasaremos una cadena vacía ''.
  disable_notification — Indicador de notificación sonora (predeterminado: 0). Pase 1 para deshabilitar la notificación, 0 para habilitarla.\ >Una notificación es una ventana emergente que muestra el texto del mensaje. Habilitémosla.

• A continuación, ensamblamos la función. Recuerde asignar la función a una variable; esto le permitirá rastrear el estado de envío del mensaje.

Esto es lo que obtuvimos:

Después de que el cliente nos envíe la palabra clave test, respondemos citando su mensaje.

En ok vemos el estado de envío; luego viene la información sobre el mensaje en sí: su ID, datos del remitente y contenido.

Ejemplo con el parámetro entities

Puede almacenar la cadena original en una variable, como se muestra a continuación:

text = "qwert asdfg zxcvb poiuy lkjhg 12345"

Debe escribir el parámetro como un diccionario con los datos y especificar el formato deseado indicando las fuentes:

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"}]

Pase el parámetro al final en la función que utilice. El parámetro se puede pasar tanto a la función tg_send_message como a tg_send_message_1:

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

Ejemplo de paso del parámetro:
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"}]

El ejemplo muestra solo el diccionario, mientras que el texto del mensaje en sí se asigna a una variable separada.

Ejemplo de código para copiar:

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

Ejemplo en la calculadora:

Puede encontrar un ejemplo detallado de trabajo con las funciones de la API de Telegram para editar mensajes a continuación.

Ejemplo 1

/*Es conveniente definir el texto en una variable de antemano*/
text='Escribiendo-escribiendo-escribiendo texto'
/*Función de enviar mensaje*/
soob=tg_send_message(platform_id, text)
/*Guardar el ID del mensaje enviado*/
soob_id=soob['result']['message_id']

Ejemplo 2

id_group=-1001847103100
text='Probando el envío de mensajes mediante el método API. Por ejemplo, *texto en negrita*'
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) 

Entonces, enviémonos un mensaje con un teclado en línea:

A continuación, edite el texto del mensaje:

Y edite los botones:

Intentemos editar un mensaje con una imagen. Para ello, envíe un mensaje con una imagen y guarde el ID del mensaje enviado. Lea las instrucciones detalladas sobre cómo obtener la URL de la imagen aquí:

Ahora, editemos la imagen y su descripción:

/*Es conveniente definir los parámetros en una variable de antemano.*/
text='¿Qué paquete le gustaría elegir?'
opts = {"inline_keyboard": [[{"text": "Paquete 1","callback_data":1}, {"text": "Paquete 2","callback_data":2}]]}
/*Función de enviar mensaje*/
soob=tg_send_message(platform_id, text, None, opts)
/*Guardar el ID del mensaje enviado*/
soob_id=soob['result']['message_id']

/*Editar el mensaje*/
text='¿Qué paquete le interesa?'
tg_edit_message_text(platform_id, soob_id, text, opts)  

/*Editar el teclado en línea*/
opts = {"inline_keyboard": [[{"text": "Estándar","callback_data":1}, {"text": "Premium","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)


/*Enviar imagen con la descripción*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "Esta es una imagen")
/*Guardar el ID del mensaje enviado*/
soob_id=soob['result']['message_id']

/*Editar la imagen*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*Editar la descripción de la imagen*/
tg_edit_message_caption(platform_id, soob_id, '¡Este soy YO!')

Enviemos un mensaje y guardemos su ID.

Y copiemos el mensaje enviado anteriormente.

/*Es conveniente definir los parámetros en una variable de antemano.*/
text='¿Qué paquete le gustaría elegir?'
opts = {"inline_keyboard": [[{"text": "Paquete 1","callback_data":1}, {"text": "Paquete 2","callback_data":2}]]}
/*Función de enviar mensaje*/
soob=tg_send_message(platform_id, text, None, opts)
/*Guardar el ID del mensaje enviado*/
soob_id=soob['result']['message_id']


/*Copiar el mensaje enviado*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)