Как составить ТЗ на разработку бота: структура, пример и ошибки

Как составить ТЗ на разработку бота, если вы не программист? Хорошее техническое задание описывает, что бот делает, для кого и как понять, что работа готова. Чем больше в нём конкретики, тем точнее исполнитель сделает задуманное и тем быстрее посчитает стоимость.

Зачем нужно техническое задание на бота

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

Юридически ТЗ закрепляет, что должен сделать исполнитель и что предоставить заказчик. Оно нужно даже маленькому боту.

Кто пишет ТЗ: вы, разработчик или вместе

Вариантов три:

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

Удобнее всего поручить документ специалисту и при этом участвовать самому. Не хотите писать ТЗ? Заполните бриф, и требования мы соберём сами.

Стандарты ТЗ: ГОСТ и IEEE

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

• ГОСТ 19.201-78 «Техническое задание. Требования к содержанию и оформлению». Стандарт Единой системы программной документации (ЕСПД), описывает ТЗ на программу.
• ГОСТ 34.602-2020 «Техническое задание на создание автоматизированной системы». Действует с 2022 года вместо ГОСТ 34.602-89 и рассчитан на крупные информационные системы.
• ISO/IEC/IEEE 29148-2018. Международный стандарт о том, как собирать и описывать требования к системам и программам.

Рядом с ними часто называют RUP (Rational Unified Process), но это методология разработки от Rational Software и IBM. Её шаблон спецификации требований можно взять как образец, стандартом ТЗ он не считается.

Для бота полный ГОСТ обычно избыточен: хватает нескольких страниц со сценариями, ролями, интеграциями и критериями приёмки. Из стандартов стоит взять главное правило: каждое требование должно пониматься однозначно.

Структура ТЗ на чат-бота

1. Расскажите о бизнесе

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

2. Объясните термины отрасли

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

3. Покажите примеры и аналоги

Дайте ссылки на ботов конкурентов и похожие сервисы и отметьте, что нравится, а чего хочется избежать.

4. Опишите технические требования

В каких мессенджерах работает бот (Telegram, MAX или оба), с какими системами он связан (CRM, 1С, таблица, оплата) и какая ожидается нагрузка. Так разработчик заранее проверит, что возможно. Например, бесплатно Telegram пропускает около 30 сообщений в секунду, и рассылка на 100 000 человек займёт около часа. Платная рассылка за Telegram Stars поднимает лимит до 1 000 сообщений в секунду. Подробнее на странице лимитов Telegram.

Если бот собирает имена и телефоны, укажите это отдельно. Базу придётся держать на сервере в России, а согласие на обработку персональных данных с 1 сентября 2025 года оформляется отдельным документом.

5. Опишите сценарии

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

6. Определите критерии приёмки

Чек-лист того, что вы проверяете на готовом боте. Он снимает споры на финальном этапе.

Пример: как описать один сценарий

Так может выглядеть описание сценария записи в ТЗ на бота для салона.

По такому описанию разработчик сразу оценит объём, а вы проверите результат по пунктам.

Типичные ошибки при составлении ТЗ

• Размытые формулировки. Слова «красиво», «удобно», «быстро» ничего не говорят разработчику. Пишите проверяемо: «бот отвечает за 2 секунды», «в меню не больше шести кнопок».
• Нет приоритетов. Отметьте, что обязательно к запуску, а что можно добавить потом.
• Забыты ограничения. Учитывайте бюджет, сроки и лимиты мессенджеров.
• Интеграция одной строкой. Фразы «связать с CRM» мало. Укажите, какая CRM, какие поля передаются и что делать с дублями.
• Нет сценариев ошибок. Опишите, что делает бот, если клиент ввёл ерунду, бросил запись на середине или внешняя система не ответила.

Хорошее ТЗ полезно обеим сторонам: заказчик получает то, что задумал, а исполнитель понимает, что делать и как это сдать.

Частые вопросы