🤖 Telegram Bot Management Service

Сервис для автоведения Telegram каналов с поддержкой ИИ генерации контента, отложенной публикации и маркетингового анализа.

✨ Основные возможности

📊 Управление каналами

• Добавление и удаление Telegram каналов
• Подробная статистика по каждому каналу
• Просмотр истории постов
• Управление настройками каналов

🤖 ИИ генерация контента

• Поддержка различных ИИ провайдеров (OpenAI, Anthropic)
• Индивидуальные промты для каждого канала
• Анализ существующего контента канала
• Генерация тематических постов

⏰ Планирование публикаций

• Отложенная публикация постов
• Временные посты с автоудалением
• Ручное создание и редактирование постов
• Поддержка медиа файлов

📈 Маркетинговый анализ

• Поиск подходящих каналов для рекламы
• Анализ тематики и аудитории
• Рекомендации по размещению рекламы
• Оценка совместимости каналов

🚀 Быстрый старт

1. Установка зависимостей

pip install -r requirements.txt

2. Настройка переменных окружения

Создайте файл .env в корне проекта:

# Database
DATABASE_URL=sqlite:///./telegram_bot.db

# Telegram Bot
TELEGRAM_BOT_TOKEN=yout_bot_api

# Security
SECRET_KEY=your_secret_key_here
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30

# AI Providers (optional)
OPENAI_API_KEY=your_openai_key_here
ANTHROPIC_API_KEY=your_anthropic_key_here

# Server
HOST=0.0.0.0
PORT=8000

3. Получение Telegram Bot Token

1. Найдите @BotFather в Telegram
2. Отправьте команду /newbot
3. Следуйте инструкциям для создания бота
4. Скопируйте полученный токен в файл .env

4. Запуск сервиса

python run.py

Сервис будет доступен по адресу: http://localhost:8000

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

Веб-интерфейс

• Откройте http://localhost:8000 в браузере
• Зарегистрируйтесь или войдите в систему
• Добавьте свои Telegram каналы
• Настройте ИИ для генерации контента
• Создавайте и планируйте посты

API

• API документация: http://localhost:8000/docs
• Swagger UI: http://localhost:8000/redoc

🔧 Настройка ИИ

OpenAI

1. Получите API ключ на platform.openai.com
2. Добавьте ключ в настройки сервиса
3. Выберите модель (GPT-4, GPT-3.5 Turbo)

Anthropic

1. Получите API ключ на console.anthropic.com
2. Добавьте ключ в настройки сервиса
3. Выберите модель (Claude 3 Opus, Sonnet, Haiku)

📊 Структура проекта

telegram_bot_service/
├── main.py                 # Основной API сервер
├── web_routes.py          # Веб-маршруты
├── database.py            # Модели базы данных
├── models.py              # Pydantic модели
├── auth.py                # Аутентификация
├── ai_service.py          # Сервис ИИ
├── telegram_service.py    # Telegram API
├── marketing_service.py   # Маркетинговый анализ
├── config.py              # Конфигурация
├── run.py                 # Скрипт запуска
├── requirements.txt       # Зависимости
├── templates/             # HTML шаблоны
│   ├── base.html
│   ├── login.html
│   ├── dashboard.html
│   └── channels.html
└── static/                # Статические файлы

🔐 Безопасность

• Все пароли хешируются с помощью bcrypt
• JWT токены для аутентификации
• API ключи хранятся в зашифрованном виде
• CORS настройки для веб-интерфейса

📈 Мониторинг

Сервис предоставляет подробную статистику:

• Количество подписчиков
• Просмотры постов
• Уровень вовлеченности
• История публикаций

🛠️ Разработка

Добавление новых ИИ провайдеров

1. Добавьте провайдера в config.py
2. Реализуйте методы в ai_service.py
3. Обновите веб-интерфейс

Расширение функциональности

• Добавьте новые эндпоинты в main.py
• Создайте соответствующие шаблоны
• Обновите базу данных при необходимости

🐛 Устранение неполадок

Ошибка подключения к Telegram

• Проверьте правильность токена бота
• Убедитесь, что бот добавлен в канал как администратор

Ошибки ИИ генерации

• Проверьте API ключи
• Убедитесь в наличии средств на счете
• Проверьте лимиты API

Проблемы с базой данных

• Убедитесь в правильности DATABASE_URL
• Проверьте права доступа к базе данных

📄 Лицензия

MIT License

🤝 Поддержка

Если у вас возникли вопросы или проблемы:

1. Проверьте документацию API
2. Изучите логи сервера
3. Создайте issue в репозитории

---

Примечание: Этот сервис предназначен для управления собственными Telegram каналами. Убедитесь, что у вас есть права на управление каналами, которые вы добавляете в сервис.