раздел 06

Шпаргалка

Всё главное про помощника на Telethon коротко.

Что
Личный помощник в Telegram на Telethon: работает через твой аккаунт, снимает рутину по твоим правилам.
Зачем
Автоответы, дайджесты из каналов, выборка по фильтру, пересылка нужного себе, напоминания, суммаризация.
Как
Локально на компьютере (проще) или на сервере (всегда онлайн). Правила плюс, по желанию, LLM для смысла.

Локально против сервера

Что сравниваемЛокальноНа сервере
СложностьПроще, старт быстрыйСложнее: Docker, SSH, иногда прокси
СтоимостьБесплатноАренда VPS
ДоступностьПока компьютер включёнВсегда онлайн
Как срабатываетВручную или по расписаниюСлушает новые сообщения сразу
Где файл сессииНа твоём компьютереНа арендованной машине
Кому подойдётНачать и попробоватьПостоянные автоответы 24/7

Чек-лист запуска

  1. Поставить Python и Telethon (локально) или VPS с Docker (на сервере).
  2. Получить api_id и api_hash на my.telegram.org.
  3. Первый вход, появится файл сессии - убрать его в безопасное место.
  4. Описать правила: от кого, ключевые слова, время.
  5. По желанию подключить LLM для смысловых решений и суммаризации.
  6. Запустить: по расписанию (локально) или обработчиком событий (на сервере).
  7. Проверить на паре сценариев, посмотреть логи.

Чек-лист безопасности

  • Автоматизировать только свою рутину, без массовых рассылок незнакомым.
  • Держать темп человеческим: задержки и лимиты на число действий.
  • Автоответы честные - не выдавать бота за себя во вред, предупреждать людей.
  • Закрытые чаты - только те, где ты сам участник.
  • Файл сессии охранять как пароль: не в git, не в образ Docker, не пересылать.
  • Ключи (api_id, api_hash, ключи API моделей) хранить отдельно от кода.
  • При подозрении на утечку - завершить сессии в настройках Telegram.

Глоссарий

  • Telethon - Python-библиотека, которая работает через твой личный аккаунт Telegram, а не через бота.
  • Файл сессии - сохранённый вход в аккаунт. Кто получил файл, получил доступ к аккаунту без пароля.
  • api_id и api_hash - ключи приложения с my.telegram.org, по ним Telethon входит под твоим аккаунтом.
  • Обработчик (event) - код, который срабатывает на новое сообщение по заданным признакам.
  • Правило - условие плюс действие: от кого, какие слова, в какое время - и что с этим делать.
  • LLM - языковая модель по API; подключают, когда нужен смысл, а не только совпадение слов.
  • Прокси - промежуточный сервер; через него пускают трафик, если прямое подключение не работает.
  • Файл сессии на сервере - тот же вход, но на арендованной машине; охранять особенно строго.

Куда дальше