Техническое задание на Telegram-бота должно описывать действия пользователя, ответы системы и условия завершения каждого сценария. Добавьте данные, роли сотрудников, интеграции и критерии приёмки. Раздел «бот записывает клиентов» нужно раскрыть до начала оценки разработки.
Цель и границы бота
Назовите основную задачу: запись на встречу, запрос статуса или сбор обращения. Укажите аудиторию и точку входа. Затем перечислите, что в первую версию не входит. Например, бот записывает на консультацию, а перенос встречи выполняет сотрудник.
Опишите роли: посетитель выбирает время, сотрудник подтверждает встречу, администратор меняет расписание. Для каждого действия укажите, кто имеет право его выполнить. Согласуйте, как проверяется роль и что увидит пользователь без нужного доступа.
Пример сценария записи
Ниже приведён условный сценарий для обсуждения требований, а не история клиентского проекта.
- После команды /start бот показывает назначение и кнопку «Выбрать время».
- Пользователь выбирает дату и доступный интервал.
- Бот показывает сводку и предлагает подтвердить запись.
- Сервер повторно проверяет доступность времени и сохраняет запись.
- Пользователь получает результат, сотрудник видит новую запись в рабочем списке.
Для каждого шага приложите текст сообщения и список кнопок. Объясните, что делают «Назад» и «Отмена». Если свободных интервалов нет, нужен отдельный ответ. Если выбранное время уже занято, сценарий должен предложить вернуться к выбору.
Данные и интеграции
Перечислите поля записи: идентификатор, дата, время, выбранная услуга и статус. Для каждого поля укажите источник и обязательность. Демонстрационный пример записи поможет проверить, одинаково ли стороны понимают формат.
Для подключения календаря или CRM нужны название сервиса, описание обмена и ответственный за доступы. Уточните, какое действие считается успешным: сохранение в основной системе или только отправка уведомления. Доступы и секреты передавайте отдельно от публичного документа.
Ошибки, повторы и работа сотрудника
Запишите требование к повторному нажатию: подтверждение одной записи не должно создавать несколько встреч. Объясните поведение при недоступном календаре, задержке ответа и выходе из диалога. Пользователь должен видеть, завершилась ли операция и какой шаг доступен дальше.
Предусмотрите способ найти ошибочную запись и продолжить работу вручную. Для сотрудника определите список, фильтры, смену статуса и уведомление о сбое. Укажите, какие действия фиксируются в истории и кто её просматривает.
Приёмка и передача
В ТЗ добавьте проверки обычной записи, отмены, занятого времени и повторного подтверждения. Для каждого теста нужны начальные условия, действия и ожидаемый результат. Назначьте тестовый аккаунт и ответственного за принятие работы.
Зафиксируйте передачу исходников, доступов к размещению, инструкций и порядок поддержки. Начните с заполнения одного сценария целиком. Если нужна оценка состава продукта, посмотрите решение для бота записи.