Что включить в задание на Telegram-бота

Одна страница о задаче бизнеса

В начале задания объясните, кому нужен бот и какую конкретную работу он берёт на себя. Не «повысить эффективность», а, например, собрать параметры услуги, показать предварительный расчёт и передать менеджеру готовые вводные. Укажите, что сейчас делает сотрудник и что останется за ним после запуска.

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

Запишите сценарий как короткую историю

Для каждого основного действия перечислите шаги от входа до результата. Что пользователь видит? Что выбирает или вводит? Как система проверяет ответ? Что показывается дальше? Названия кнопок лучше писать сразу: разница между «Продолжить» и «Получить предварительный расчёт» меняет ожидания человека.

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

Разведите функции клиента и сотрудника

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

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

Для каждой интеграции укажите источник и владельца данных

Фразы «подключить таблицу» недостаточно. Запишите, какие поля читаются, что записывается обратно и какая система считается основной. Кто меняет цены? Где хранится статус заявки? Как быстро изменения должны появляться в боте? Если одновременно редактировать данные в нескольких местах, потребуется правило разрешения расхождений.

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

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

Приёмка: сначала доказательства, потом слово «готово»

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

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

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