Как составить ТЗ на Telegram-бота: вопросы, сценарии и результат

Хорошее ТЗ на Telegram-бота не обязано быть большим документом. Его задача — зафиксировать пользовательские сценарии, данные, границы первой версии и критерии готовности.

Начните с результата

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

Так формулировка сразу показывает, что нужно проверить: форму, хранение, уведомления, оплату и выдачу результата.

Что должно быть в ТЗ

Пользовательские роли

Опишите клиента, менеджера и администратора. Для каждой роли укажите, какие разделы она видит, какие действия выполняет и какие данные ей недоступны.

Сценарии

Каждый сценарий записывайте в формате: стартовое действие, шаги, успешный результат, ошибка и повторная попытка. Отдельно укажите, что происходит при /start, возврате в бота и повторной отправке формы.

Данные

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

Интеграции

Перечислите CRM, таблицы, платежи, внешние API, рассылки и webhooks. Если интеграции пока нет, напишите, что должно происходить при временной недоступности сервиса.

Админка

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

Критерии готовности

У каждой функции должен быть проверяемый результат. Например: «после успешной оплаты заказ получает статус paid, товар выдаётся один раз, повторный webhook не создаёт вторую выдачу».

Что часто забывают

• Состояния загрузки и ошибки Telegram API.
• Повторную отправку кнопки и повторный webhook платежа.
• Ограничение доступа к админским командам.
• Логи, резервную копию базы и переменные окружения.
• Условия возврата и поддержку после запуска.
• Что происходит, если внешний API недоступен.

Если нужен пример готовой архитектуры, посмотрите курс по Telegram-ботам на Python и кейс FazerCards. Для оценки задачи можно сразу написать в Telegram.