Техническое задание на Telegram-бота должно описывать действия пользователя и результат каждого шага. Список команд без переходов, данных и ошибок не позволяет однозначно оценить разработку. Начните с основного процесса, затем добавьте исключения.
Определите участников и начало сценария
Запишите, кто пользуется ботом: клиент, сотрудник или администратор. Уточните, как человек открывает его и что видит при первом обращении. Новый пользователь и тот, кто вернулся после незавершённой заявки, могут нуждаться в разных ответах.
Описывайте назначение каждого действия. «Кнопка заявки» должна вести к определённому процессу: выбрать услугу, оставить сведения и получить подтверждение сохранения. Иначе исполнитель будет самостоятельно придумывать важные части работы.
Нарисуйте переходы
Для каждого шага запишите входное сообщение, допустимый ответ, действие системы и следующий шаг.
| Шаг | Что требуется описать |
|---|---|
| Выбор услуги | Доступные варианты и изменение выбора |
| Ввод контакта | Формат, проверка, исправление |
| Описание задачи | Ограничения и возможность пропустить |
| Подтверждение | Какие сведения показываются перед отправкой |
| Сохранение | Идентификатор и состояние заявки |
Добавьте отмену, возврат и повторный запуск. Пользователь не обязан проходить диалог в идеальном порядке и может отправить неожиданное сообщение.
Определите данные и их назначение
Укажите, какие сведения нужны для работы и где они сохраняются. Отдельно запишите служебные данные: идентификатор обращения, время, выбранный сценарий и состояние доставки в CRM.
Не собирайте сведения только потому, что Telegram позволяет их получить. Каждое поле должно иметь рабочую задачу. Порядок хранения и правовые требования согласуйте для своей ситуации до публикации.
Опишите интеграции и ограничения
Если бот связан с CRM, укажите поля, правила назначения и обработку дублей. Если отправляет уведомления, уточните события, получателей и состояния доставки.
Возможности личных сообщений зависят от взаимодействия пользователя с ботом. Это нужно учитывать в сценарии, а не считать, что бот может написать любому известному аккаунту. Ограничения описаны в официальном FAQ Telegram.
Зафиксируйте критерии приёмки
Для каждого важного процесса подготовьте тестовые данные, шаги и ожидаемый результат. Добавьте неверный контакт, отмену, повторное сообщение и недоступность внешней системы.
Согласуйте, кто управляет ботом после запуска: где меняются тексты, как посмотреть ошибку и кто отвечает за интеграции. Передача проекта включает настройки и исходники по договорённости, а секреты передаются отдельно защищённым способом.
Для оценки Telegram-бота для бизнеса достаточно начать с одного полностью описанного сценария. Такой документ показывает объём точнее, чем длинный список желаемых кнопок.
