✨Dvurechensky✨

✨ Telegram Bot Template ✨

Шаблон бота для Telegram

• Шаблон бота для Telegram
  • Структура
    • ✅ Плюсы:
    • ⚠️ Минусы/заметки:
  • Документация
  • Функции
    • Предварительные условия
    • Получение учетных данных
      • Токен бота
      • Учетные данные API
  • Использование
  • Ведение журнала

Структура

bot/
 ├─ config/
 ├─ core/
 ├─ services/
 ├─ utils/
 ├─ main.py
 └─ __init__.py

• core/ — ядро: менеджеры БД, сервисов, тесты. Всё, что отвечает за логику и инфраструктуру.
• services/ — отдельный слой для конкретных функциональностей: callbacks, commands, keyboards, states, api. Каждый сервис изолирован и можно легко расширять.
• utils/ — вспомогательные функции/утилиты.
• config/ — конфиги бота (токены, настройки). Отделено от логики.
• main.py — точка входа.

✅ Плюсы:

• Чистая многослойная архитектура.
• Легко масштабировать, добавлять новые команды/сервисы.
• Хорошая изоляция логики и сервиса.
• Подходит для командной работы — никто не будет ломать ядро, работая над клавиатурами или callbacks.

⚠️ Минусы/заметки:

• Если проект станет реально большим, services/ может вырасти и станет сложно ориентироваться. Можно будет рассмотреть submodules или package namespace.

Документация

• Полный файл изменений
• Задачи
• Полная чистка Linux тачки после использования
• Установка
• Настройка прокси-сервера
• SMTP - проверка доступности портов

Функции

• ✨ Функция 1
• 👹 Функция 2
• 🔐 Функция 3
• 💀 Функция 4
• 💬 Функция 5
• ☔ Функция 6
• 🛡️ Функция 7
• 💾 Функция 8
• 📋 Функция 9
• 🌁 Функция 10

Предварительные условия

• Python 3.8+
• Аккаунт Telegram
• Токен бота от @BotFather
• Учётные данные API от my.telegram.org

Получение учетных данных

Токен бота

• Написать @BotFather в Telegram
• Отправить /newbot
• Следуйте инструкциям по созданию бота
• Скопируйте токен в ваш файл .env
• Чтобы узнать CHAT_ID - перейдите по адресу https://api.telegram.org/bot<YOUR_TOKEN_BOT>/getUpdates и предварительно нажмите /start в боте и введите 1 сообщение в чате куда его добавите администратором
• API_HASH - берётся из аккаунта разработчика телеграмма с my.telegram.org

BOT_TOKEN=YOUR_BOT_TOKEN
API_ID=YOUR_API_ID
API_HASH=YOUR_API_HASH

Учетные данные API

• Посетите https://my.telegram.org
• Войдите, используя свой номер телефона
• Перейти к разделу API Development tools
• Выберите Create new application
• Скопируйте API ID, BOT TOKEN и API Hash в ваш файл .env
• Указать допустимые идентификаторы Telegram в ADMIN_USERNAMES которые будут пользоваться вашим ботом и станут его администраторами

Использование

• Запустить бота: /start
• Посмотрите справку: /help
• Список ваших сервисов: 🌀 My Services

Ведение журнала

Все действия регистрируются в:

• app.log (файл)
• Вывод в консоль

✨Dvurechensky✨