Как создать бота в Sherlock Platform: сценарий и проверка

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

Какой результат должен получиться

Минимальный рабочий результат: это не карточка с названием бота, а диалог, который запускается в выбранном канале, показывает приветствие, принимает нажатие кнопки, возвращает человека в меню и не зависает на произвольном сообщении. Официальная справка Sherlock разделяет настройку на вкладки «Сценарий», «События» и «Свойства», а для работы требует подключить канал связи к созданному боту (Sherlock Support).

До настройки зафиксируйте карту результата. Исходные условия: есть доступ к Sherlock Platform и подготовлен канал, например бот Telegram. Ожидаемый результат: человек видит меню и получает один проверяемый ответ. Обязательные шаги: схема, сценарии, команды, события, канал, тест. Проверка: полный диалог с новым пользователем. Частые сбои: нет события запуска, не подключён канал или отсутствует возврат в меню. Ограничение: платформа решает задачи чат-центра и сложных сценариев, но требует отдельного рабочего пространства и настройки канала.

Сначала соберите маршрут на бумаге

Не начинайте с десятка веток. Для первой версии достаточно трёх сценариев.

1. Приветствие: одна фраза о назначении бота и переход в главное меню.
2. Главное меню: две кнопки с понятным результатом, например «Услуги» и «Связаться».
3. Неизвестное сообщение: объяснение, что бот не понял текст, плюс кнопка возврата в главное меню.

Официальный учебный материал Sherlock предлагает те же обязательные части: приветствие, главное меню и обработку произвольной фразы. Для простого кнопочного бота нужны события инициализации и сообщения клиента (урок Sherlock).

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

Как добавить бота и сценарии

Откройте модуль «Боты» и добавьте нового бота через левую панель. В карточке заполните понятное название и псевдоним, затем сохраните свойства. Официальная документация также описывает копирование существующего бота, но для первой настройки безопаснее создать пустую карточку: в ней нет чужих событий, каналов и скрытых переходов (модуль «Боты»).

1. На вкладке «Сценарий» создайте сценарий приветствия.
2. Добавьте сценарий главного меню и сценарий неизвестного сообщения.
3. В приветствие добавьте команду «Сообщение клиенту», затем переход к главному меню.
4. В главное меню добавьте сообщение и две команды «Кнопка».
5. Для каждой кнопки задайте переход к нужному сценарию.
6. В конечной ветке добавьте кнопку возврата в главное меню.

Команда «Кнопка» может вести к другому сценарию или по ссылке, запрашивать телефон или геолокацию. Набор действий зависит от канала, поэтому в первой версии используйте обычный переход между сценариями и проверяйте его в том же мессенджере, где бот будет работать (справка по кнопкам).

По теме: Как создать бота в Яндексе: Мессенджер или Алиса

Какие события обязательны

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

• Инициализация запускает приветствие один раз при старте бота.
• Сообщение клиента со стартовой командой ведёт в приветствие или главное меню.
• Сообщение клиента с произвольным текстом ведёт в запасной сценарий.
• Событие для конкретной команды должно стоять раньше общего правила для любого текста.

Для Telegram документация Sherlock отдельно предупреждает: правило для /start* размещают раньше общего правила *, иначе универсальная обработка перехватит первое сообщение. В запасном сценарии нужно объяснить ошибку и вернуть кнопки или дать переход в меню (обработка произвольной фразы).

Как подключить канал без утечки доступа

Создание логики и подключение канала являются разными операциями. Сначала добавьте канал в настройках Sherlock Platform по инструкции вашей организации, затем укажите созданного бота как обработчик этого канала. Каталог официальной документации выделяет подключение каналов в отдельный раздел (Sherlock Support).

• Не вставляйте токен мессенджера в сценарий, сообщение или снимок экрана.
• Выдавайте доступ к настройкам только тем, кто отвечает за канал.
• Для проверки используйте отдельный тестовый чат, а не рабочую очередь клиентов.
• Если токен случайно попал в переписку или документ, отзовите его в сервисе мессенджера и подключите новый.

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

По теме: n8n и ИИ-агенты: собрать безопасный сценарий с нуля

Проверка перед запуском

Проверяйте не отдельные карточки в редакторе, а результат глазами нового пользователя. Начните новый диалог и пройдите все ветки. Затем повторите тест с неправильным вводом.

1. Откройте бота в подключённом канале с тестового аккаунта.
2. Запустите диалог и убедитесь, что приветствие появляется один раз.
3. Нажмите каждую кнопку, сравните ответ с названием выбранной ветки.
4. Вернитесь в главное меню из каждой конечной ветки.
5. Отправьте случайную фразу и проверьте запасной ответ.
6. Повторно отправьте стартовую команду и убедитесь, что общее правило не перехватывает её.
7. Отключите одну тестовую команду, убедитесь, что изменение ожидаемо, затем верните её перед запуском.

Критерий готовности простой: все семь проверок дают ожидаемый результат два раза подряд, а тестовый пользователь ни в одной точке не остаётся без понятной кнопки или следующего действия. Это проверяемый чек-лист, а не оценка редактора на глаз.

Диагностика по симптому

• Карточка бота есть, но в мессенджере тишина: проверьте, создан ли канал и выбран ли этот бот в настройках канала.
• Открывается неправильная ветка: сравните действие кнопки и целевой сценарий.
• Старт показывает запасной ответ: поставьте событие /start* выше общего правила *.
• Кнопки исчезли после ответа: добавьте возврат в главное меню или повторный вывод нужных кнопок.
• Одно сообщение приходит дважды: ищите два события, подходящих под одно действие, и проверяйте их порядок.
• После изменения ничего не поменялось: убедитесь, что редактируете бота, который подключён к тестовому каналу, и что команда активна.

Не чините несколько симптомов одновременно. Воспроизведите один сбой, запишите входное действие, ожидаемый сценарий и фактический сценарий, затем проверьте по порядку канал, событие, команду и переход. Такая последовательность быстрее показывает уровень ошибки.

По теме: Автономные ИИ-агенты: как выбрать уровень самостоятельности

Когда Sherlock Platform не подходит

Этот способ не подходит, если у вас нет рабочего пространства Sherlock, нужен только личный бот с одной командой или вся логика уже написана в отдельном приложении. В таких случаях разумнее использовать Bot API напрямую или конструктор. Для проекта с очередями операторов, несколькими каналами и управляемыми сценариями платформа даёт единое место настройки.

Если задача связана с российским мессенджером, отдельная инструкция показывает как создать бота в MAX. Не переносите настройки между платформами буквально: названия событий, кнопок и способы подключения каналов отличаются.

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

Можно ли создать бота Sherlock без программирования?

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

Почему новый бот не отвечает в Telegram?

Чаще всего логика создана, но канал не добавлен или к нему не подключён нужный бот. После этого проверьте событие запуска и порядок правил для /start* и *.

Сколько сценариев нужно для первой версии?

Достаточно трёх: приветствие, главное меню и обработка неизвестного сообщения. Новую ветку добавляйте после того, как этот каркас проходит тест.

Можно ли скопировать готового бота?

Платформа поддерживает копирование, но перед подключением проверьте все события, ссылки, каналы и переходы. В копии могут остаться настройки исходного проекта.

Как понять, что бот готов к клиентам?

Новый тестовый пользователь должен пройти запуск, обе кнопки, возврат и неправильный ввод два раза подряд без тупика, дублей и перехода в чужую ветку.