Бот Секретарь - базовая логика работы
В этом руководстве мы расскажем о том как создать базовую логику своего Бота Секретаря при помощи конструктора @MenuBuilderBot.
На данном этапе, за функционирование одного Бизнес-бота взимается плата 1 Токен Групп, в остальном боты создаются и работают на общих основаниях. Модель монетизации в будущем может измениться.
ДЛЯ СВЕДЕНИЯ: функционал Ботов Секретарей (ранее Бизнес-ботов) был добавлен конструктор практически сразу после его появления в Telegram. На тот момент мы не знали насколько вам будет интересна данная опция. Поэтому реализуется она самым простым способом - практически средствами самого конструктора. Если Боты Секретари будут вызывать интерес - мы продолжим развивать эту ветку функционала. На данный момент она находится в своём зачаточном состоянии.
Особенности работы
Боты Секретари созданные при помощи конструктора @MenuBuilderBot - в своем базовом виде - реализованы посредством создания простого и понятного функционала Нижнего Меню. Вы создаёте кнопки нижнего меню и сообщения, а юзер, не видя их, взаимодействует с ними опосредовано - через инструкции которые вы можете давать им в сообщениях - указывая команды или ключевые слова.
При этом взаимодействие с нижним меню в режиме Бота Секретаря имеет свои особенности и ограничения:
● Кнопки в режиме «Только Админ» доступны юзерам только по командам.
● «Невидимые» кнопки доступны юзерам по имени.
● Названия кнопок меню рекомендовано писать в НИЖНЕМ регистре (пояснение см. ниже).
● Команды в сообщениях личных чатов НЕ отображаются - их желательно делать копируемыми внутри сообщения.
● Сообщение об ошибке (Неизвестная команда) - не показывается.
● Никакой функционал кроме сообщений не работает.
● Инлайн кнопки и нижнее меню не показывается.
● Формы (вопросы) не работают.
● Закрытые Условием кнопки и кнопки с функционалом (Action-ы, Бонусы и прочее) игнорируются.
ВАЖНО: Все отправляемые юзером сообщения принудительно приводится к нижнему регистру. Поэтому, названия кнопок меню Бизнес бота тоже необходимо писать в нижнем регистре. В этом случае будет не важно как юзер написал то или иное слово - бот его сможет правильно обработать.
❖ Создание логики бизнес бота
Подключите ваш бот к конструктору ботов MenuBuilderBot
Для того чтобы создать логику Бизнес-бота на конструкторе @MenuBuilderBot, ваш бот должен быть добавлен в качестве Меню-бота.
Как добавить ваш бот в конструктор, написано в руководстве «Создать Новый Бот».
Создание ответов бота
При написании данного руководства мы исходим из того что вы имеете представление о создании меню ботов.
Если это не так, то для начала ознакомьтесь с базовыми возможностями:
• Создание кнопок
• Добавление сообщений
• Команды
• Форматирование текста в Telegram
Подход 1
Бизнес-бот отвечает пользователю только на известные ему команды и слова.
Это самый простой вариант, как с точки зрения создания бота, так и его возможностей. Он больше всего подходит новичкам в работе с конструктором, для создания ботов с более простой логикой, а так же если вы скорее ожидаете информации от юзера, нежели предполагаете что бот будет вести юзера по жёсткому сценарию.
Для создания такого бота, добавьте в него несколько кнопок, названия которых могут служить ключевыми словами к той информации которую они содержат. В кнопки добавьте соответствующие сообщения.
Например:
Кнопка "Расписание" - может содержать сообщение с графиком вашей работы.
Таким образом если пользователь отправит в личный чат слово "Расписание" - бот ответит ему заданным в этой кнопке сообщением.
В режиме Бизнес-бота все сообщения пользователя РЕГИСТРОНЕЗАВИСИМЫ. То есть для бота не имеет значения как написано слово с большой буквы или с маленькой.
Для того чтобы первоначально сообщить юзеру доступные ему Ключевые Слова или Команды можно использовать «Приветственное Сообщение». Чтобы задать приветственное сообщение:
1. Перейдите в Настройки вашего аккаунта
2. Нажмите «Telegram для бизнеса»
3. Выберите «Приветственное Сообщение»
4. Задайте само сообщение указав в нем нужные ключевые слова.
При создании Приветственного Сообщения также можно указать и частоту его показа.
Подход 2
Бизнес-бот при помощи Ключевых Слов или Команд ведёт пользователя по заданному сценарию, реагируя сообщением по умолчанию на ЛЮБОЕ неизвестное сообщение пользователя.
Используйте данный подход если вы хотите ПОСЛЕДОВАТЕЛЬНО сообщить пользователю нужную вам информацию, однако, при этом, не подразумевается что пользователь будет писать что-то от себя - потому как на любое неизвестное боту сообщение пользователя бот будет отвечать заданным сообщением по умолчанию.
Создание ответов бота происходит аналогичным образом - как описано выше - при помощи кнопок и сообщений. Не будем отдельно на этом останавливаться.
Для того чтобы задать сообщение "по умолчанию" которое будет показано пользователю в ответ на неизвестную команду (и вернёт его в начало сценария), вам необходимо приобрести расширение для кастомизации сообщений и, в частности, неизвестного сообщения (Сообщения об Ошибке).
«33. Кастомные Сообщения»
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Кастомизация
После чего настройте команду сообщения об ошибке:☞ 🔐Админ | 🎚Кастомизация Бота | 🚯 Сообщение об Ошибке
1. Задайте своё сообщение об ошибке (без него добавление команды не доступно)
2. НЕ ОБЯЗАТЕЛЬНО - нажмите «Не показывать сообщение» чтобы включить эту опцию (её включение запретит боту показ стандартного сообщения об ошибке при наличии команды).
3. Задайте саму команду (например /main).
ВАЖНО: в Бизнес-боте не работают Системные команды типа /start и /home.
Теперь если пользователь отправит боту неизвестную команду или сообщение на которое бот не имеет ответа - бот вызовет указанную здесь команду.
Чтобы команда отработала необходимо создать кнопку с этой командой (/main) и добавить в неё сообщение которое будет являться началом вашего сценария и содержать Ключевые Слова либо Команды необходимые пользователю для начала общения с ботом.
О том как добавить команду кнопки смотри в Руководстве по Командам.
Для создания последовательного сценария в каждом последующем сообщении должны содержаться Ключевые Слова или Команды которые позволят пользователю выбрать дальнейшее направление диалога с ботом.
❖ Дополнительная информация
Кнопки меню, при желании, можно скрывать двумя способами.
1. Перевести их в режим «Только Админ», при этом сообщение кнопки будет доступно только по команде если она задана для этой кнопки.
2. Режим «Невидимая Кнопка» - в этом случае сообщение кнопки будет доступно как по её имени так и по команде если она добавлена.
Функционал Невидимых кнопок доступен в Расширениях и приобретается отдельно.
«36. Невидимые Кнопки и Сообщения»
Для подключения, перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Кнопки
Оформление Ключевых Слов и Команд
Поскольку команды в личных чатах не отображаются в виде команд и их нельзя нажимать, для удобства пользователя нужные Ключевые Слова и Команды желательно выделять копируемым текстом.
О форматировании текста в Telegram читай в руководстве по markdown.