Чат-боты

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

Количество доступных для создания ботов зависит от типа профиля: для одного ИП или юрлица доступно 5 ботов, для самозанятого — 2 бота

Чтобы создать:

1. Перейдите на платформу и выберите верифицированный профиль
2. В разделе Чат-боты → нажмите Создать
3. Заполните данные в настройках бота (его карточке) и нажмите Создать

После успешной модерации бот становится доступным для ваших пользователей, а вы можете доработать его под свой сценарий

• Через конструктор сценариев: без кода
  Доработайте бота по шаблонам конструкторов — подробнее об этом в разделе «Конструктор сценариев: без кода» — или воспользуйтесь услугами наших партнёров. Они соберут бота для проекта любой сложности и помогут подключить его к приложению
• Через API и библиотеки
  Доработайте бота самостоятельно — подробнее об этом в разделе «Разработка сценариев: с кодом». Если планируете разработку на JavaScript или Golang, воспользуйтесь разделами «Библиотека JavaScript», «Библиотека Golang»

В настоящее время пользователи могут найти любого бота в MAX по ссылке или по никнейму через поиск приложения

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

Изменить можно все настройки, кроме никнейма:

1. Перейдите на платформу MAX для партнёров в раздел Чат-боты
2. Выберите необходимого бота и нажмите →
3. Внесите изменения в разделе Основная информация и нажмите Сохранить — бот будет отправлен на повторную модерацию

Никнейм генерируется автоматически:

• Для юрлиц и ИП — по шаблону idИНН_bot, где ИНН — номер вашей организации или ИП
• Для самозанятых — по шаблону se(orgid)_bot, где orgid — идентификатор профиля на платформе

Выбрать или изменить его пока нельзя. Когда такая возможность появится, обратите внимание на требования к никнейму:

• Должен начинаться с маленькой буквы, без @
• Должен заканчиваться на «_bot» или «bot». Если не указать, к введённому вами имени бота автоматически будет добавлено «_bot»
• Длина: 11 — 60 символов, включая «_bot» / «bot»
• Допустимые символы: латиница, цифры и _

1. Перейдите на платформу MAX для партнёров в раздел Чат-боты
2. Выберите необходимого бота и нажмите ⋮ → Настройки
3. Включите или отключите возможность добавления бота в групповой чат и нажмите Сохранить. По умолчанию у созданного бота стоит запрет на его добавление в групповой чат

После успешной модерации у чат-бота появится токен — уникальный идентификатор бота, с помощью которого он будет взаимодействовать с API ботов. Наличие токена означает, что бот зарегистрирован на платформе MAX для партнёров

Для управления ботом используйте его токен:

1. Перейдите на платформу MAX для партнёров в раздел Чат-боты
2. Выберите необходимого бота и нажмите ⋮ → Настройки
3. Справа от поля с токеном нажмите на значок копирования

Поменять владельца или передать права на управление ботом пока нельзя

Чтобы добавить бота в групповой чат, сначала разрешите это в настройках бота на платформе MAX для партнёров, затем создайте чат и добавьте бота, после чего назначьте его администратором

Разрешить добавление в групповые чаты

По умолчанию добавление бота в групповые чаты запрещено. Чтобы это изменить:

1. Перейдите на платформу MAX для партнёров в раздел Чат-боты
2. Выберите необходимого бота и нажмите ⋮ → Настройки
3. Перейдите в раздел Приватность и разрешите добавление в групповые чаты

Создать групповой чат

1. Откройте приложение MAX
2. Нажмите на + в верхнем правом углу
3. Выберите Создать групповой чат
4. Выберите участников из списка и нажмите Продолжить
5. Добавьте название и фото для чата и нажмите Создать чат

Добавить бота в чат

1. Откройте созданный групповой чат
2. Нажмите на название чата вверху экрана
3. Нажмите Участники → Добавить участников
4. Найдите бота по имени и подтвердите добавление

Назначить бота администратором

1. В настройках чата откройте Администраторы
2. Нажмите Добавить администратора
3. Выберите бота и настройте права

Подробнее о добавлении бота в групповой чат — на странице «Добавление бота в чаты и каналы»

Для корректной работы бота в групповом чате рекомендуется выдать права read_all_messages и write

После удаления ваши клиенты не смогут пользоваться ботом. Удалённого бота нельзя восстановить

Чтобы удалить бота:

1. Перейдите на платформу MAX для партнёров в раздел Чат-боты
2. Выберите необходимого бота и удалите его одним из способов:
   • Либо нажмите ⋮ → Удалить
   • Либо нажмите → и в разделе Основная информация выберите Удалить чат-бот

В целях безопасности токен бота отображается на платформе частично скрытым, но вы можете его скопировать:

1. Перейдите на платформу MAX для партнёров в раздел Чат-боты
2. Выберите необходимого бота и нажмите ⋮ → Настройки
3. Справа от поля с токеном нажмите на значок копирования

1. Перейдите на платформу MAX для партнёров в раздел Чат-боты
2. Выберите необходимого бота и нажмите ⋮ → Настройки
3. Справа от поля с токеном нажмите на значок обновления

Воспользуйтесь навыком MAX Messenger Agent Skill — это набор файлов с манифестом SKILL.md, который даёт AI-агенту актуальный контекст для разработки ботов и мини-приложений под мессенджер MAX

Ищите примеры кода в разделах «Библиотека Javascript», «Библиотека Golang» или в репозитории на GitHub: JavaScript, Golang

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

Это можно сделать с помощью библиотек JavaScript и Golang. Примеры использования библиотек для работы с чат-ботом читайте в разделе «Примеры создания ботов»

Вы можете добавить команды в кнопки с типом callback, которые чат-бот будет присыаться сообщением

Пока разработчики не могут отслеживать пользовательские настройки уведомлений в чат-боте

Можно. Платформа поддерживает два типа форматирования — Markdown и HTML. Чтобы выделить информацию в сообщениях бота, например, жирным шрифтом или курсивом, отправьте параметр запроса format (enum TextFormat Nullable) — текст будет отформатирован в соответствии с указанной разметкой