ТЗ на бота: что написать для оценки и срока

ТЗ на бота не обязано быть документом на двадцать страниц. Чтобы получить оценку и срок, хватит одной-двух страниц: кто пишет боту, что бот спрашивает, куда отправляет ответы и что считать готовым результатом. По такому описанию я называю срок и цену до начала работ, а сами боты у меня делаются от 3 до 10 дней, иногда до двух недель. Ниже разбираю, что написать в техническом задании на Telegram-бота, чего Telegram не позволяет и на чём заказчики чаще всего теряют время.

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

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

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

Что написать в ТЗ на бота

Цель и кто пишет боту

Одна-две фразы: какую работу бот снимает с людей и кто ему пишет. «Клиенты из рекламы оставляют заявку на замер, менеджер получает её в amoCRM» — это уже цель. Если пользователей несколько видов, например клиенты и сотрудники, опишите каждого отдельно: у них разные сценарии и, скорее всего, разные права.

Сценарий по шагам

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

Отдельно отметьте развилки: «выбрал „Доставка“ — спросить адрес, выбрал „Самовывоз“ — показать адреса магазинов». Каждая развилка — отдельная ветка со своими текстами и проверками. По числу веток я в первую очередь и оцениваю срок.

Если клиенты приходят из разных мест (реклама, сайт, визитка на кассе), напишите и об этом. В Telegram каждому источнику можно дать свою ссылку на бота с параметром, и бот будет знать, откуда пришёл человек. Заложить это сразу несложно, а добавлять потом неудобно: старые ссылки уже разошлись.

Какие данные собирать и как их проверять

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

Если бот принимает фото, документы или голосовые сообщения, напишите, какие и куда их сохранять.

Куда уходят данные

Назовите систему и место в ней: «сделка в amoCRM, воронка „Розница“, этап „Новая заявка“, поля „Город“ и „Услуга“ заполняются из ответов». Или заказ в RetailCRM, сообщение в рабочий чат, строка в таблице. Если нужна обратная связь, например бот сообщает клиенту статус заказа из CRM, это отдельная интеграция, и её тоже нужно назвать. Если бот пишет только в рабочий чат, заявки в нём листаются и забываются; где ещё они теряются, есть в чек-листе «Где теряются заявки в CRM».

К заданию полезно приложить список систем, к которым понадобится доступ, и кто его выдаёт. Ожидание доступов съедает срок не хуже разработки.

Тексты

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

Кто ведёт бота после запуска

Кто меняет тексты, когда сменился адрес или график. Кому писать, если бот перестал отвечать. Нужна ли своя панель для правок или изменения вносит исполнитель. От ответа зависит объём работы: редактирование текстов без разработчика — отдельная функция, и её нужно заложить в оценку.

Что считать готовым

Одна-три фразы, по которым можно проверить результат. Например: «клиент проходит сценарий за две минуты, заявка появляется в amoCRM на этапе „Новая заявка“ с телефоном и услугой, менеджер получает уведомление в рабочий чат». С таким критерием результат проверяется за несколько минут, и спорить не о чем.

Что Telegram-бот умеет и чего не умеет

Часть пожеланий упирается не в разработку, а в правила Telegram. Их лучше знать до того, как садиться за описание. Всё ниже взято из документации Telegram для разработчиков ботов.

  • Первым бот не пишет. Бот не может начать разговор: человек должен сам написать ему или добавить его в группу. Загрузить в бота базу телефонов из CRM и разослать по ней сообщения не получится.
  • Скорость рассылок ограничена. Бесплатно бот отправляет около 30 сообщений в секунду по всем пользователям, в один чат — не чаще одного сообщения в секунду, в группу — до 20 сообщений в минуту. Рассылка по большой базе займёт время, и это стоит учесть в сценарии.
  • Файлы до 50 МБ. Бот отправляет файлы до 50 МБ, а файл от пользователя может скачать, только если он не больше 20 МБ. Видео и большие архивы лучше передавать ссылкой.
  • В группе бот видит не всё. По умолчанию у бота включён режим приватности: в группе он получает команды, адресованные ему, и ответы на свои сообщения, а остальную переписку не видит. Если бот должен читать весь чат, укажите это отдельно.
  • Оплата. Цифровые товары и услуги (курсы, подписки, доступ к материалам) внутри Telegram продаются только за Telegram Stars. Физические товары и услуги оплачиваются через стороннего платёжного провайдера, которого нужно подключить к боту.
  • Сложный интерфейс — мини-приложение. Каталог с фильтрами, корзину или календарь записи удобнее сделать как Mini App: веб-приложение, которое открывается внутри Telegram. По объёму это ближе к небольшому сайту, и срок считается иначе.
  • Бот от имени аккаунта. Бота можно подключить к аккаунту Telegram, чтобы он разбирал входящие и отвечал от имени владельца в тех чатах, которые владелец разрешил. Если нужен такой режим, а не отдельный бот, укажите это сразу.

Что сдвигает срок

Нижняя граница, около трёх дней, — у бота с одним сценарием, парой проверок и одной точкой выхода, например сделкой в CRM. Срок растёт, когда в задаче появляются:

  • новые ветки и тексты в них;
  • оплата внутри бота;
  • интеграции, особенно с системами без удобного API;
  • мини-приложение вместо кнопок;
  • панель для редактирования текстов;
  • ИИ, который отвечает клиенту своими словами: до запуска нужно ещё тестирование ИИ-агента.

Что помещается в три дня, а что нет, я подробно разбирал в статье «Автоматизация бизнеса за 3 дня: что реально».

Шаблон ТЗ одной таблицей

Раздел Что написать Пример
Цель Какую работу бот снимает с людей Принимает заявки на замер из рекламы
Пользователи Кто пишет боту Клиенты; менеджеры получают уведомления
Сценарий Шаги, кнопки, развилки Услуга → город → дата → телефон
Источники Откуда приходят клиенты Реклама, сайт, визитки в магазине
Данные Поля, обязательность, проверки Телефон обязателен, формат +7
Куда уходят Система, воронка, этап, поля amoCRM, «Розница», «Новая заявка»
Тексты Кто пишет, готовы ли Готовы, лежат в приложенном файле
Ведение Кто меняет тексты, кому писать о сбоях Администратор, правки через исполнителя
Готово, когда Проверяемый результат Заявка в CRM с телефоном, уведомление в чате

Где обычно ошибаются в ТЗ на бота

Описывают интерфейс вместо задачи. «Три синие кнопки сверху» — это не ТЗ. Сначала что должно произойти, потом как это выглядит. Иногда задача решается проще, чем нарисовано в макете.

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

Не продумывают ответы не по сценарию. Человек пишет текстом вместо кнопки, присылает голосовое, бросает диалог на середине. Если поведение бота в этих случаях не описано, его придумает исполнитель, и не факт, что так, как удобно вам.

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

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

Сделать самому или отдать

Бота с меню и готовыми ответами можно собрать самому в конструкторе, если связь с CRM не нужна. Отдавать стоит, когда заявки должны попадать в amoCRM или RetailCRM с нужными полями, у бота несколько веток, нужна оплата или интеграция с другими системами.

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

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

Что должно быть в техническом задании для создания бота?

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

Можно ли заказать бота без ТЗ?

Можно. Опишите задачу своими словами, а исполнитель задаст вопросы и соберёт ТЗ сам. На старте это займёт больше времени, зато до начала работ будет видно, правильно ли вас поняли.

Сколько стоит бот в Telegram?

Цена зависит от того же, что и срок: числа веток, интеграций с CRM и другими системами, оплаты, панели для правок. Бот с одним сценарием и бот с каталогом и оплатой отличаются по цене в разы. Точную сумму я называю после того, как увижу задачу, и до начала работ.

Сколько длится разработка Telegram-бота?

У меня — от 3 до 10 дней, иногда до двух недель. Бот с одним сценарием и передачей заявок в CRM ближе к нижней границе, ветки, оплата и интеграции сдвигают срок к верхней. Если доступы и тексты готовы к началу работ, срок не растягивается из-за ожидания.

Свяжемся в течение нескольких минут

Обсудим, какое решение подойдёт вашему бизнесу?

Аудит бесплатный. Работаем по договору и ТЗ.