ТЗ на разработку бота: шаблон для заказчика

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

Рабочий чек-лист, схема диалога и карандаш на столе

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

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

С чего начать, если готового ТЗ нет

Сформулируйте задачу через действие пользователя. Например: «Клиент оставляет заявку на обслуживание оборудования, менеджер назначает исполнителя, руководитель видит незакрытые обращения». Из этой фразы уже понятны участники и ожидаемый результат.

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

Отдельно укажите платформу: Telegram, MAX, ВКонтакте или другой согласованный канал. Если выбор ещё открыт, объясните, где находятся пользователи и как они должны попадать в сервис. Можно попросить подрядчика сравнить подходящие варианты до детальной оценки.

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

Как описать один сценарий на примере заявки

Возьмём условный сервис обслуживания оборудования. Клиент хочет сообщить о неисправности. В ТЗ сценарий можно записать так:

  1. Клиент выбирает «Оставить заявку».
  2. Бот спрашивает тип оборудования, описание проблемы и адрес объекта. Фотографию можно приложить по желанию.
  3. Перед отправкой клиент видит собранные сведения и может исправить их.
  4. После подтверждения система сохраняет заявку и показывает её номер.
  5. Менеджер получает обращение, назначает исполнителя и переводит заявку в состояние «В работе».

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

Теперь добавьте исключения. Что происходит при повторном нажатии «Отправить»? Сохраняется ли черновик, если клиент прервался? Кто увидит обращение, если менеджер недоступен? Можно ли изменить адрес после назначения исполнителя? Эти ответы входят в описание сценария.

Такой пример условный: он показывает способ записи требований. В вашем проекте последовательность, роли и состояния могут быть другими.

Что указать о данных, доступах и интеграциях

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

Роли лучше описывать через разрешённые действия. Клиент видит свои обращения. Менеджер работает с назначенными заявками. Администратор управляет справочниками и доступами в согласованных пределах. Отдельно решите, кто может выгружать данные, удалять записи и просматривать историю изменений.

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

Фразе «подключить CRM» нужна детализация: создание новой заявки, поиск существующего клиента и обновление состояния - разные действия. Для каждого определите ожидаемый результат и порядок работы при сбое.

Шаблон ТЗ на бота для копирования

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

ТЕХНИЧЕСКОЕ ЗАДАНИЕ НА БОТА
Название проекта:
Версия и дата документа:
Ответственный за согласование:

1. ЗАДАЧА И ГРАНИЦЫ
Какую задачу бизнеса решаем:
Кто будет пользоваться:
Платформа или вопрос о её выборе:
Что входит в первую версию:
Что планируется позже:
По какому признаку процесс готов к использованию:

2. РОЛИ
Название каждой роли:
Какие данные видит:
Что может создавать, менять и удалять:
Кто выдаёт и отзывает доступ:
Что происходит при смене ответственного:

3. СЦЕНАРИИ
Для каждого сценария заполнить отдельный блок.
Номер и название:
Роль пользователя:
Условие начала:
Шаги, кнопки и сообщения:
Обязательные и необязательные сведения:
Результат и следующее состояние:
Возврат назад, отмена и повторный запуск:

4. ДАННЫЕ
Перечень полей и назначение каждого:
Источник, формат и обязательность:
Правила проверки:
Где хранятся сведения и кто имеет доступ:
Условия изменения, хранения и удаления:
Какие действия нужны в истории изменений:

5. ОШИБКИ
Пустое поле или неверный формат:
Повторная отправка и признак дубля:
Прерванный сценарий:
Недоступность внешней системы:
Кто получает сообщение об ошибке:
Как повторяется действие и проверяется результат:
Когда требуется ручная обработка:

6. ИНТЕГРАЦИИ
Название внешней системы:
Ответственный за доступ и документацию:
Что передаём и что получаем:
Когда начинается обмен:
Как связываются записи двух систем:
Как подтверждается успешная передача:
Как обрабатываются ошибки и повторы:
Где проверяем интеграцию до запуска:

7. ПРИЁМКА
Требование или сценарий:
Начальные условия и тестовые данные:
Действие проверяющего:
Ожидаемый результат:
Как фиксируется результат проверки:
Кто принимает работу:
Устройства и среды для проверки:

8. ПЕРЕДАЧА ПРОЕКТА
Состав исходного кода и документации:
Инструкция запуска и работы администратора:
Кто управляет сервером и учётными записями:
Какие доступы передаются и каким закрытым способом:
Что требуется для продолжения работы другой командой:

9. ПОДДЕРЖКА
Канал обращения и ответственные:
Часы работы и согласованный срок реакции:
Что относится к ошибке, что к новой функции:
Порядок обновлений и резервного копирования:
Кто оплачивает внешние сервисы и инфраструктуру:
Порядок согласования изменений:

ОТКРЫТЫЕ ВОПРОСЫ
Вопрос / кто уточняет / когда нужен ответ:

Как проверить работу по ТЗ

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

Для условного сценария выше таблица приёмки может выглядеть так:

ПроверкаДействиеОжидаемый результат
Обычная заявкаЗаполнить обязательные сведения и подтвердитьСоздана одна заявка; клиент видит её номер, менеджер получает обращение
Ошибка вводаОтправить форму без адресаБот показывает нужное поле; ранее введённые сведения сохранены
ДубльПовторить отправку той же формыПо согласованному признаку повтора остаётся одна заявка
Права клиентаПопробовать открыть чужое обращениеСодержимое чужой заявки недоступно
Права менеджераОтозвать роль и повторить действие управленияИзменение заявки недоступно бывшему менеджеру
Сбой интеграцииВ тестовой среде прервать связь с CRMЗаявка сохранена, ответственный видит ошибку; повторная передача выполняется по согласованному правилу
Возврат к вводуЗакрыть диалог и начать сноваБот ведёт себя согласно выбранному правилу: восстанавливает черновик или начинает новую форму

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

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

Что согласовать о передаче и поддержке

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

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

В рекомендательном письме «Спортмастера» от 8 сентября 2026 года описаны создание и техническая поддержка ботов в Telegram и MAX. Заказчик отдельно упоминает помощь в структурировании функциональности и устранение ошибок. Поэтому поддержку и порядок уточнения функций полезно обсудить ещё при подготовке задания. Письмо описывает конкретное сотрудничество; условия вашего проекта согласуются отдельно.

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

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

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

Чтобы обсудить сроки и стоимость разработки, закажите обратный звонок VolosnikovPro. К разговору подготовьте черновик ТЗ. Если описан пока один сценарий, возьмите его и выпишите вопросы, которые хотите обсудить.

Источники

  • Рекомендательное письмо ООО «Спортмастер», 08.09.2026: создание и техническая поддержка ботов в Telegram и MAX, помощь в структурировании функций и устранение ошибок. Шаблон ТЗ и пример заявки подготовлены как практические рекомендации; они не воспроизводят документы этого заказчика.
Обсудим задачу

Хороший продукт начинается
с понятного вопроса

Расскажите, что хотите автоматизировать. Поможем определить подходящий формат и состав работ.

Обсудить проект

Оставьте номер телефона. Мы свяжемся с вами.