Материал обновлён 21 октября 2026 года.
Человек открывает рабочего бота и получает приветствие с большим перечнем возможностей. Ему нужно узнать статус заявки, однако непонятно, какую команду выбрать и требуется ли номер. Первое сообщение полезно проектировать вокруг ближайшего действия пользователя. Удачный старт объясняет назначение бота, доступный ввод и ожидаемый результат, после чего помогает выполнить одну конкретную задачу.
Выберите основной сценарий старта
Рассмотрим учебного бота для просмотра обращений. После запуска он сообщает: "Помогу посмотреть статус вашей заявки. Выберите 'Проверить заявку' и введите её номер. Доступные действия перечислены в справке". Это пример текста для обсуждения, который нужно адаптировать к реальным функциям и правам. Если просмотр требует связать аккаунт с кабинетом, соответствующий шаг объясняют до запроса номера.
Приветствие стоит ограничить информацией, необходимой сейчас. Обновления проекта и дополнительные сервисы можно показывать в уместном разделе. Пользователю важно понять, какие сведения бот уже знает, что потребуется ввести и где остановить текущую операцию. Обещание "помогу с любым вопросом" создаёт ожидание, которому специализированный сценарий обычно не соответствует.
Составьте словарь действий
Документация Telegram описывает команды /start, /help и, когда применимо, /settings. Список команд с описаниями можно настроить через BotFather или API. Наличие пункта в меню не реализует его обработку в программе. Поэтому сначала свяжите каждую команду с действием, состояниями и результатом, затем настраивайте отображаемый список.
Для учебного бота достаточно четырёх действий с понятными русскими описаниями.
| Действие | Ожидаемое поведение |
|---|---|
| Старт | Объясняет назначение бота и ближайший шаг пользователя. |
| Справка | Объясняет доступные действия, приводит вымышленный пример номера и причины возможного отказа в доступе. |
| Проверка заявки | Переводит диалог в ожидание номера, сообщает формат и предлагает отмену. |
| Отмена ввода | Завершает текущий ввод с понятным возвратом к доступным действиям. |
Вымышленный номер в справке явно обозначьте как пример. Содержание действий согласуйте с реальными функциями и правами.
Согласуйте работу команд во время незавершённого диалога. Если пользователь уже вводит номер и вызывает справку, прежнее состояние можно сохранить с понятным возвратом. Команда отмены завершает именно текущий ввод. Она не должна неожиданно удалять заявку или отключать уведомления: эти операции имеют другие последствия и требуют собственных названий.
Неизвестный ввод требует полезной реакции
Предусмотрите сообщение с опечаткой, фотографию и команду, которая отсутствует в списке. Бот может ответить: "Сейчас ожидается номер заявки. Пример формата: З-104. Чтобы вернуться в меню, выберите 'Отменить'". Текст объясняет текущее ожидание и путь продолжения. Повторять всё приветствие после каждой ошибки неудобно, особенно в длинном диалоге.
На сервере необходимо проверять допустимость команды и права пользователя, даже когда меню скрывает часть действий. Telegram отдельно предупреждает, что полученная команда может отсутствовать в настроенном списке. Приветствие и меню помогают ориентироваться; доступ к рабочим данным определяется правилами системы и подтверждённой связью пользователя с нужным объектом.
Проверьте старт глазами нового пользователя
Подготовьте учебный аккаунт, который ещё не проходил настройку. Откройте диалог и выполните основную задачу, следуя только сообщениям бота. Проверьте справку до начала ввода, в середине сценария и после результата. Затем повторите старт для уже настроенного пользователя: бот должен учитывать существующее состояние и объяснять доступные действия последовательно.
Для приёмки запишите ожидаемые ответы на разные виды ввода.
- Неизвестная команда и пункт, отсутствующий в настроенном списке.
- Пустое значение или длинный текст в ответ на запрос номера.
- Отмена во время незавершённого сценария.
Проверьте соответствие меню фактическим обработчикам после последнего обновления. Неработающий пункт лучше убрать из доступных действий до готовности функции либо явно объяснить ограничение. Отдельно попросите сотрудника пересказать назначение бота после первого сообщения: это простой способ заметить неясные обещания.
Разработку сценариев и рабочих Telegram-ботов можно обсудить с Семёном Дулесовым.
Какое одно действие пользователь вашего бота должен понимать сразу после запуска?