README.ru.md

English | Русский

Шаблон Telegram-бота (fastapi-aiogram-ngrok-template-bot)

Шаблон Telegram-бота, использующего вебхук. Написан на Python с помощью aiogram на FastAPI

Туннелирование вебхука через ngrok.

Запуск (Docker Compose)

1. Создайте Telegram бота используя @BotFather, скопируйте API токен

2. Переименуйте файл .env.example в .env и вставьте скопированный токен в поле BOT_API_TOKEN

3. Создайте аккаунт ngrok, скопируйте токен авторизации и вставьте его в поле NGROK_AUTHTOKEN в файле .env

4. Создайте HTTPS Edge в панели ngrok, скопируйте URL в секции Endpoints и вставьте в поле NGROK_URL в файле .env

5. Скопируйте ярлык Edge без edge= в начале и вставьте в поле NGROK_EDGE в файле .env

Для Windows:

6. Установите и запустите Docker Desktop

Для Linux:

6. Установите пакеты docker, docker-compose с помощью менеджера пакетов вашего дистрибутива (пример для Arch):

pacman -S docker docker-compose

7. Запустите эту команду в корне проекта:

docker compose up --build

8. Проверьте бота в Telegram. Используйте поиск по имени пользователя, которое вы задали @BotFather при создании бота.