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