Бот для Telegram Business, который сохраняет входящие сообщения и присылает владельцу копию, если сообщение удалили, отредактировали или если это одноразовое/таймерное медиа из ответа.

Проект рассчитан на запуск через Docker Compose. В контейнере используется Python 3.12, SQLite и локальная папка для медиафайлов.

• Логирует business-сообщения через aiogram.
• Сохраняет сообщения в SQLite по ключу business_connection_id + chat_id + message_id.
• Скачивает медиа в локальную папку, чтобы файл оставался доступен после удаления сообщения.
• Присылает владельцу удаленные сообщения: текст, фото, видео, документы, анимации, стикеры, голосовые, аудио, кружки, геопозиции, контакты, опросы, dice, venue, game.
• Поддерживает альбомы: удаленные фото/видео из одного media group отправляются одним альбомом, когда это возможно.
• Отслеживает редактирование сообщений и присылает старую/новую версию.
• Поддерживает все ContentType из aiogram 3.21.0: если Telegram добавит редкий или service-тип, бот сохранит тип и JSON-снимок вместо падения.
• Сохраняет reply-media только в режиме, заданном REPLY_MEDIA_CAPTURE_MODE.
• Автоматически чистит локальные медиа: после успешной отправки отчета удаляет уже ненужные файлы и раз в заданный интервал удаляет старые локальные копии.

• Бот работает через Telegram Business API, поэтому его нужно подключить к Telegram Business-аккаунту.
• Если бот не видел сообщение до удаления, он сможет прислать только уведомление с ID, без содержимого.

Создайте .env из .env.example.

BOT_TOKEN=YOUR_BOT_TOKEN_HERE
REPLY_MEDIA_CAPTURE_MODE=protected

Доступные настройки:

• BOT_TOKEN - токен бота из BotFather. Обязателен.
• REPLY_MEDIA_CAPTURE_MODE=protected - сохранять медиа из ответа только если Telegram пометил исходное сообщение как protected. Режим по умолчанию.
• REPLY_MEDIA_CAPTURE_MODE=all - старое поведение: сохранять любое медиа, на которое вы ответили.
• REPLY_MEDIA_CAPTURE_MODE=off - полностью выключить сохранение медиа из ответов.
• OWNER_ID - fallback ID владельца, используется только если Telegram не вернул владельца business connection.
• DATABASE_URL - путь к базе. В Docker Compose уже задано sqlite:////app/data/database.db.
• MEDIA_DIR - папка медиа. В Docker Compose уже задано /app/media.
• MEDIA_RETENTION_DAYS=7 - сколько дней хранить локальные копии медиа. 0 выключает фоновую TTL-очистку.
• MEDIA_CLEANUP_INTERVAL_SECONDS=3600 - как часто запускать фоновую очистку.
• DELETE_LOCAL_MEDIA_AFTER_REPORT=1 - удалять локальную копию сразу после успешной отправки владельцу удаленного, отредактированного или одноразового медиа.

1. Откройте @BotFather.
2. Создайте бота или выберите существующего.
3. Скопируйте токен и укажите его в .env как BOT_TOKEN.
4. В BotFather включите поддержку Telegram Business для бота.
5. В Telegram подключите бота к своему Business-аккаунту в настройках Telegram Business.
6. Запустите контейнер и отправьте боту /start, чтобы проверить, что он отвечает.

Официальная инструкция Docker: https://docs.docker.com/engine/install/ubuntu/

Удалите конфликтующие старые пакеты:

sudo apt remove docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc
sudo apt update

Установите Docker

sudo curl -fsSL https://get.docker.com | sh

Проверьте установку:

sudo docker compose version

1. Перейдите в папку проекта:

cd ~/telelog

1. Создайте .env.

cp .env.example .env
nano .env

1. Заполните минимум:

BOT_TOKEN=YOUR_BOT_TOKEN_HERE
REPLY_MEDIA_CAPTURE_MODE=protected

1. Соберите и запустите контейнер:

docker compose up -d --build

1. Посмотрите логи:

docker compose logs -f bot

1. Проверьте статус:

docker compose ps

1. Напишите боту /start и подключите его к Telegram Business.

Docker Compose подключает две папки:

• ./data:/app/data - база SQLite, файл data/database.db.
• ./media:/app/media - сохраненные медиафайлы.

Эти папки остаются на хосте и не пропадают при пересоздании контейнера.

По умолчанию бот не хранит медиа бесконечно:

• после успешной отправки владельцу удаленного/одноразового/старой версии медиа локальный файл удаляется;
• файлы, которые еще не понадобились, чистятся фоном через MEDIA_RETENTION_DAYS;
• в базе остаются file_id и метаданные, поэтому для обычных медиа бот сможет попытаться отправить файл через Telegram file_id, даже если локальная копия уже удалена.

Если хотите хранить локальные копии дольше, увеличьте MEDIA_RETENTION_DAYS в .env.

Остановить (в папке с проектом):

docker compose down

Запустить снова:

docker compose up -d

Пересобрать после изменения кода:

docker compose up -d --build

Посмотреть последние 100 строк логов:

docker compose logs --tail=100 bot

Перезапустить только бота:

docker compose restart bot

1. Остановите контейнер:

docker compose down

1. Обновите файлы проекта.

2. Пересоберите и запустите:

docker compose up -d --build

База и медиа сохранятся в data и media.

Docker предпочтителен, но локальный запуск тоже возможен:

python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
python main.py

Используйте Python 3.12. На Python 3.14 у pinned зависимостей могут отсутствовать готовые wheel, и установка может потребовать Microsoft C++ Build Tools.