Las funciones de la API amplían significativamente las capacidades de un bot en Telegram. Al usar funciones de la API, puedes trabajar con archivos adjuntos, grupos y chats en Telegram — por ejemplo, automatizar el bloqueo o desbloqueo de usuarios, ¡y mucho más!

Fuente: API de bots de Telegram

¡Importante!

Para entender cómo trabajar con las funciones de la API, recomendamos encarecidamente revisar las reglas para especificar funciones y parámetros en la calculadora.

NOTACIÓN:

! — un signo de exclamación indica parámetros obligatorios

parámetro=None — esto muestra el valor predeterminado para el parámetro especificado.

Es incorrecto simplemente copiar el texto de la función de la documentación, así: tg_send_message(platform_id, "Algún texto", client_message_id=61818138, reply_markup=None, parse_mode=None, disable_web_page_preview=0, protect_content=False)

Los valores después de los signos igual representan valores predeterminados para cada parámetro. Por lo tanto, si no necesitas un parámetro en particular pero sí necesitas uno que le sigue, no puedes simplemente omitir el no utilizado — en su lugar, debes pasar explícitamente su valor predeterminado.

Por lo tanto, el uso correcto sería: tg_send_message(platform_id, "Algún texto", 61818138, None, None, 0, True)

¿Dónde puedo obtener el platform_id para enviar notificaciones?

  • Necesitas tener un bot de Telegram conectado a tu proyecto.
  • Envía cualquier mensaje a este bot desde la cuenta de Telegram donde deseas recibir notificaciones.
  • En la lista de clientes del proyecto, selecciona el diálogo del cliente al que deseas enviar solicitudes.
  • Copia el valor de ID del campo de mensajería.

  1. El parámetro platform_id se puede pasar sin especificar explícitamente valores numéricos.

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

Las funciones con este parámetro funcionarán incluso sin especificar explícitamente un valor de platform_id.

Importante: En la mayoría de las funciones, este parámetro es obligatorio y no debe omitirse.

2. Si necesitas usar la función en un chat, canal o grupo específico, debes proporcionar el platform_id como un valor numérico.

En la función tg_send_message(!platform_id, !text) mostrada arriba, el parámetro platform_id se pasa usando comillas que encierran un valor numérico:

tgmess = tg_send_message('1234566788', '¡Hola!')

Cómo definir botones en el parámetro reply_markup

Ejemplo de botones de respuesta:

opts = {"keyboard": [[{"text": "Izquierda"}, {"text": "Derecha"}]]}

Ejemplo de botones en línea:

opts = {"inline_keyboard": [[{"text": "Paquete 1","callback_data":1}, {"text": "Paquete 2","callback_data":2}]]}

Cómo usar formato de texto (Markdown) en el parámetro parse_mode**?**

El parámetro parse_mode formatea todo el texto o partes de él en cursiva o negrita. Puede tener los valores: html, markdown o markdownV2.

  1. Si eliges html:

para texto en negrita, usa "<b>título</b>"

para texto en cursiva, usa "<i>título</i>"

  1. Para Markdown:

para texto en negrita, usa "*título*"

para texto en cursiva, usa "_título_"

Ejemplo de envío de texto en cursiva:
tg_send_message(47615196, "<i>cursiva</i>",None,None,"html")

Ejemplo de envío de texto en negrita:
tg_send_message(platform_id, '*prueba*', None, None, 'markdown')