Граница задачи
За что отвечает конструктор
Конструктор Telegram-ботов не заменяет регистрацию бота в Telegram. Он нужен после неё: чтобы задать, что произойдёт, когда человек нажмёт Start, выберет кнопку, отправит текст или попросит помощи. Такой порядок полезен тем, что учётная запись бота остаётся на стороне Telegram, а логика общения находится в отдельной панели, доступной команде.
В MultiBot Hub сценарий собирается в визуальном Flow Engine на React Flow. В документации проекта описаны узлы сообщений, ввода, условий, задержек, проверки подписки, запроса телефона и создания заявки. Схема компилируется в последовательность шагов, поэтому до запуска можно увидеть ветки и проверить, куда ведёт каждый ответ. Для короткого бота достаточно приветствия и пары кнопок; для записи или поддержки понадобятся условия, поля и передача обращения в тикет.
Не стоит начинать со списка функций. Сначала сформулируйте одну задачу посетителя: получить материал, уточнить услугу, оставить контакт или написать оператору. Если в одном первом сообщении одновременно предлагают каталог, консультацию, оплату и десяток разделов, человек часто не понимает, что выбрать. Лучше сделать первый шаг коротким и дать понятный маршрут дальше.
Сначала Telegram
Регистрация бота и подключение токена
У Telegram бот является отдельной учётной записью. Официальная документация предлагает создать его через @BotFather: он зарегистрирует бота и выдаст токен для доступа к Bot API. Этот токен даёт полный контроль над ботом, поэтому его не отправляют в общий чат, не вставляют в инструкцию и не публикуют в репозитории.
Опишите первое действие пользователя
Например: после команды /start показать два варианта, а после выбора собрать вопрос для команды.
Создайте бота в BotFather
Задайте имя и username, получите токен и сохраните его в защищённом месте, доступном только тем, кто подключает бота.
Добавьте бота в MultiBot Hub
В разделе управления ботами вставьте токен и завершите подключение. Панель использует его, чтобы получать события и отправлять ответы по вашему сценарию.
Соберите черновик до публикации ссылки
Настройте первый сценарий и проверьте его в личном чате, прежде чем вести в бота клиентов из рекламы, сайта или рассылки.
Один путь, затем ветки
Как собрать первый сценарий
Практичный первый сценарий состоит из приветствия, вопроса и следующего действия. В приветствии скажите, что бот умеет, и предложите две-три конкретные кнопки. Каждая кнопка должна вести к отдельному узлу. Так человеку не приходится угадывать, какие слова написать, а команде проще увидеть, какой путь требует доработки.
Допустим, бот школы отвечает на Start. Первая кнопка ведёт к программе, вторая открывает форму вопроса, третья просит оставить телефон. Узел ввода сохраняет ответ для этого диалога, условие проверяет, заполнено ли поле, а узел создания заявки передаёт обращение в работу. Когда нужна пауза, добавьте задержку; когда нужно продолжить после пользовательского выбора, используйте ветку кнопки, а не несколько почти одинаковых сообщений.
У узлов есть ограничения платформы. Например, запрос контакта в текущем Flow Engine использует нативную кнопку Telegram и предназначен для соответствующего формата чата. Проверку подписки лучше добавлять только там, где она действительно влияет на следующий шаг. Сценарий становится надёжнее, когда каждое условие отвечает на деловой вопрос, а не служит украшением схемы.
Не смешивайте задачи
Где заканчивается сценарий и начинаются другие процессы
Сценарий отвечает на действие внутри одного диалога. Рассылка решает другую задачу: она создаётся отдельно, может сегментироваться, планироваться, редактироваться и копироваться. Эти возможности перечислены в README проекта, но отправка не отменяет правила Telegram: бот не может первым начать личный диалог с пользователем. Сначала человек должен написать боту, открыть его по ссылке или добавить в группу.
Заявка тоже не обязана быть частью каждой ветки. Её имеет смысл создавать, когда запрос нужно передать человеку, зафиксировать тему и назначить ответственного. В проекте заявки работают поверх саппорт-топика и могут появляться из сообщений или команды /support. Для обычного ответа на частый вопрос достаточно сообщения и кнопки возврата в меню.
Если компания ведёт несколько Telegram- и MAX-ботов, они подключаются в одной панели, но у каждого остаются свои сценарии, пользователи и входящие события. Это помогает не переносить логику руками между разными кабинетами и не путать бота магазина с ботом отдельного направления.
Короткий контроль
Проверка перед запуском
- Команда /start ведёт к понятному первому сообщению, а не к пустой ветке.
- У каждой кнопки есть действие и понятный способ вернуться в меню.
- Текст поля и вопроса объясняют, какие данные человек оставляет и зачем.
- Ветку с заявкой проверили отдельно: обращение не создаётся повторно из-за двух одинаковых шагов.
- Токен не попал в скриншоты, документацию, публичный код или переписку без ограниченного доступа.
- Тест проведён с обычного пользовательского аккаунта, а не только по схеме в редакторе.
После такой проверки можно дать ссылку на бота небольшой группе пользователей и посмотреть, на каком вопросе люди останавливаются. Если ответ повторяется, поправьте текст или добавьте кнопку. Если запрос требует участия команды, направьте его в заявку. Это даёт понятные изменения сценария вместо бесконечного расширения стартового сообщения.