English | Русский

Telegram-bot template (fastapi-aiogram-ngrok-template-bot)

Template for Telegram-bot that using webhook. Written in Python with aiogram and FastAPI

Tunneling webhook to the Web with ngrok.

How to launch (Docker Compose)

1. Create a Telegram bot using @BotFather, copy API token

2. Rename the .env.example file to .env and fill BOT_API_TOKEN field with copied token

3. Create an account on ngrok, copy your authentication token and paste it to NGROK_AUTHTOKEN field in .env

4. Create an HTTPS Edge on ngrok dashboard, copy URL in Endpoints section and paste it to NGROK_URL field in .env file

5. Copy edge label without edge= in beginning and paste it to NGROK_EDGE field in .env file

For Windows:

6. Install and start Docker Desktop

For Linux:

6. Install docker, docker-compose packages with package manager of your distro

7. Run this command in root of project:

docker compose up --build

8. Check the bot in Telegram. Search it by the username which you gave to @BotFather