telegram-bot-template

Este repositorio es una plantilla para crear bots con pyTelegramBotAPI de forma sencilla y dockerizada.

Instrucciones

A continuación se describen las instrucciones a seguir para hacer funcionar nuestro bot de Telegram.

Tenemos 2 opciones:

• Usando Docker
• Usando instalación local de Python

Pasos previos

En ambas modalidades, necesitamos previamente crear un bot desde BotFather para obtener el TOKEN de nuestro bot.

Una vez tenemos el TOKEN, debemos renombrar el fichero .env.sample por .env y reemplazar el valor actual de BOT_TOKEN con el de nuestro TOKEN.

Usando Docker

En caso de usar Docker, podemos construir nuestro bot y ejecutarlo con el siguiente comando:

docker compose up -d --build

Cuando se complete el comando, ya estará ejecutándose nuestro bot. Puedes consultar los logs del mismo mediante el siguiente comando:

docker compose logs -f

Usando instalación local de Python

Para lanzar nuestro bot usando una instalación local de Python, usaremos un entorno virtual para no ensuciar nuestra instalación local. Los pasos a seguir son los siguientes:

1. Crear entorno virtual
2. Activar entorno virtual
3. Instalar dependencias
4. Ejecutar bot

Crear entorno virtual

Cambia python3 por python en caso de necesitarlo:

python3 -m venv venv

Activar entorno virtual

Esto dependerá del sistema operativo que estés usando.

En linux/macos será:

source venv/bin/activate

En windows será:

.\venv\Scripts\activate.bat

En ambos casos, si ha funcionado deberíamos ver que nuestro prompt tiene al inicio ahora (venv).

Instalar dependencias

Cambia python3 por python en caso de necesitarlo:

python3 install -r requirements.txt

Ejecutar bot

Cambia python3 por python en caso de necesitarlo:

python3 bot.py

Enlaces de interés

• API de Telegram