Funciones de la API de Telegram

Las funciones de la API amplían significativamente las capacidades de un bot en Telegram. Al usar las 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!

Origen: API del bot 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

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

Es incorrecto copiar simplemente el texto de la función de la documentación, así: 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)

Los valores después de los signos igual representan los valores predeterminados de cada parámetro. Por lo tanto, si no necesitas un parámetro concreto pero sí necesitas uno que vaya después, no puedes simplemente omitir el que no se usa; en su lugar, debes pasar explícitamente su valor predeterminado.

Así pues, la correcta uso sería: tg_send_message(platform_id, "Some text", 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 en la que quieras recibir notificaciones.

• En la lista de clientes del proyecto, selecciona el diálogo del cliente al que quieres enviar solicitudes.

• Copia el valor del ID del campo del mensajero.

Ejemplo de pasar el platform_id parámetro:

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

platform_id se proporcionó sin ningún valor

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, la plataforma_id parameter 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 el formato de texto (Markdown) en el parámetro parse_mode?

El parse_mode el parámetro da formato a todo el texto o a 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>caption</b>"

para texto en cursiva, usa "<i>caption</i>"

1. Para Markdown:

para texto en negrita, usa "*caption*"

para texto en cursiva, usa "_caption_"

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

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