Чат-боты
Создание
Как создать бота?
Вы можете создать чат-бот, только если у вас есть верифицированный профиль организации, ИП или самозанятого
Количество доступных для создания ботов зависит от типа профиля: для одного ИП или юрлица доступно 5 ботов, для самозанятого — 2 бота
Чтобы создать:
- Перейдите на платформу и выберите верифицированный профиль
- В разделе Чат-боты → нажмите Создать
- Заполните данные в настройках бота (его карточке) и нажмите Создать
После успешной модерации бот становится доступным для ваших пользователей, а вы можете доработать его под свой сценарий
- Через конструктор сценариев: без кода
Доработайте бота по шаблонам конструкторов — подробнее об этом в разделе «Конструктор сценариев: без кода» — или воспользуйтесь услугами наших партнёров. Они соберут бота для проекта любой сложности и помогут подключить его к приложению - Через API и библиотеки
Доработайте бота самостоятельно — подробнее об этом в разделе «Разработка сценариев: с кодом». Если планируете разработку на JavaScript или Golang, воспользуйтесь разделами «Библиотека JavaScript», «Библиотека Golang»
Можно ли сделать непубличного бота?
В настоящее время пользователи могут найти любого бота в MAX по ссылке или по никнейму через поиск приложения
Настройка и управление
Как изменить имя, аватар, описание и другие настройки бота?
Вы можете изменить настройки бота только после прохождения модерации. Если вы не хотите дожидаться её окончания, удалите бота и создайте нового с теми настройками, которые вам нужны
Изменить можно все настройки, кроме никнейма:
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите →
- Внесите изменения в разделе Основная информация и нажмите Сохранить — бот будет отправлен на повторную модерацию
Есть ли ограничения для никнейма и имени бота?
Никнейм генерируется автоматически:
- Для юрлиц и ИП — по шаблону
idИНН_bot, где ИНН — номер вашей организации или ИП - Для самозанятых — по шаблону
se(orgid)_bot, гдеorgid— идентификатор профиля на платформе
Выбрать или изменить его пока нельзя. Когда такая возможность появится, обратите внимание на требования к никнейму:
- Должен начинаться с маленькой буквы, без
@ - Должен заканчиваться на «_bot» или «bot». Если не указать, к введённому вами имени бота автоматически будет добавлено «_bot»
- Длина: 11 — 60 символов, включая «_bot» / «bot»
- Допустимые символы: латиница, цифры и
_
Как разрешить или запретить добавление бота в групповой чат?
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите ⋮ → Настройки
- Включите или отключите возможность добавления бота в групповой чат и нажмите Сохранить. По умолчанию у созданного бота стоит запрет на его добавление в групповой чат
Как управлять ботом в MAX?
После успешной модерации у чат-бота появится токен — уникальный идентификатор бота, с помощью которого он будет взаимодействовать с API ботов. Наличие токена означает, что бот зарегистрирован на платформе MAX для партнёров
Для управления ботом используйте его токен:
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите ⋮ → Настройки
- Справа от поля с токеном нажмите на значок копирования
Можно ли поменять владельца бота?
Поменять владельца или передать права на управление ботом пока нельзя
Как удалить бота?
После удаления ваши клиенты не смогут пользоваться ботом. Удалённого бота нельзя восстановить
Чтобы удалить бота:
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и удалите его одним из способов:
- Либо нажмите ⋮ → Удалить
- Либо нажмите → и в разделе Основная информация выберите Удалить чат-бот
Токен бота
Как посмотреть токен бота?
В целях безопасности токен бота отображается на платформе частично скрытым, но вы можете его скопировать:
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите ⋮ → Настройки
- Справа от поля с токеном нажмите на значок копирования
Как обновить токен бота?
- Перейдите на платформу MAX для партнёров в раздел Чат-боты
- Выберите необходимого бота и нажмите ⋮ → Настройки
- Справа от поля с токеном нажмите на значок обновления
Разработка
Где я могу найти примеры кода?
Ищите примеры кода в разделах «Библиотека Javascript», «Библиотека Golang» или в репозитории на GitHub: JavaScript, Golang
Есть ли у чат-ботов в MAX команды по умолчанию, предзаданные платформой?
Нет, разработчики могут самостоятельно задавать любые команды ботов. Можно настроить логику сценариев работы вашего чат-бота так, чтобы он выполнял необходимые вам действия в ответ на команды или слова, отправленные в чат
Это можно сделать с помощью библиотек JavaScript и Golang. Примеры использования библиотек для работы с чат-ботом читайте в разделе «Примеры создания ботов»
Вы можете добавить команды в кнопки с типом callback, которые чат-бот будет присылать сообщением
Как узнать, получают ли пользователи уведомления от чат-бота?
Пока разработчики не могут отслеживать пользовательские настройки уведомлений в чат-боте
Можно ли форматировать текст в сообщениях бота?
Можно. Платформа поддерживает два типа форматирования — Markdown и HTML. Чтобы выделить информацию в сообщениях бота, например, жирным шрифтом или курсивом, отправьте параметр запроса format (enum TextFormat Nullable) — текст будет отформатирован в соответствии с указанной разметкой