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