This project provides a template for creating a Telegram bot using Python. It includes a CLI for managing the bot, a web controller using FastAPI for webhook integration.
While the production environment can be hosted on an external server, a local development environment is also recommended for testing the bot. It is crucial not to share the same bot token for production and development. It is recommended that each team member creates their own development bot.
To install locally python3.10, and poetry installed.
To configure the required variables locally, copy the following file:
cp .env.dist .env
Then, configure the BOT_TOKEN and SECRET_TOKEN variables. The WEBHOOK_HOST variable is only necessary if an external server is being used.
A Settings class is included that allows storing values in a table. You can specify the associated chat (chat), the name of the data (key), and its value (value). If you want data that exists for any chat, you can use 0 (zero) as the chat identifier.
The first step is to install the dependencies:
poetry install
Then, you can start the service in polling mode:
make dev
The bot should now be able to respond.
The first step is to install the dependencies:
poetry install
And configure the webhook to receive the updates:
make configure
Then, you can start the service in push mode:
make server
The bot should now be able to respond.
The bot supports the following commands. If anything else is sent, the bot will respond in echo mode (returns what is sent to it).
Returns a greeting message.
For obtaining open APIs, you can refer to the following GitHub repository: