Saltar a contenido

Telegram

Integra tu código con Telegram para enviar mensajes, archivos y más.

Instalación

pip install botcity-telegram-plugin

Configuración del Token de API

Necesitamos crear un bot de Telegram y generar un token para que tu código pueda interactuar con la API de Telegram.

Crear BotTelegram:

  • Abre un chat con @BotFather en Telegram. Estará en tu lista de usuarios.

  • Envía el comando /start.

  • Envía el comando /newbot.

  • @BotFather te pedirá un nombre y un nombre de usuario para tu bot.

Tu bot está listo y tu token aparecerá en la conversación con @BotFather.

Iniciar el Bot

Ahora, será necesario iniciar tu bot haciendo clic en el enlace que @BotFather pone disponible junto a tu token. Te dirigirá a una conversación con tu bot, así que simplemente haz clic en el botón start.

Configuración de privacidad de grupo

Usando el chat con @BotFather, será necesario desactivar la configuración de privacidad del grupo utilizando lo siguiente:

  • Envía el comando /mybots.
  • Elige el bot que acabas de crear.
  • Haz clic en bot settings.
  • Haz clic en Group Privacy.
  • Haz clic en turn off para desactivar la privacidad del grupo.

Agregar un bot a un grupo

Con tu bot de Telegram creado y tu token en mano, agrega tu bot al grupo con el que deseas interactuar y comienza a usar el complemento.

Important

Sugerimos que después de iniciar tu primer bot e incluirlo en un grupo, envíes un mensaje manual al bot para que las actualizaciones identifiquen el grupo creado. La API de Telegram tiene un error donde, en algunos casos, las actualizaciones solo reconocen el grupo a partir de un mensaje iniciado manualmente. Si recibes el error Bad Request: chat not found al intentar enviar un mensaje, recuerda iniciar una interacción manual con el grupo al que se agregó.

Importar el complemento

Después de instalar este paquete, el siguiente paso es importar el paquete en tu código y comenzar a usar las funciones.

from botcity.plugins.telegram import BotTelegramPlugin

Enviar Mensaje

from botcity.plugins.telegram import BotTelegramPlugin

# Instantiate the plugin
telegram = BotTelegramPlugin(token='<your_token_bot_telegram>')

# Send Message
response = telegram.send_message(
    text="This is an automated test message through my method.",
    group="BotGroupTest",
    username=["@TestBotCitybot"]
)

Aquí está la salida esperada:

Editar un Mensaje

from botcity.plugins.telegram import BotTelegramPlugin

# Instantiate the plugin
telegram = BotTelegramPlugin(token='<your_token_bot_telegram>')

# Send Message
response = telegram.send_message(
    text="This is an automated test message through my method.",
    group="BotGroupTest"
)

# Edit Message
telegram.edit_message(
    text="This is an edited message",
    response=response,
    username=["@TestBotCitybot"]
)

Aquí está la salida esperada:

Subir un Documento

from botcity.plugins.telegram import BotTelegramPlugin

# Instantiate the plugin
telegram = BotTelegramPlugin(token='<your_token_bot_telegram>')


# Upload Document
response = telegram.upload_document(
    document='test_document.zip',
    group="BotGroupTest",
    caption="This is a document upload"
)

Aquí está la salida esperada:

Eliminar un Mensaje/Archivo

from botcity.plugins.telegram import BotTelegramPlugin

# Instantiate the plugin
telegram = BotTelegramPlugin(token='<your_token_bot_telegram>')

# Send Message
response = telegram.send_message(
    text="This is an automated test message through my method.",
    group="BotGroupTest"
)

# Delete Message
delete = telegram.delete_message(response=response)

# Upload Document
response = telegram.upload_document(
    document='test_document.zip',
    group="BotGroupTest",
    caption="This is a document upload"
)

# Delete upload
delete = telegram.delete_message(response=response)