Через неделю после запуска владелец «Кодиума» пишет: «Бот спрашивает согласие, а нам надо поменять текст. И кому звонить, если он замолчит?» Бот работает, но проект ещё не сдан. Сдан он тогда, когда заказчик понимает, что у него есть, где ключи и что делать без тебя.
Чему научишься в этом уроке:
• собрать комплект передачи: доступы, README, токены на имя владельца;
• написать владельцу инструкцию на одну страницу;
• оформить кейс «задача → решение → цифры» без чужих данных;
• решить, нужна ли заказчику оплата Telegram Stars.
Что принадлежит заказчику
Сравни с ремонтом квартиры. Мастер уходит, а ключи, гарантийные талоны и схема проводки остаются у хозяина. С ботом так же: всё, без чего бот не живёт, должно быть оформлено на заказчика.
- Бот в Telegram. Заказчик создаёт его сам у BotFather или ты передаёшь права владельца. Токен бота вписывается в .env на сервере, а сам токен знает заказчик. Как получить токен у BotFather, показано в уроке трека 2 «Подключение Telegram».
- Яндекс Диск. Файл zayavki.xlsx лежит на Диске заказчика, токен Диска выпущен из его аккаунта, с правами чтения и записи (почему именно так, разобрано в уроке 2.4).
- Сервер. Аккаунт Timeweb на заказчике, оплата с его карты. Тебе он даёт доступ для поддержки.
- Код. Репозиторий в git на заказчике или копия кода ему в руки (урок 1.4). Файл .env в репозиторий не попадает.
Токены и пароли не пересылай в мессенджере открытым текстом. Пусть заказчик сам вставит свои токены в .env на сервере при тебе на созвоне или выпустит новые после передачи. Токен бота после перевыпуска в BotFather старым перестаёт работать. С токеном Яндекс Диска иначе: новый токен старый сам не отключает (кабинет прямо пишет, что существующие токены продолжают работу), поэтому старый, который видел ты, нужно отозвать отдельно. Где это делается в кабинете oauth.yandex.ru, в прогоне не проверяли.
README: инструкция для того, кто придёт после тебя
README (в переводе «прочти меня») это файл в корне проекта, который первым открывает следующий разработчик. Попроси агента написать его по фактическому коду, а потом проверь глазами: что в нём совпадает с тем, что ты сделал.
Напиши README.md для этого проекта по фактическому коду, без выдумок.
Разделы: что делает бот; какие переменные нужны в .env (без значений);
как запустить у себя; как устроена служба на сервере и как её перезапустить;
куда пишутся заявки; что лежит в pending.jsonl и что с ним делать;
что делать, если не удалось скачать файл с Диска.Инструкция владельцу на одну страницу
Владельцу школы не нужен код. Ему нужно знать четыре вещи, и уместить их стоит на одну страницу:
- Где смотреть заявки: уведомление в Telegram и файл zayavki.xlsx в папке Кодиум на Диске.
- Как поменять текст согласия или список курсов: кому написать и сколько это стоит.
- Что делать, если бот замолчал: проверить, оплачен ли сервер, и написать тебе.
- Какие доступы у кого: бот, Диск, сервер, код.
Кейс: задача, решение, цифры
Кейс в портфолио нужен не для красоты. Следующий заказчик спросит «а вы такое делали?», и ответом будет страница из пяти строк. Цифры в ней должны быть настоящими. У тебя они есть с прогона:
- Задача. Заявки школы приходили в личные сообщения и терялись.
- Решение. Telegram-бот: согласие на обработку данных первым шагом, затем имя, телефон, курс кнопками; уведомление владельцу и строка в файле на Яндекс Диске.
- Цифры. Агент собрал и довёл бота за 10 заданий, около 54 минут его работы; расход модели около 0,3 $. Свои ручные часы допиши сам: токены, сервер, проверка в Telegram.
- Надёжность. Бот пережил перезагрузку сервера; старые заявки не теряются при сбое скачивания.
- Демо. Снимок диалога с ботом и уведомления, телефон закрыт.
Чего в кейсе быть не должно: телефонов и имён настоящих учеников, токенов, переписки с заказчиком целиком. Название школы указывай, только если заказчик разрешил.
Деньги: сколько стоит такой бот
Ориентиры рынка на 09.10.2026 честно разные. На FL.ru готовые пакеты «бот для заявок» стоят 2 990 ₽, 3 900 ₽ и 4 550 ₽, это день-два работы: приветствие, меню, сценарий примерно из пяти вопросов, отправка заявки админу. По статье на vc.ru фрилансер берёт около 10 000 ₽, агентство около 150 000 ₽; по другой оценке агентства начинают от 100 000 ₽ за простого бота.
Ориентир курса: 10–30 тысяч ₽ за разработку и 2–5 тысяч ₽ в месяц за поддержку. Это выше биржевого низа. Оправдать разницу можно только тем, что ты продаёшь результат («заявки не теряются, согласие записано, данные на Диске школы»), внедрение и присмотр, а не «бота на aiogram». Это ориентир, а не обещание дохода.
Telegram Stars: если заказчик хочет брать оплату в боте
Telegram Stars (звёзды) это внутренняя валюта Telegram. Для цифровых товаров и услуг внутри бота (доступ к материалу, консультация в чате) Telegram разрешает только звёзды. Подключение коротко: валюта XTR, отдельный платёжный провайдер не нужен.
- Разработчик получает эквивалент 0,013 $ за одну звезду.
- Вывод через сервис Fragment, звёзды становятся доступны к выводу через 21 день. Можно ли выводить жителю России и на каких условиях, мы не проверяли.
- Для офлайн-услуг (запись на занятие, ремонт) звёзды не подходят: там нужна обычная касса, это паттерн П6.
Для «Кодиума» звёзды не нужны: бот принимает заявки, а оплату курса школа берёт своим способом. Предлагай Stars, только если заказчик сам продаёт что-то цифровое прямо в боте.
Контрольный вопрос. Заказчик просит: «Пришли мне токен бота в Telegram, я сохраню». Как поступить?
Подсказка: Вспомни, что делать с токенами, которые видел ты, после передачи.
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Контрольный вопрос. Что можно взять в кейс для портфолио? Отметь всё подходящее.
Выберите все верные варианты.
Подсказка: Кейс показывает результат и цифры, но не раскрывает чужие данные и секреты.
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Контрольный вопрос. Эксперт по йоге продаёт в своём боте запись видеоурока, а владелица парикмахерской хочет предоплату за стрижку. Кому подходят Telegram Stars?
Подсказка: Для каких товаров Telegram требует звёзды и что сказано про офлайн-услуги?
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Задание. МИССИЯ «Сдал и упаковал». 1. Попроси агента написать README.md по заданию урока и проверь его по коду. 2. Напиши инструкцию владельцу на одну страницу: четыре пункта из урока. 3. Оформи кейс своего бота: задача, решение, цифры (расход из кабинета CloseRouter, а если у тебя учебный ключ без кабинета, то число заданий агенту и минуты его работы), надёжность, демо. Сделай в среде: Проверь README чужими руками: склонируй репозиторий в новую папку (git clone) и запусти бота строго по README, ничего не подсказывая себе по памяти. Принято, если: приложены README.md без значений токенов, инструкция владельцу и текст кейса; в кейсе есть хотя бы одна цифра из твоего прогона; в файлах нет телефонов, токенов и адреса сервера; приложен снимок запуска из новой папки и одна строка, что пришлось дописать в README (или «ничего»).
Подсказка: Цифры бери из своей работы: кабинет CloseRouter или история заданий агенту, а не из урока.
✅ Готово, если: программа запускается без ошибок и выводит то, что просят в задании.
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Что дальше
Бот готов и упакован. Но кейс ничего не стоит, пока его некому показать. В следующем уроке ищем первого заказчика и пишем ему первое сообщение.
Итог:
• всё, без чего бот не живёт, оформлено на заказчика, токены у него;
• есть README и инструкция владельцу на одну страницу;
• кейс с настоящими цифрами и без чужих данных; ориентиры цены знаешь с источниками.
