Python

Bot de Telegram con Webhooks

Requisitos previos

Arquitectura del sistema

Implementación

Crea un nuevo entorno virtual e instala las dependencias:

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate.bat # Windows
pip install fastapi hypercorn python-telegram-bot python-dotenv

Configura las variables de entorno:

TELEGRAM_BOT_TOKEN=tu_token_aqui
RAILWAY_PUBLIC_DOMAIN=https://tudominio.com

Inicializa el bot con utilizando el método Application.builder():

from telegram.ext import Application

bot_builder = (
    Application.builder()
    .token(os.getenv('TELEGRAM_BOT_TOKEN'))
    .updater(None)  # Desactiva el updater para webhooks
    .build()
)

Configura el servicio con FastAPI:

@asynccontextmanager
async def lifespan(_: FastAPI):
    await bot_builder.bot.setWebhook(WEBHOOK_DOMAIN)
    async with bot_builder:
        await bot_builder.start()
        yield
        await bot_builder.stop()

app = FastAPI(lifespan=lifespan)

Define el endpoint de entrada que procesará las actualizaciones recibidas desde Telegram:

@app.post("/")
async def process_update(request: Request):
    update = Update.de_json(await request.json(), bot_builder.bot)
    await bot_builder.process_update(update)
    return Response(status_code=HTTPStatus.OK)

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("¡Bot activado! 🚀")

bot_builder.add_handler(CommandHandler("start", start))

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text(update.message.text)

bot_builder.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

Flujo de trabajo del Webhook

1. Registro del webhook: Al iniciar la aplicación, se configura la URL en Telegram

2. Recepción de actualizaciones: Telegram envía actualizaciones via POST a nuestro endpoint

3. Procesamiento: FastAPI deserializa el JSON y lo convierte en un objeto Update

4. Ejecución de handlers: La aplicación de bot procesa la actualización con los handlers registrados

5. Respuesta: El bot envía respuestas mediante llamadas a la API de Telegram"

Despliegue en producción

Conclusión

Esta implementación combina la eficiencia de FastAPI con la flexibilidad de python-telegram-bot para crear bots escalables. Los webhooks son ideales para entornos de producción donde el rendimiento y la eficiencia en el uso de recursos son críticos.