Техническое задание на Telegram-бота должно объяснять, какую задачу выполняет система, кто ей пользуется и что считается успешным результатом. Одного списка кнопок недостаточно: нужно описать переходы, данные, интеграции и поведение при ошибках.
Начните с процесса, который бизнес хочет автоматизировать. Затем разбейте его на проверяемые сценарии. Так проще согласовать объём разработки и принять готовую работу.
Определите задачу и границы первой версии
Опишите текущий процесс: откуда приходят обращения, что уточняет сотрудник, где сохраняются данные и какой следующий шаг получает клиент.
Сформулируйте результат первой версии, например: «Получить заявку на консультацию, сохранить её и передать ответственному менеджеру». Отдельно перечислите функции, которые пока не входят в работу: оплату, бронирование времени, программу лояльности или сложные рекомендации.
Для каждой функции укажите приоритет и зависимость. Если онлайн-запись требует актуального календаря, доступ к нему и правила изменения слотов должны быть согласованы до разработки.
Если выбор интерфейса ещё не сделан, сначала разберите, когда подходит бот, Mini App или сайт. В ТЗ зафиксируйте выбранный вариант и точки перехода между интерфейсами.
Опишите роли и права
Обычно стоит различать:
- Клиента: просмотр информации, отправка заявки, изменение своих данных в предусмотренных пределах.
- Менеджера: получение назначенных заявок, ответы и изменение рабочих статусов.
- Администратора: управление доступами, справочниками и настройками.
Для каждого действия определите, кто может его выполнить и какие записи видит. Уточните порядок выдачи и отзыва доступа, замену ответственного и действия после увольнения сотрудника.
Скрытая кнопка не заменяет проверку прав. Система должна отклонять недоступное действие, даже если пользователь передал команду напрямую. Не используйте отображаемое имя или знание названия команды как подтверждение роли.
Запишите сценарии от входа до результата
Карточка сценария может содержать:
- Название и цель: какую задачу выполняет пользователь.
- Точка входа: команда, кнопка, ссылка с сайта или рекламы.
- Начальные условия: роль, язык, наличие действующей заявки или других данных.
- Шаги: что показывает бот, что выбирает человек и что сохраняется.
- Переходы: следующий шаг, возврат, редактирование и отмена.
- Исключения: неправильный ввод, недоступный сервис, повторное действие.
- Результат: запись в системе, уведомление и следующий шаг клиента.
- Критерий проверки: как подтвердить, что сценарий выполнен правильно.
Приложите тексты сообщений и названия кнопок на нужных языках. Опишите, что происходит, если человек пишет свободный текст, возвращается позже или повторно запускает бота. Не заставляйте пользователя угадывать единственную допустимую команду.
Учитывайте возможности Telegram
Для обычного диалога с ботом предусмотрите действие пользователя, которое начинает общение. Бот не может сам открыть переписку с произвольным человеком: тот должен сначала написать ему или добавить его в группу. Это ограничение описано в документации Telegram.
Если нужен телефон, не рассчитывайте получить его из имени пользователя. В Bot API кнопка запроса контакта передаёт номер после нажатия пользователем и доступна в личном чате. Описание KeyboardButton.
Если сценарий работает в группе, отдельно проверьте необходимые права и режим приватности: по умолчанию доступ бота к сообщениям группы ограничен. Возможности ботов Telegram.
Пропишите поведение при блокировке бота пользователем и невозможности отправить уведомление. Альтернативный канал выбирайте только при наличии данных и оснований для такой коммуникации.
Определите данные и работу интеграций
Для каждого поля укажите назначение, обязательность, формат и место хранения. Например, заявке могут понадобиться выбранная услуга, описание задачи, язык, контакт для ответа и идентификатор заявки.
Собирайте сведения, которые нужны процессу. Укажите доступ сотрудников, срок хранения и порядок удаления данных. Уведомление пользователю и необходимые подтверждения согласуйте под выбранные рынки и сценарии.
Для CRM или календаря определите:
- какая система является источником актуального статуса;
- какие данные передаются и когда;
- как связываются записи разных систем;
- как обрабатываются ошибки, повторные события и задержки;
- кто получает сигнал о проблеме и исправляет её.
Заявка, сохранённая в боте, и заявка, созданная в CRM, могут быть разными состояниями. Текст подтверждения должен соответствовать фактическому этапу. Нажатие кнопки отправки не следует выдавать за подтверждённую запись на конкретное время.
Условный пример сценария заявки
Компания принимает запросы на консультацию. В первой версии бот собирает обращение, а дату обсуждает менеджер.
- Пользователь запускает бота и выбирает язык.
- Выбирает услугу и вводит описание задачи.
- Указывает предусмотренный контакт для ответа.
- Просматривает сводку, редактирует данные или отправляет заявку.
- Система сохраняет заявку с идентификатором и передаёт её в CRM.
- После подтверждения создания записи бот сообщает, что заявка передана, а менеджер получает уведомление.
Если CRM недоступна, заявка остаётся сохранённой и ожидает передачи. Клиент получает сообщение о текущем состоянии без обещания подтверждённого времени встречи. Ответственному сотруднику приходит сигнал о сбое.
Повторное нажатие и повторная доставка события не должны создавать дубликат той же заявки. В Telegram события имеют идентификатор обновления, который помогает распознавать повторную обработку; конкретную защиту при передаче в CRM должен реализовать разработчик. Описание Update в Bot API.
Отдельно определите, как человек создаёт новый запрос после завершения предыдущего. Защита от дублей не должна запрещать все будущие обращения.
Сделайте критерии готовности проверяемыми
Вместо «бот работает корректно» составьте перечень проверок:
- Все согласованные пути проходят от входа до результата.
- Ошибочный ввод объясняется, а уже введённые данные сохраняются по правилам сценария.
- Возврат, отмена и повторный вход дают ожидаемый результат.
- Менеджер видит только разрешённые записи; отзыв доступа действует.
- Повторное событие не создаёт дубликат, а новый запрос принимается.
- Ошибка интеграции заметна ответственному и обрабатывается по согласованному порядку.
- Языки, уведомления и тексты соответствуют утверждённой версии.
- Проверены согласованные приложения и устройства, на которых будут работать пользователи.
Для времени ответа и ожидаемой нагрузки задайте измеримые условия: число одновременных пользователей, тип действия, время проверки и допустимую задержку. Значения согласуйте под реальный процесс, без произвольного обещания одинаковой скорости при любой нагрузке.
Зафиксируйте передачу и сопровождение
Укажите, кому принадлежат бот, размещение приложения и используемые аккаунты. В составе передачи согласуйте исходный код или предусмотренный договором доступ к решению, описание интеграций, инструкцию администратора и порядок резервного копирования.
Токен бота не вставляйте в общедоступное ТЗ. Telegram предупреждает, что владелец токена получает управление ботом; передавайте его только тем, кому нужен доступ, через согласованный защищённый способ. Рекомендации Telegram.
Разделите исправление несоответствий ТЗ, новые функции и регулярное сопровождение. Определите, кто следит за ошибками и обновлениями интеграций после запуска и как согласуются изменения требований.
Для обсуждения разработки Telegram-бота и Mini App подготовьте описание процесса, роли, карточки сценариев и примеры данных. Коммерческое предложение поможет согласовать состав работ; сложность и ограничения интеграций уточняйте по конкретным системам.