Вы хотите бота, который принимает заявки, но список «кнопки, сообщения, администратор» ещё не объясняет, что произойдёт при отмене или повторном подтверждении. Промпты для архитектуры 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-бота: правильный ввод, возврат с сохранением данных, отмена черновика и однократная запись подтверждённой заявки

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

Agent ROI

Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке

Используйте эти модели
в Agent ROI.

Подписку можно оплатить в рублях.

Помощник-аналитик: инструкция для следующего уточнения

Если требований много, сохраните правила работы с ними. Вставьте блок первым обычным сообщением в Agent Roi или другой текстовый чат. Это ролевая инструкция помощнику; Telegram не получает её автоматически.

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

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

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

Любое новое требование сначала сопоставляй с текущим планом.
Показывай: изменение → затронутые состояния/данные → новые проверки.
Не меняй согласованные части молча и не переходи к коду без просьбы.
В конце этапа выдавай целую актуальную версию и журнал изменений.
Не считай чат, схему или сгенерированный код доказательством работы бота.

Первое задание после инструкции: «Начинаем с бота ремонтных заявок из приведённого брифа. Сначала проверь пробелы: кто принимает заявку, что показываем при отсутствии ответственного, как сотрудник видит результат. Не выбирай срок хранения и платформу за меня. Верни вопросы и минимальный план».

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

Как принять план и передать разработчику

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

Добавьте путь ответственного: как он узнаёт о новой записи, принимает её, меняет статус и передаёт результат сотруднику. Если он долго не отвечает, бот должен показывать честное состояние заявки и согласованный способ обращения к дежурному. Кто дежурит и через какое время поднимать вопрос — решения владельца процесса, а не значения, которые модель вправе придумать.

Для учебной первой версии выберем простой вариант: при просмотре заявки сотрудник видит «Заявка R-101 ещё не принята. Если вопрос срочный, обратитесь к дежурному: [подтверждённый контакт]» и обращается сам. Контакт заполняет владелец до запуска. Автоматическое уведомление второго сотрудника по таймеру — отдельное требование с получателем и условием срабатывания; в этом варианте оно не заявлено выполненным.

Для данных перечислите поля, цель каждого, круг доступа, момент удаления черновика и правила хранения закрытых заявок. Например, описание проблемы видит ответственный, а один сотрудник не получает чужие заявки. Попросите разработчика подтвердить, как это обеспечивается; кнопка «мои заявки» сама по себе не является проверкой права доступа.

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

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

FAQ

Можно ли сразу попросить код?

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

Где потребуется помощь разработчика?

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

Когда добавлять ИИ в самого бота?

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

Начните в чате Agent Roi с одного пути пользователя и пяти–семи обязательных условий. Получите таблицу переходов и проверьте отмену с повторным подтверждением, прежде чем заказывать реализацию.

Больше материалов по теме — в разделе «Промпты».