Hardcoding PRO: Telegram как рабочая среда ИИ

0. Если ты новичок в вайбкодинге, начни отсюда

Тебе не нужно уметь программировать. В этом практикуме код пишет и запускает ИИ-агент. Твоя задача: дать ему доступ к рабочей среде, один раз безопасно подключить Telegram и дальше ставить задачи обычным языком.

Что должно получиться в конце первой практики: ты пишешь Codex или Claude Code обычную команду вроде «прочитай последние 20 сообщений в этом чате и сделай сводку», а агент сам использует Telegram, получает реальные сообщения и возвращает результат с идентификаторами источников.

Актуальность правил лучше проверять по официальным Telegram API Terms of Service и Terms of Service for Content Licensing перед запуском массовых или ИИ-сценариев.

Что тебе понадобится

обычный аккаунт Telegram;
Codex, Claude Code, ZCode, OpenCode или другой ИИ-агент, который умеет работать с терминалом и файлами;
компьютер или сервер, где агент может запускать код;
доступ к my.telegram.org для получения api_id и api_hash;
немного времени на первое подключение, это самая длинная часть настройки.

Пять слов, которые нужно понять один раз

ИИ-агент
Codex или Claude Code. Это программист, которому ты ставишь задачу словами. Он сам создаёт файлы, запускает команды, читает ошибки и исправляет код.

Telethon
Библиотека, через которую программа может работать с Telegram от имени твоего пользовательского аккаунта. Для тебя это просто мост между ИИ-агентом и Telegram.

api_id и api_hash
Данные Telegram для программного подключения аккаунта. Получаются на my.telegram.org. Их не нужно отправлять в обычный чат с ИИ.

Файл авторизации .session
Файл, который появляется после первого входа. Благодаря ему не нужно каждый раз вводить код из Telegram. Относись к нему как к паролю: не отправляй его людям и не публикуй.

Терминал
Окно, где выполняются команды. В вайбкодинге ты не обязан печатать команды сам. Если агент умеет пользоваться терминалом, он должен выполнять техническую работу самостоятельно.

Как проходить этот гайд

Сначала подключение.
Дай агенту главный промпт и пройди авторизацию.

Потом четыре практических задания.
Не пытайся сразу строить CRM, ботов и мониторинг.

После первого успеха выбирай нужный кейс.
CRM, сторис, поиск, каналы, боты, автоматизации.

Если функции нет, попроси ИИ создать новый навык.
Ты формулируешь результат, агент сам достраивает инструмент.

Перейти к 4 практическим заданиям

Главное правило вайбкодинга: если агент пишет тебе «выполни эту команду», «создай файл» или «установи библиотеку», хотя у него самого есть доступ к терминалу и файлам, отвечай: «Сделай это сам. От меня запрашивай только то, что действительно требует моего участия».

Главная мысль

Схема 01

Telegram перестаёт быть отдельным приложением: ИИ получает единый рабочий слой для данных, действий, CRM, контента и автоматизаций.

Вы даёте ИИ-агенту слой выполнения действий внутри Telegram. После этого Telegram для него становится рабочей средой, а не просто мессенджером.

Ваш Telegram→Telethon / MTProto / Bot API→Codex или Claude Code→навыки + автоматизации→реальная работа

Не вы изучаете методы Telegram API. Агент сам решает, какой инструмент нужен под задачу, пишет код, создаёт навык, тестирует его и использует повторно. Вы формулируете результат обычным языком.

1. Что именно получает ваш ИИ-агент

Практически полноценные руки внутри Telegram, в пределах прав вашего аккаунта, прав администратора и возможностей Telegram API.

Ваш личный Telegram

Диалоги, история, поиск, файлы, контакты, отправка, Избранное, доступные сторис и другие данные, которые видит авторизованный пользователь.

Каналы и сообщества

Анализ контента, поиск, публикационные сценарии, работа с медиа, мониторинг, админские операции там, где у аккаунта есть соответствующие права.

Боты и ИИ-сервисы

Создание проектов ботов, управление их кодом и инфраструктурой, Bot API, управляемые боты, Telegram Business, сквозное тестирование и связка с внешними системами.

Ключ: агент не ограничен заранее написанными функциями. Если нужной возможности нет, Codex / Claude Code может сам изучить Telegram API, написать новый вспомогательный модуль или навык, протестировать его и подключить к вашему набору инструментов Telegram.

Telegram официально поддерживает через API глобальный поиск, сторис, работу с ботами и управляемыми ботами. Конкретное действие всегда зависит от прав аккаунта, типа чата, лимитов и доступности соответствующего метода API.

2. Что с этим можно построить: 24 реальных сценария

Схема 02

Не учим функции Telethon по списку. Смотрим на продуктовые направления: CRM, поиск, контент, боты, файлы, автоматизации и тестирование.

Ниже не список функций Telethon. Это продукты и рабочие процессы, которые ИИ-агент может построить поверх Telegram.

CRM НА БАЗЕ ИИ

1. Личная CRM прямо из Telegram

ИИ сам читает выбранные деловые переписки и ведёт карточку контакта: кто это, что обсуждали, стадия сделки, обещания сторон, сумма, следующий шаг, дедлайн, последняя активность. Вручную CRM не заполняется.

СЕКРЕТАРЬ

2. Пассивный ИИ-секретарь

Агент регулярно проверяет нужные личные чаты, выделяет важное, собирает обещания и задачи, предупреждает о зависших диалогах и готовит ответы. Отправляет наружу только по установленным правилам подтверждения.

ПОВТОРНЫЙ КОНТАКТ

3. Контроль договорённостей

«Кому я обещал написать?», «кто обещал прислать договор?», «с кем мы не договорили про оплату?». ИИ находит это по реальным сообщениям и даёт подтверждение с датой и message_id.

ПРОДАЖИ

4. ИИ-отдел продаж из личных переписок

Определять лидов, намерение купить, бюджет, возражения и следующий шаг. Строить воронку из Telegram-чатов, предлагать персональный следующий контакт и фиксировать движение сделки.

ПОИСК СПРОСА

5. Поиск горячих сигналов

Мониторить выбранные группы и каналы на фразы вроде «ищу подрядчика», «кто умеет внедрить ИИ», «посоветуйте сервис». Собирать подходящие сигналы в отдельную папку входящих для дальнейшей ручной или согласованной обработки.

ИССЛЕДОВАНИЕ TELEGRAM

6. Искать информацию по Telegram

Искать по вашим чатам и доступным Telegram-данным, а где API позволяет, использовать глобальный поиск. Отдельно искать сообщения, ссылки, документы, голосовые сообщения, каналы и публичные посты.

ПУБЛИЧНЫЙ ПОИСК

7. Исследовать публичные каналы

Искать публичные посты по теме технически возможно, но перед обработкой их содержимого ИИ нужно отдельно проверить правила Telegram и допустимость такого использования. Не превращай публичный поиск в массовый сбор данных для ИИ. Для некоторых сценариев глобального поиска Telegram также может применять отдельные лимиты или оплату звёздами Telegram.

БАЗА ЗНАНИЙ

8. Превратить Telegram в базу знаний

Собирать выбранные переписки, документы, голосовые сообщения и ссылки в Markdown, JSONL или SQLite, строить индекс и давать агенту долговременный поиск по вашему контексту в Telegram.

АНАЛИЗ СТОРИС

9. Анализировать сторис

Получать доступные сторис и их метаданные. Перед передачей чужих фото, видео или текста в ИИ-модель проверять, разрешена ли такая обработка. Для собственных сторис или контента, где есть необходимое разрешение, ИИ может извлекать темы, предложения и повторяющиеся схемы, а для собственных сторис или управляемых каналов использовать доступные просмотры, реакции, репосты и другую метрику API.

СОЗДАНИЕ СТОРИС

10. Создавать и публиковать сторис

ИИ может придумать тему, написать сценарий, сгенерировать изображение или видео через подключённые инструменты, подготовить подпись и после проверки опубликовать сторис от пользователя или канала, если Telegram разрешает это для выбранного аккаунта или канала.

ПОИСК ПО СТОРИС

11. Искать публичные сторис по сигналам

Telegram API поддерживает поиск публичных сторис по хэштегу и местоположению. Агент может превратить это в исследовательский навык: искать события, места, локальные сигналы или контент вокруг нужной темы.

УПРАВЛЕНИЕ КАНАЛОМ

12. Управлять своим Telegram-каналом

Анализировать историю канала, строить контент-план, готовить посты и медиа, публиковать по правилам, проверять результат, работать со связанным обсуждением и автоматизировать регулярные операции в пределах админских прав.

КОНТЕНТ

13. Контент-завод внутри Telegram

Находить лучшие старые посты, комментарии и вопросы аудитории, вытаскивать идеи, превращать один материал в серию постов, сторис, ответы на частые вопросы, лид-магниты и ответы для сообщества.

МОНИТОРИНГ

14. Мониторить каналы, темы и конкурентов

Следить за выбранным списком разрешённых источников и сохранять новые публикации. Если содержимое планируется анализировать ИИ, сначала проверить допустимость такой обработки. Для собственных каналов, тестовых данных или источников с необходимым разрешением агент может делать смысловое сравнение изменений и ежедневную сводку.

СОЗДАНИЕ БОТОВ

15. Создавать Telegram-ботов под задачу

Codex / Claude Code проектирует архитектуру, пишет код, подключает Bot API, базы данных, языковые модели, вебхуки, платежи или мини-приложение Telegram, развёртывает и тестирует. Telegram также поддерживает управляемых ботов через MTProto для специально настроенного управляющего бота.

ОБСЛУЖИВАНИЕ БОТОВ

16. Самому обслуживать своих ботов

Агент читает журналы, чинит обработчики, добавляет команды, обновляет промпты, проверяет вебхуки, перезапускает сервисы, проводит регрессионные тесты и затем через пользовательский Telethon-аккаунт проверяет результат снаружи.

ИИ-АГЕНТЫ

17. Запускать автономных ИИ-агентов в Telegram

Telegram становится интерфейсом и каналом действий агента: пользователь пишет задачу, агент работает с инструментами, API и базой данных, затем возвращает результат, файл или подтверждённое действие обратно в Telegram.

TELEGRAM BUSINESS

18. ИИ-секретарь для бизнес-аккаунта

Для доступных Telegram Business сценариев бот может работать через подключение бизнес-аккаунта с выданными правами. На этом строятся поддержка, первичная квалификация, ответы и операционные помощники, не отдавая боту неограниченные права.

СООБЩЕСТВО

19. ИИ-менеджер сообщества

Собирать повторяющиеся вопросы, делать ответы на частые вопросы, искать токсичные или критические сигналы, находить темы, на которые не ответили, готовить ответы и сводки для команды модерации.

ФАЙЛЫ + ГОЛОСОВЫЕ

20. Работать со всем медиаслоем

Находить документы, фото, видео и голосовые, скачивать их, расшифровывать голосовые сообщения, извлекать факты из PDF и складывать результаты в проектную базу знаний.

АВТОМАТИЗАЦИЯ

21. Связывать Telegram с n8n, CRM, БД и API

Сообщение или событие в Telegram может запускать сценарий автоматизации: создать лид, обновить CRM, поставить задачу, вызвать языковую модель, сформировать документ, запустить генерацию контента или вернуть результат пользователю.

ЕЖЕДНЕВНАЯ СВОДКА

22. Личный ежедневный брифинг

Утром агент собирает только значимые изменения: новые важные сообщения, незакрытые договорённости, горячие лиды, упоминания нужных тем, изменения в каналах и список приоритетных ответов.

ТЕСТИРОВАНИЕ

23. Тестировать всю Telegram-систему как человек

Telethon-аккаунт выступает внешним пользователем: пишет боту, нажимает сценарий, загружает файл, ждёт ответ, сравнивает фактический результат с ожидаемым и сохраняет message_id как подтверждение.

ФАБРИКА НАВЫКОВ

24. Создавать новые навыки Telegram по запросу

Появилась новая задача? Не ищите готовый скрипт. Скажите: «создай навык, который делает X». Агент сам изучает доступный API, реализует минимальный инструмент, добавляет правила безопасности, быструю проверку, документацию и подключает его в ваш постоянный набор инструментов Telegram.

Поэтому «почти что угодно» здесь означает не магию. Если действие разрешено Telegram API и ваш аккаунт или бот имеет нужные права, агент-программист способен построить вокруг него повторно используемый инструмент. Если прямого метода нет, агент должен честно показать ограничение, а не имитировать результат.

Весь практикум

0. Новичку: что здесь происходит и что понадобится 1. Что мы реально даём ИИ-агенту 2. 24 кейса: CRM, сторис, каналы, боты, поиск, автоматизации 3. Что делаешь ты, а что ИИ 4. Подключаем Telegram к Codex / Claude Code 5. Практика: 4 задания от простого к полезному 6. Главный промпт для ИИ-агента 7. Навыки Telegram для ИИ + фабрика навыков 8. Готовые промпты для рабочих задач 9. Четыре правила безопасности 10. Как понять, что всё готово

3. Ты делаешь 3 вещи. ИИ делает всё остальное.

Схема 03

Человек даёт доступ, вводит секреты локально и подтверждает внешние действия. Вся техническая работа остаётся у ИИ.

ТЫТолько чувствительные шаги

получаешь API ID и API HASH на my.telegram.org;
вводишь номер, код Telegram и двухэтапную защиту локально, когда ИИ попросит;
подтверждаешь действия, которые реально отправляют что-то другим людям.

ИИВся техника

проверяет компьютер или сервер и Python;
создаёт изолированное окружение;
ставит Telethon и зависимости;
создаёт безопасный файл авторизации;
пишет все скрипты и инструменты;
ищет чаты и пользователей;
читает, ищет, скачивает и экспортирует;
отправляет с контрольным перечитыванием;
тестирует ботов и ИИ-агентов;
анализирует и публикует сторис;
работает с каналами и публичным поиском;
строит CRM и автоматизации;
создаёт новые навыки под новые задачи;
чинит ошибки и поддерживает всё дальше.

Нормальный результат: после настройки вы больше не открываете документацию Telethon. Пишете ИИ: «собери CRM из этих чатов», «проанализируй сторис», «найди всё по теме в Telegram», «подготовь и опубликуй пост в мой канал», «создай нового бота», «сделай новый навык под эту задачу».

4. Подключаем Telegram к Codex / Claude Code

Схема 04

Первое подключение проходит пошагово: API-доступ → локальный ввод → защищённая session → «Избранное» → тестовое сообщение и проверка.

Это единственная часть, где от тебя нужны ручные действия.

Получить API ID и API HASH

Открой my.telegram.org, зайди в раздел для разработки API и создай приложение. Сохрани api_id и api_hash. Не кидай их в общий чат.

Открыть агента-программиста

Подойдёт любой ИИ, у которого есть доступ к терминалу и файлам: Claude Code, Codex, ZCode, OpenCode или другой исполняющий агент.

Отдать ему главный промпт ниже

ИИ сам проверит среду, поставит зависимости, создаст нужные файлы и доведёт до авторизации.

Ввести секреты локально

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

ИИ обязан доказать, что подключение работает

Минимальная проверка: определить твой аккаунт, открыть Избранное, отправить уникальный тест, получить message_id, перечитать сообщение по этому идентификатору и подтвердить точное совпадение.

После пункта 5 настройка закончена. Все следующие задачи ты отдаёшь ИИ обычным текстом.

✅ Checkpoint 1 — Telegram реально подключёнНе достаточно увидеть «авторизация успешна». Агент должен показать твой аккаунт, отправить тест только в «Избранное», получить message_id, перечитать сообщение по этому ID и подтвердить точное совпадение.

5. Практика для новичка: 4 задания

Схема 05

Четыре маленьких результата подряд: подключение → чтение переписки → мини-CRM → собственный повторно используемый навык.

Не просто прочитай гайд. Сделай четыре маленьких результата подряд. После них ты уже поймёшь принцип и сможешь строить свои сценарии.

Важно: первые три задания работают в режиме чтения или через «Избранное». Мы специально не начинаем с отправки сообщений другим людям.

Практика 1. Подключить Telegram и доказать, что всё работает

Цель: ИИ-агент сам настраивает Telethon и проводит безопасную проверку через «Избранное».

Что делаешь ты: вставляешь промпт ниже в Codex или Claude Code. Если понадобится авторизация, вводишь чувствительные данные только локально.

Первое подключение.

Я новичок в вайбкодинге. Подключи мой Telegram к своей рабочей среде через Telethon.

Работай сам: проверяй среду, создавай файлы, устанавливай зависимости, запускай команды и исправляй ошибки. Не заставляй меня писать код или выполнять команды вручную, если ты можешь сделать это сам.

От меня запрашивай только действия, которые нельзя безопасно выполнить без меня: получение api_id/api_hash, ввод номера телефона, кода Telegram и пароля двухэтапной защиты.

Секреты не проси вставлять в обычный чат. Подготовь безопасный локальный ввод.

После авторизации обязательно докажи, что подключение работает:
1. Определи мой аккаунт.
2. Открой «Избранное».
3. Отправь туда уникальную тестовую фразу.
4. Сохрани message_id.
5. Перечитай сообщение по message_id.
6. Сравни текст.
7. Только после точного совпадения скажи, что подключение готово.

В конце объясни результат простыми словами: что ты настроил, где локально хранится файл авторизации без показа его содержимого и какой message_id получен.

Готово, если: агент показал твой аккаунт, отправил тест только в «Избранное», получил message_id и сам перечитал это сообщение.

Практика 2. Прочитать реальную переписку и сделать сводку

Цель: увидеть, что ИИ действительно читает Telegram, а не работает с текстом, который ты вручную скопировал.

Только чтение.

Используй уже подключённый Telegram.

Для первой практики используй «Избранное», тестовый чат или чат, где участники согласны на такую обработку ИИ.

Найди чат [ВСТАВЬ НАЗВАНИЕ ИЛИ @USERNAME]. Ничего туда не отправляй.

Сначала точно определи нужный чат и покажи мне, что нашёл правильный.

До передачи содержимого сообщений в ИИ проверь, что такой сценарий обработки допустим для выбранного чата. Если нет, остановись и объясни причину.

После этого прочитай последние 30 сообщений и дай:
1. Короткое резюме.
2. Главные темы.
3. Договорённости.
4. Вопросы без ответа.
5. Следующие действия, если они прямо следуют из переписки.

Для каждого важного вывода сохрани дату и message_id исходного сообщения.

Если данных недостаточно, так и напиши. Ничего не выдумывай.

Готово, если: в ответе есть факты из реальной переписки и ссылки на источники через даты и message_id.

Практика 3. Сделать мини-CRM из одного чата

Цель: получить первый полезный бизнес-результат, а не просто технический тест.

Первая польза для бизнеса.

Возьми тестовый чат, «Избранное» или чат, где разрешена такая обработка ИИ: [ВСТАВЬ ЧАТ ИЛИ @USERNAME]. Собери по нему одну тестовую карточку CRM.

Сначала проверь, что содержимое этого чата допустимо передавать в ИИ для выбранной задачи. Работай только с подтверждёнными данными из переписки. Ничего не отправляй собеседнику.

Поля карточки:
- имя или название;
- username или другой подтверждённый идентификатор;
- кто это и контекст общения;
- что обсуждаем;
- стадия общения или сделки, только если её можно определить из сообщений;
- мои обещания;
- обещания второй стороны;
- последний важный контакт;
- следующий шаг;
- дедлайн, если он реально указан;
- сумма, если она реально обсуждалась;
- источники: message_id и дата для ключевых фактов.

Сохрани карточку в SQLite или в уже существующую базу проекта. Потом покажи мне её простым человеческим языком и отдельно перечисли поля, которые остались неизвестными.

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

Практика 4. Попросить ИИ самому создать новый навык

Цель: почувствовать главную идею практикума. Ты не ищешь готовую интеграцию, а просишь агента расширить свои возможности.

Первый свой навык.

Создай для себя новый повторно используемый навык Telegram с именем telegram_chat_digest.

Что он должен делать:
1. Принимать чат и количество последних сообщений.
2. Точно находить нужный чат, не угадывая ID.
3. Читать только указанное количество сообщений.
4. Возвращать короткую сводку, решения, задачи и вопросы без ответа.
5. Для важных выводов сохранять дату и message_id.
6. Ничего не отправлять в Telegram.

Сначала проверь существующие инструменты и не дублируй то, что уже есть.

Сам создай нужный код и файлы, добавь правила безопасности, протестируй навык на безопасном чате или «Избранном» и покажи результат теста.

После этого вызови новый навык ещё раз на другом количестве сообщений, чтобы доказать, что он повторно используется.

Готово, если: агент создал постоянный навык, сам его протестировал и смог вызвать повторно без написания нового одноразового скрипта.

Если что-то сломалось: промпт спасения

Не копайся в ошибке сам. Отдай диагностику агенту.

Когда агент застрял или выдал ошибку.

Я новичок. Не перекладывай на меня техническую диагностику.

Сам изучи фактическую ошибку, журналы, текущие файлы, окружение и состояние Telegram-подключения. Найди первопричину и попробуй безопасно исправить её своими инструментами.

Не проси меня вручную запускать команды, редактировать код или искать файлы, если у тебя есть доступ к терминалу и файловой системе.

Не удаляй рабочий файл авторизации и не проходи повторную авторизацию без доказанной необходимости.

Если без моего действия продолжить невозможно, остановись и попроси только одно конкретное действие простыми словами: что мне сделать, где это сделать и зачем это нужно.

После исправления повтори тот тест, который раньше падал, и покажи фактический результат.

После этих четырёх заданий можно идти в реальные проекты. Например: ежедневный секретарь, CRM по 20 клиентам, анализ сторис, мониторинг каналов, создание бота или связка Telegram с n8n.

Отметь четыре результата руками0/4

Telegram подключён и первый тест подтверждён через message_id + readback.
ИИ прочитал разрешённую переписку и дал сводку с источниками.
Создана первая CRM-карточка без выдуманных данных.
ИИ создал повторно используемый Telegram-навык и вызвал его второй раз.

6. Главный промпт: «сделай Telegram своей рабочей средой»

Вставь этот промпт агент-программист. Он должен сам выполнить всё, что может выполнить без твоих секретов, и запрашивать у тебя только неизбежные ручные шаги.

Можно также выделить текст вручную.

Ты - мой исполняющий агент-программист: Codex, Claude Code или другой агент с доступом к терминалу и файлам. Твоя задача: безопасно превратить Telegram в постоянную рабочую среду для ИИ.

ГЛАВНЫЙ ПРИНЦИП
Мне не нужно изучать Telethon, MTProto, Bot API и писать код руками. Ты сам выбираешь нужный инструмент Telegram, пишешь и тестируешь код, создаёшь повторно используемые инструменты и навыки и обслуживаешь их дальше. От меня нужны только чувствительные действия и бизнес-решения, которые нельзя безопасно делегировать.

КОНЕЧНАЯ ЦЕЛЬ
После настройки Telegram должен стать для тебя полноценной рабочей средой в пределах прав моего аккаунта и Telegram API. Я должен уметь обычным языком попросить тебя:
- найти чат, человека, канал, сообщение, файл, ссылку, голосовое сообщение или публичную информацию;
- прочитать и проанализировать переписку;
- построить CRM из выбранных Telegram-диалогов и автоматически поддерживать её в актуальном состоянии;
- найти лидов, обещания, задачи, договорённости и нужные повторные контакты;
- анализировать доступные сторис и их метрики;
- подготовить и опубликовать сторис после моего подтверждения;
- анализировать, отслеживать и обслуживать мои Telegram-каналы;
- искать публичные посты и доступные публичные сторис через поддерживаемые методы поиска Telegram;
- создать Telegram-бота или новую ИИ-функцию для существующего бота;
- подключить Bot API, Telegram Business, управляемых ботов или MTProto, если конкретная задача этого требует;
- связать Telegram с n8n, CRM, SQLite, Postgres, REST API, вебхуками, ИИ-моделями и другими сервисами;
- протестировать Telegram-бота или ИИ-агента как реальный пользователь;
- создать НОВЫЙ навык Telegram, если нужной возможности ещё нет.

НЕ ОГРАНИЧИВАЙСЯ TELETHON
Telethon является базовым слоем работы от имени пользовательского аккаунта, но не обязан быть единственным инструментом. Для каждой задачи выбери минимально правильный путь: Telethon/MTProto, Bot API, Telegram Business, управляемые боты, локальный модуль, REST-сервис, вебхук или сочетание инструментов. Не усложняй архитектуру без причины.

ЧТО ТЫ ДЕЛАЕШЬ САМ
1. Определи ОС, доступные среды выполнения, Python, менеджер пакетов, текущий проект, доступные компоненты Telegram, сервер и уже существующие вспомогательные модули.
2. Не ломай рабочее окружение и не дублируй существующие инструменты.
3. Установи совместимую стабильную Telethon 1.x, если работа от имени пользовательского аккаунта ещё не настроена, и нужные зависимости.
4. Создай минимальный повторно используемый слой инструментов Telegram, а не набор одноразовых скриптов.
5. Секреты и файлы авторизации добавь в .gitignore, выставь минимальные права доступа, не печатай значения.
6. Никогда не проси api_hash, код входа, пароль двухэтапной защиты, токен бота, .session или StringSession в обычном чате. Подготовь безопасный локальный ввод или хранилище секретов.
7. Если api_id/api_hash ещё нет, дай короткую инструкцию: my.telegram.org -> раздел для разработки API -> создать приложение.
8. Проведи авторизацию, проверь is_user_authorized() и get_me().
9. Выполни обязательную быструю проверку через «Избранное»: уникальный текст -> отправка -> message_id -> контрольное чтение по ID -> точное сравнение текста.
10. Только после успешного подтверждения считай работу от имени пользовательского аккаунта настроенной.

СОЗДАЙ БАЗОВЫЙ НАБОР ИНСТРУМЕНТОВ TELEGRAM ДЛЯ ИИ
Нужны логические возможности:
- telegram_health
- telegram_find
- telegram_read
- telegram_search_global
- telegram_export
- telegram_files
- telegram_send_safe
- telegram_stories
- telegram_channels
- telegram_crm
- telegram_bot_factory
- telegram_business
- telegram_monitor
- telegram_automation
- telegram_e2e_test
- telegram_skill_factory

Если среда поддерживает собственный формат навыков, используй штатный формат этой среды. Если нет, создай TELEGRAM_AI_SKILL.md и компактный повторно используемый интерфейс командной строки или API. Каждая возможность должна иметь понятные входы и выходы, ограниченное выполнение, проверку результата, подтверждение факта и восстановление после ошибки.

ФАБРИКА НАВЫКОВ
Это обязательная способность. Если я прошу действие в Telegram, которого нет в текущем наборе инструментов:
1. Сначала проверь, существует ли уже подходящий вспомогательный модуль или метод Telegram API.
2. Проверь реальные права и ограничения и не обещай невозможное.
3. Спроектируй минимальный новый навык.
4. Реализуй его сам.
5. Добавь правила безопасности и разумные пределы выполнения.
6. Проведи быструю проверку на безопасной цели.
7. Зафиксируй критерий готовности и способ восстановления после ошибки.
8. Подключи навык к общему набору инструментов Telegram.
9. После этого выполни исходную бизнес-задачу.

CRM НА БАЗЕ ИИ
Создай возможность, которая по моему запросу берёт выбранные переписки и поддерживает структурированную CRM: контакт, имя пользователя / ID, последнее взаимодействие, краткое содержание, стадия, тема или проект, обещания сторон, следующий шаг, дедлайн, сумма сделки если она явно есть в сообщениях, источник, message_id и дата. Не выдумывай отсутствующие поля. CRM может храниться в SQLite или существующей БД проекта.

СТОРИС
Умей получать доступные сторис, скачивать медиа, передавать контент в подключённые модели анализа изображений и аудио, собирать доступные метрики моих сторис или сторис управляемых каналов, искать публичные сторис только через поддерживаемые Telegram механизмы, а также публиковать и редактировать сторис, когда аккаунт или канал и права это позволяют. Любая публикация наружу должна соответствовать установленным правилам подтверждения.

КАНАЛЫ
Для моих каналов и групп умей читать историю, искать, анализировать, готовить контент, работать с медиа и выполнять разрешённые администраторские операции. Не пытайся выполнять действие, если у аккаунта нет нужных прав. Публикации и разрушительные администраторские действия должны иметь отдельное подтверждение.

СОЗДАНИЕ И ОБСЛУЖИВАНИЕ БОТОВ
По запросу умей создать новый проект бота или расширить существующий: архитектура, Bot API или MTProto, обработчики, языковая модель и инструменты, хранилище, вебхуки, развёртывание, проверка работоспособности, журналы и сквозное тестирование. Если сценарий подходит под управляемых ботов Telegram и управляющий бот имеет нужное разрешение, можешь использовать официальный механизм управляемых ботов. Иначе используй обычный путь через BotFather и Bot API без обхода ограничений Telegram.

ПОИСК И ИССЛЕДОВАНИЕ
Умей искать по конкретным чатам и глобально через доступные методы поиска Telegram. Для публичных постов и сторис учитывай реальные ограничения, лимиты и возможную оплату звёздами Telegram. Результат исследования должен сохранять чат или канал, message_id или сторис_id, дату и ссылку или другой источник, где это возможно.

МОНИТОРИНГ
Создай безопасный пошаговый режим: помнить отметку последней обработки и забирать только новые данные из явно выбранных источников. Никакого бесконечного полного сканирования аккаунта. Из новых данных формировать уведомления и сводки по моим правилам.

АВТОМАТИЗАЦИЯ
Умей связывать события и действия Telegram с n8n, REST API, базами данных, CRM и другими инструментами. Используй защиту от повторного выполнения, журнал действий без секретов, лимиты запросов, правила повторной попытки и подтверждение результата.

ПРАВИЛО ОБРАБОТКИ ДАННЫХ TELEGRAM С ПОМОЩЬЮ ИИ
Перед тем как передавать содержимое Telegram-сообщений, каналов, сторис, файлов или других пользовательских данных в ИИ-модель:
1. Проверь, разрешён ли такой сценарий текущими условиями Telegram и применимыми правилами приватности.
2. Не используй массовый сбор публичных каналов, групп или сторис для обучения, развития, оценки или развёртывания ИИ.
3. Для чужих личных данных и переписок требуй необходимое явное согласие, ограниченное конкретным контентом и контекстом.
4. Если нужного согласия или основания нет, не передавай содержимое в ИИ-модель. Предложи безопасный вариант без ИИ или работу на тестовых/собственных данных.
5. Не считай техническую доступность данных разрешением на их обработку ИИ.

ОБЯЗАТЕЛЬНЫЕ ПРАВИЛА
- Не угадывай chat_id, username, сущность или права. Находи и проверяй фактически.
- Чтение и поиск по умолчанию ограничены: лимит сообщений, диапазон дат, выбранные источники.
- Сохраняй подтверждение: чат, message_id/story_id, дату, отправителя или источник, когда применимо.
- Внешняя отправка: найти точного адресата -> получить требуемое подтверждение -> отправить один раз -> сохранить ID -> перечитать и проверить.
- Неизвестный результат -> сначала выяснить, произошло ли действие, и только потом решать, нужна ли повторная попытка. Не создавать дубли.
- Учитывай FloodWait и ограничения частоты запросов.
- Не делай массовую рассылку и спам-автоматизацию.
- Не обходи ограничения Telegram.
- Секреты, файлы авторизации и токены никогда не печатай и не коммить.
- Если действие технически недоступно, честно объясни конкретную причину и не имитируй успех.

ФИНАЛЬНАЯ ПРОВЕРКА
Перед завершением проверь минимум:
- пользовательский аккаунт авторизован;
- быстрая проверка через «Избранное» прошла с message_id и контрольным чтением;
- поиск чатов, чтение и поиск сообщений работают;
- хотя бы одна выгрузка или работа с файлом проверена;
- навык сторис умеет безопасно определить доступность сторис;
- навык каналов умеет фактически определить права на выбранном тестовом канале или сообщает, что их нет;
- навык CRM создаёт одну тестовую карточку из реального выбранного диалога без выдуманных данных;
- инструменты повторно вызываются;
- фабрика навыков способна добавить новую безопасную возможность без ручного написания кода мной.

В КОНЦЕ ДАЙ МНЕ КОРОТКИЙ ОТЧЁТ
1. Что подключено.
2. Где хранятся файлы авторизации и токены без вывода их содержимого.
3. Какие возможности Telegram доступны.
4. Какие быстрые проверки прошли и какие идентификаторы подтверждения получены.
5. Какие действия требуют моего подтверждения.
6. 15 примеров бизнес-команд, которые я теперь могу давать обычным языком.

Не учи меня внутренностям Telegram API, если это не нужно для решения конкретной проблемы. Делай сам, проверяй сам, расширяй набор инструментов сам, показывай результат и доказательство.

7. Навыки Telegram: постоянный набор инструментов агента

Схема 06

Новая бизнес-задача превращается не в одноразовый скрипт, а в проверенный навык, который остаётся у агента и используется снова.

Навыки здесь не уроки. Это постоянные способности Codex / Claude Code. Базовые создаются один раз, новые агент добавляет по мере появления задач.

1. `telegram_health`

Авторизация и диагностика

Проверяет файл авторизации, аккаунт, соединение, версии, конфигурацию и объясняет реальную причину проблемы без утечки секретов.

2. `telegram_find`

Сущности и адресаты

Находит точного пользователя, чат, группу, канал или бота и не позволяет другим навыкам работать с угаданным адресатом.

3. `telegram_read`

История и контекст

Читает ограниченную историю, ветки и ответы, собирает данные об источнике и отдаёт данные для анализа агенту.

4. `telegram_search_global`

Исследование Telegram

Ищет по чатам и использует доступные механизмы глобального поиска для публичных каналов, постов и сторис с учётом лимитов.

5. `telegram_export`

Данные и база знаний

Строит воспроизводимые выгрузки в Markdown, JSONL и SQLite с данными о сообщениях и отметкой последней обработки.

6. `telegram_files`

Медиа

Ищет и скачивает документы, фото, видео, голосовые сообщения; проверяет целостность файлов; может передавать их другим ИИ-инструментам на транскрибацию и анализ.

7. `telegram_send_safe`

Проверенная отправка

Найти точного адресата -> получить подтверждение -> отправить один раз -> сохранить ID -> контрольное чтение. Защита от дублей и неизвестного результата.

8. `telegram_stories`

Анализ и публикация сторис

Получает доступные сторис, медиа и метрики, анализирует через инструменты для изображений и аудио, ищет публичные сторис поддерживаемым способом и публикует или редактирует сторис при наличии прав.

9. `telegram_channels`

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

Читает и анализирует канал, проверяет права администратора, готовит/публикует контент и выполняет только разрешённые операции.

10. `telegram_crm`

CRM на базе ИИ

Сам поддерживает карточки контактов и сделок из реальных переписок: краткое содержание, стадия, обещания, следующий шаг, дедлайн и подтверждение источником.

11. `telegram_bot_factory`

Создание и обслуживание ботов

Проектирует, пишет код, развёртывает и тестирует Telegram-ботов. Использует Bot API, MTProto или механизм управляемых ботов по реальной задаче.

12. `telegram_business`

подключение бизнес-аккаунта

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

13. `telegram_monitor`

Пошаговый мониторинг

Следит только за выбранными источниками, хранит отметку последней обработки, забирает новое и формирует уведомления и сводки без полного повторного сканирования.

14. `telegram_automation`

n8n / CRM / API / базы данных

Превращает Telegram-события в сценарии автоматизации и возвращает результаты обратно, с журналом действий, защитой от повторов и правилами повторной попытки.

15. `telegram_e2e_test`

Тестирование реальным аккаунтом

Тестирует ботов и ИИ-агентов снаружи: реальные сообщения, кнопки, файлы, ожидание результата и подтверждение результата.

16. `telegram_skill_factory`

Главный навык для создания новых навыков

Сам создаёт новые навыки Telegram. Проверяет API и права, пишет минимальный инструмент, добавляет правила безопасности, тестирует, документирует и подключает к общему набору инструментов.

Это ключевой сдвиг: вы не ждёте, пока кто-то выпустит интеграцию. Говорите агенту, какой результат нужен, и он создаёт недостающий Telegram-инструмент сам.

Для уже подключённого Telegram.

У меня уже есть рабочий набор инструментов Telegram. Сделай его расширяемой фабрикой навыков.

Базовые возможности:
telegram_health, telegram_find, telegram_read, telegram_search_global, telegram_export, telegram_files, telegram_send_safe, telegram_stories, telegram_channels, telegram_crm, telegram_bot_factory, telegram_business, telegram_monitor, telegram_automation, telegram_e2e_test, telegram_skill_factory.

Не переписывай рабочие вспомогательные модули. Сначала проведи инвентаризацию существующего набора инструментов.

Для каждого нового запроса по Telegram, который текущие инструменты не умеют выполнять:
1. Найди официальный метод Telegram API или честно установи отсутствие нужного API.
2. Проверь права, ограничения и лимиты частоты запросов.
3. Создай минимальный повторно используемый навык.
4. Опиши входные и выходные данные.
5. Добавь правила безопасности и защиту от повторного выполнения.
6. Протестируй на безопасной цели.
7. Сохрани критерий готовности и способ восстановления после ошибки.
8. Подключи навык к общему набору инструментов.
9. Только затем выполняй исходную задачу.

Никаких выдуманных возможностей, обхода ограничений Telegram, утечки файлов авторизации или токенов и массовых рассылок.

8. Готовые промпты: просто ставьте бизнес-задачу

Это готовые промпты. Копируй, меняй значения в квадратных скобках и отправляй своему агенту-программисту после подключения.