Хорошее техническое задание на бота начинается не с выбора языка программирования. Оно описывает людей, события и результат. Этого достаточно, чтобы разработчик предложил архитектуру и оценил работу без догадок.
1. Назовите одну главную задачу
Формулировка «бот для бизнеса» слишком широкая. Лучше: «бот принимает заявку, задаёт четыре вопроса и создаёт сделку в CRM» или «бот выдаёт доступ к курсу после подтверждённой оплаты».
Главная функция — это наблюдаемое изменение после диалога, а не список кнопок.
2. Перечислите роли
Даже у простого бота часто больше одного пользователя:
- клиент, который проходит сценарий;
- оператор, который подключается к сложному вопросу;
- менеджер, который получает новую заявку;
- администратор, который меняет настройки или выгружает данные.
Для каждой роли укажите, что она видит, что может менять и какие уведомления получает.
3. Опишите сценарий событиями
Не рисуйте идеальный прямой путь. Запишите, что происходит после каждого действия и что делать, если пользователь молчит, нажимает не ту кнопку или возвращается через неделю.
- Пользователь нажимает «Начать».
- Бот объясняет пользу и запрашивает согласие на обработку данных.
- Пользователь выбирает услугу.
- Бот задаёт вопросы, сохраняя ответы после каждого шага.
- Показывает итог и просит подтвердить.
- Создаёт заявку в CRM и сообщает номер.
- Менеджер получает уведомление со ссылкой на карточку.
4. Зафиксируйте состояния и ошибки
| Ситуация | Ожидаемое поведение |
|---|---|
| Нет ответа | Одно напоминание, затем тихое завершение |
| Неверный формат | Пример правильного ввода без потери предыдущих данных |
| Интеграция недоступна | Сохранить запрос, сообщить пользователю, уведомить оператора |
| Повторная оплата | Не создавать второй заказ, показать текущий статус |
| Нужен человек | Передать контекст и не заставлять повторять ответы |
5. Опишите данные
Для каждого поля полезно указать источник, обязательность, формат и срок хранения. Особенно внимательно отнеситесь к телефону, email, документам и любым сведениям, которые могут относиться к персональным данным.
6. Перечислите интеграции
Название CRM недостаточно. Нужны доступ к документации API, тестовый контур, список операций и ответственный за внешнюю систему. Если документации нет, исследование интеграции становится отдельным этапом.
- CRM: создание и обновление сделки;
- платёжная система: счёт, webhook и возврат;
- таблица или база: чтение и запись;
- почта и уведомления: получатели и шаблоны;
- аналитика: события, воронка и источник пользователя.
7. Определите критерии приёмки
Критерий должен проверяться. Например: «После успешной оплаты пользователь получает доступ не позднее чем через минуту; повторный webhook не создаёт дубликат; оператор видит историю ответов».
Минимальный шаблон
- Цель и один главный результат.
- Роли и права.
- Основной сценарий по шагам.
- Ошибки, отмена и возврат.
- Данные и срок хранения.
- Интеграции и доступная документация.
- Уведомления и тексты.
- События аналитики.
- Критерии приёмки.
- Желаемый срок и ограничения.
Страница услуги показывает, как мы проектируем Telegram- и MAX-ботов после получения такого описания.