Вы хотите бота, который принимает заявки, но список «кнопки, сообщения, администратор» ещё не объясняет, что произойдёт при отмене или повторном подтверждении. Промпты для архитектуры Telegram-бота помогают превратить описание задачи в понятный план диалога, данных и компонентов. Такой план можно проверить на вымышленных разговорах и передать разработчику для оценки.
Промпты для архитектуры Telegram-бота: какой результат заказывать
Архитектура в этой статье — описание частей будущего бота и их взаимодействия. Например: Telegram передаёт сообщение вашему обработчику, тот определяет текущий шаг пользователя, проверяет введённое и сохраняет подтверждённую заявку. Названия технологии и базы данных имеют смысл после того, как понятно, что именно нужно сохранять и кто будет обслуживать процесс.
В документации Telegram BotFather описан как инструмент создания и управления ботом. Регистрация даёт учётную запись, но сама по себе не реализует приём заявок. Для подготовки плана токен бота не нужен: его не следует передавать в промпте.
Возьмём учебную задачу: сотрудник сообщает о неисправности офисного оборудования, ответственный получает заявку и обновляет её статус. Для первой версии ограничим вход помещением и текстом проблемы. Фотографию можно добавить отдельным требованием, если она обязательна для процесса; тогда нужно определить доступ, срок хранения и действия при неподходящем файле.
Подготовьте короткий бриф:
| Что решить | Пример для ремонтных заявок |
|---|---|
| Пользователи | Сотрудник создаёт заявку; ответственный принимает и закрывает |
| Результат одного прохода | Подтверждённая запись с номером, помещением и описанием |
| Обязательные данные | Код помещения из списка, описание неисправности |
| Границы первой версии | Без оплаты, CRM, фотографий и свободных ИИ-ответов |
| Ответ сотруднику | Номер заявки и текущий рабочий статус |
| Открытые решения | Кто дежурит, что делать при задержке, сколько хранить данные |
Если вы не знаете технического ответа, запишите вопрос. «Срок хранения не согласован» полезнее случайного числа, которое модель потом включит в план как утверждённое требование.
Прямой запрос: сначала минимальный состав, потом детали
Вставьте запрос в обычный текстовый чат, подставив свой бриф. Он должен вернуть документ для обсуждения, а не немедленно создавать код большого проекта.
Помоги подготовить архитектуру Telegram-бота для [задача].
Пользователи и их действия: [кто что делает].
Результат одного прохода: [что получаем].
Обязательные данные: [поля и источник допустимых значений].
Границы первой версии: [что включено и что отложено].
Действия сотрудника/администратора: [как принимает и завершает работу].
Неизвестные условия: [список].
Сначала задай вопросы, без которых меняется поведение или доступ к данным.
Не превращай предположения в согласованные решения.
Предложи минимальный достаточный состав и одну альтернативу,
если она действительно влияет на сложность или обслуживание.
Выдай:
1. Путь пользователя и администратора простыми словами.
2. Компоненты: назначение, вход, выход и причина необходимости.
3. Таблицу состояний диалога и переходов, включая ошибки, назад и отмену.
4. Какие данные сохраняются, кому видны и какие решения о хранении открыты.
5. Обычные и неудачные диалоги для проверки.
6. Вопросы разработчику и список принятых/непринятых решений.
Код и запуск пока не нужны. Остановись для согласования плана.
Заполненный первый бриф: «Бот для ремонтных заявок офиса. Сотрудник выбирает помещение из списка и описывает проблему, перед отправкой видит карточку. Ответственный меняет статус. Нужен один незавершённый черновик на сотрудника. Срок хранения и порядок замещения ответственного пока не определены. Без оплаты и CRM».
Минимальный состав может выглядеть так:
| Часть | За что отвечает | Что проверить в плане |
|---|---|---|
| Приём событий Telegram | Передаёт сообщения и нажатия в обработку | Какой способ получения событий выбран |
| Логика диалога | Понимает текущий шаг, проверяет ввод, формирует ответ | Нет ли перехода дальше без нужного поля |
| Хранилище черновика и заявок | Сохраняет незавершённое и подтверждённое | Что происходит после перезапуска и повторного события |
| Рабочее место ответственного | Позволяет принять заявку и отметить результат | Кто имеет доступ и что видит сотрудник |
Это редакторский пример, а не готовая реализация. В Bot API получение через getUpdates и через webhook описано как альтернативы. Webhook — доставка события на адрес обработчика, polling — получение событий запросами обработчика. Для одной небольшой первой версии не нужно требовать оба сразу; окончательный выбор зависит от размещения и эксплуатации, его подтверждает разработчик.
Сравнивайте варианты вопросами о конкретной работе: кто поддерживает запуск, где остаются данные, как обнаруживается сбой и что нужно оплачивать. Большое число сервисов в схеме само по себе не доказывает, что они нужны для вашего сценария. Если сценарий полностью задаётся формой и правилами, нейросеть внутри бота может пока не понадобиться.
Как описать состояния и не потерять заявку
Состояние диалога — место, на котором остановился человек. У сотрудника это может быть выбор помещения; у уже созданной заявки отдельно есть рабочий статус «новая», «в работе» или «закрыта». Эти два списка отвечают на разные вопросы.
Учебная таблица для личной заявки:
| Шаг | Событие | Результат |
|---|---|---|
| Начало | «Новая заявка» | Создать черновик, запросить помещение |
| Помещение | Допустимый код | Сохранить код, запросить описание |
| Описание | Текст прошёл согласованную проверку заполненности | Показать карточку подтверждения |
| Подтверждение | «Назад» | Вернуться к описанию, сохранив помещение |
| Любой шаг черновика | «Отмена» | Удалить черновик, вернуться к началу |
| Подтверждение | «Отправить» | Сохранить заявку один раз, вернуть её номер |
| Отправлено | Повторное подтверждение | Показать номер существующей заявки |
Неподходящий ввод оставляет человека на текущем шаге и объясняет, что исправить. Если сотрудник вернулся на следующий день, сначала предложите продолжить имеющийся черновик или начать новый с подтверждением. Повторная команда начала не должна молча уничтожать уже заполненное.
Критерий подходящего описания определяет владелец процесса. Для учебной первой версии примем минимальное правило: после удаления пробелов текст не пуст. Поэтому «не работает» пройдёт проверку заполненности, хотя ответственный, возможно, попросит уточнить оборудование и симптом. Бот по этому правилу не оценивает смысл. Если такого качества недостаточно, добавьте отдельный обязательный выбор оборудования и отдельное описание проблемы; это изменение брифа и сценария, а не скрытое «понимание» формы.
Пример проверки на бумаге — вымышленные сообщения и ожидаемые действия:
| Шаг и вход | Ответ бота | Что сохраняется | Следующий шаг |
|---|---|---|---|
| Начало: «Новая заявка» | «Выберите помещение» | Новый черновик | Помещение |
| Помещение: «A-12» из списка | «Опишите проблему» | Помещение A-12 | Описание |
| Описание: только пробелы | «Введите описание; сейчас поле пустое» | Помещение остаётся, описания ещё нет | Описание |
| Описание: «Принтер зажёвывает лист» | Карточка с помещением и текстом | Оба значения в черновике | Подтверждение |
| Подтверждение: «Назад» | «Исправьте описание» | Помещение и прежний текст доступны | Описание |
| Исправленный текст, затем «Отправить» | После сохранения — номер R-101 | Одна подтверждённая заявка | Отправлено |
| Повторное «Отправить» | «Заявка R-101 уже создана» | Новая запись не добавляется | Отправлено |
В предпоследней строке пользователь ещё раз видит исправленную карточку и подтверждает её. Номера и сообщения здесь условные: это проверка плана, а не наблюдение работающего бота.
Ниже — учебный код переходов, написанный редактором, а не результат запуска промпта. Он показывает только смену шага после проверки входа. Это не обработчик Telegram: здесь нет сохранения полей, отправки сообщений и записи заявки.
def next_state(state, event):
if event == "cancel" and state != "sent":
return "start"
if event == "back":
return {"room": "start", "problem": "room",
"confirm": "problem"}.get(state, state)
transitions = {
("start", "begin"): "room",
("room", "valid_room"): "problem",
("problem", "valid_problem"): "confirm",
("confirm", "submit"): "sent",
("sent", "new_request"): "room",
}
return transitions.get((state, event), state)
Например, next_state("confirm", "submit") возвращает sent, а повторный submit уже в sent оставляет тот же шаг. Но одна эта функция не гарантирует отсутствие дублей в реальной системе. В плане разработчик должен связать сохранение заявки и смену состояния, учитывать ID черновика и уже созданную запись, в том числе при одновременной обработке.
Отдельно существует повторная доставка события Telegram. Документация Update описывает update_id, который помогает распознавать такие повторы. Новое нажатие пользователя может быть новым событием, поэтому проверка update_id и защита от второй записи одной заявки решают разные задачи.

По этой схеме можно проверить план на бумаге. Подключение к Telegram, хранение и реальные права доступа требуют отдельной реализации и тестирования.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
300 ₽ на первые запросы
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Начислим при регистрации в Agent ROI.

Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
при регистрации
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту для старта
привязывать не нужно.
при регистрации
На первые запросы
к моделям в Agent ROI
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту для старта
привязывать не нужно.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Попробуйте Grok, ChatGPT,
Gemini, Claude и Perplexity
Эти модели доступны по одной подписке
в Agent ROI.
Начните с бонуса при регистрации.

Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Используйте эти модели в Agent ROI.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
300 ₽ при регистрации
Карту привязывать не нужно.
Используйте эти модели в Agent ROI.
На первые запросы
к моделям в Agent ROI
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Бонус начислим при регистрации.
Карту привязывать не нужно.
300 ₽ на первые запросы
Бонус при регистрации
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Используйте эти модели в Agent ROI.

Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту привязывать не нужно
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Попробуйте Grok, ChatGPT,
Gemini, Claude и Perplexity
Эти модели доступны по одной подписке
в Agent ROI.
Бонус начислим при регистрации.
Карту привязывать не нужно.
при регистрации
Помощник-аналитик: инструкция для следующего уточнения
Если требований много, сохраните правила работы с ними. Вставьте блок первым обычным сообщением в Agent Roi или другой текстовый чат. Это ролевая инструкция помощнику; Telegram не получает её автоматически.
Ты помогаешь мне подготовить план Telegram-бота для разработчика.
Не регистрируй бота, не проси токены и не обещай готовый запуск.
Сначала выясни задачу, роли, один основной путь, обязательные поля,
границы первой версии, действия сотрудника и неизвестные условия.
Предлагай минимальный достаточный вариант; сложность объясняй
через конкретное требование и обслуживание.
Поддерживай согласованный документ:
цель; роли; путь пользователя; компоненты; состояния и переходы;
данные и доступ; ошибки; критерии приёмки; открытые вопросы.
Отделяй мои решения, свои предложения и вопросы разработчику.
Любое новое требование сначала сопоставляй с текущим планом.
Показывай: изменение → затронутые состояния/данные → новые проверки.
Не меняй согласованные части молча и не переходи к коду без просьбы.
В конце этапа выдавай целую актуальную версию и журнал изменений.
Не считай чат, схему или сгенерированный код доказательством работы бота.
Первое задание после инструкции: «Начинаем с бота ремонтных заявок из приведённого брифа. Сначала проверь пробелы: кто принимает заявку, что показываем при отсутствии ответственного, как сотрудник видит результат. Не выбирай срок хранения и платформу за меня. Верни вопросы и минимальный план».
Если вы уже получили разовый план, можно продолжить тот же чат. При переходе к помощнику передайте принятую версию и текущую правку вместо повторного начала. Для нового бота создайте новый бриф; старые роли, поля и правила доступа не переносятся автоматически.
Как принять план и передать разработчику
Проверьте его по нескольким разговорам от начала до конца. Для каждого запишите исходное состояние, вход пользователя, ответ, изменение сохранённых данных и следующий шаг. На бумаге должны проходить как минимум правильная заявка, неверное помещение, пустое описание, возврат, отмена, повторное подтверждение и продолжение черновика после перерыва.
Добавьте путь ответственного: как он узнаёт о новой записи, принимает её, меняет статус и передаёт результат сотруднику. Если он долго не отвечает, бот должен показывать честное состояние заявки и согласованный способ обращения к дежурному. Кто дежурит и через какое время поднимать вопрос — решения владельца процесса, а не значения, которые модель вправе придумать.
Для учебной первой версии выберем простой вариант: при просмотре заявки сотрудник видит «Заявка R-101 ещё не принята. Если вопрос срочный, обратитесь к дежурному: [подтверждённый контакт]» и обращается сам. Контакт заполняет владелец до запуска. Автоматическое уведомление второго сотрудника по таймеру — отдельное требование с получателем и условием срабатывания; в этом варианте оно не заявлено выполненным.
Для данных перечислите поля, цель каждого, круг доступа, момент удаления черновика и правила хранения закрытых заявок. Например, описание проблемы видит ответственный, а один сотрудник не получает чужие заявки. Попросите разработчика подтвердить, как это обеспечивается; кнопка «мои заявки» сама по себе не является проверкой права доступа.
Передайте документ одной версии: бриф, схема компонентов, таблица переходов, поля и доступ, критерии приёмки, примеры диалогов и список нерешённого. Отметьте, что утверждено вами, а что требует технической проверки. Разработчик отдельно подтверждает способ размещения, ограничения платформы, защиту доступа, работу при сбоях и оценку реализации. До этого точные сроки и стоимость остаются предварительными.
При изменении требования просите адресное обновление: «Добавляем обязательное фото. Покажи, какие шаги, поля, проверки и правила хранения изменятся. Остальной путь не переписывай». После согласования сохраните целую новую версию и отличия, чтобы разработчику не пришлось восстанавливать решения по истории чата.
FAQ
Можно ли сразу попросить код?
Можно после согласования поведения и среды. Сначала пусть модель объяснит, какие части ещё отсутствуют: хранение, приём событий, права, отправка ответов, размещение. Учебная функция выше проверяет один фрагмент логики, а не заменяет эти части.
Где потребуется помощь разработчика?
В реализации и проверке внешних соединений, сохранности данных, доступа, восстановления после ошибок и эксплуатации. Владелец процесса может самостоятельно выбрать роли, поля и ожидаемое поведение. Получить уверенный ответ в чате недостаточно, чтобы подтвердить техническую готовность.
Когда добавлять ИИ в самого бота?
Когда есть конкретная задача для модели: например, предложить категорию по свободному описанию с проверкой человеком. Общий выбор сценария разобран в гайде об ИИ для чат-бота. Для отдельных скриптов пригодятся промпты для Python и PowerShell.
Начните в чате Agent Roi с одного пути пользователя и пяти–семи обязательных условий. Получите таблицу переходов и проверьте отмену с повторным подтверждением, прежде чем заказывать реализацию.
Больше материалов по теме — в разделе «Промпты».