Инструкция
Как создать бота в MAX и получить токен
Для подключения бота к приложению «Уведомления в Max» необходимо предварительно создать бота в мессенджере MAX и получить его токен доступа.
Токен потребуется на этапе подключения бота к приложению. Он является уникальным ключом, с помощью которого приложение получает возможность работать с ботом и отправлять сообщения от его имени.
1. Создайте аккаунт для работы с ботами
Для создания бота необходимо авторизоваться на платформе MAX для бизнеса и разработчиков (https://business.max.ru/).
Перейдите на официальный сайт MAX и войдите в аккаунт. Если аккаунта еще нет, зарегистрируйтесь и пройдите необходимую процедуру подтверждения.
После авторизации можно переходить к созданию чат-бота.
2. Создайте нового бота
В личном кабинете найдите раздел, предназначенный для управления чат-ботами, и выберите создание нового бота.
При создании необходимо указать основные сведения, которые будут отображаться пользователям MAX:
- название бота;
- изображение (логотип);
- описание;
- сайт — при необходимости;
- контактные данные.
Название рекомендуется сделать понятным и соответствующим назначению бота.
Для изображения используется квадратный логотип. Рекомендуемый размер — 500 × 500 пикселей. Поддерживаются форматы JPG, JPEG и PNG, максимальный размер файла — 5 МБ.
В описании кратко укажите назначение бота и его основные возможности.
3. Сохраните и отправьте бота на проверку
После заполнения информации сохраните карточку бота и отправьте ее на проверку.
До завершения проверки бот может быть недоступен для полноценного использования, поэтому подключать его к «Уведомлениям в Max» рекомендуется после прохождения модерации.
Если бот не пройдет проверку, необходимо ознакомиться с причиной отклонения, внести изменения и повторно отправить его на модерацию.
4. Настройте доступ к групповым чатам
Если планируется использовать бота не только для личных сообщений, но и для отправки уведомлений в групповые чаты, необходимо разрешить добавление бота в группы.
Откройте настройки созданного бота и найдите параметр, отвечающий за возможность добавления в групповые чаты.
Включите соответствующий доступ и сохраните изменения.
После этого бота можно будет добавлять в необходимые групповые чаты MAX и использовать его для отправки уведомлений через «Уведомления в Max».
5. Получите токен бота
После успешного прохождения проверки откройте настройки созданного бота.
В расширенных настройках найдите раздел с токеном доступа и скопируйте его.
Токен необходимо сохранить в надежном месте и не передавать посторонним.
Токен является ключом доступа к боту. С его помощью внешнее приложение может взаимодействовать с ботом и отправлять сообщения от его имени.
Если токен был случайно раскрыт или есть подозрение, что его получили посторонние, рекомендуется сгенерировать новый токен. После обновления старый токен перестанет использоваться.
6. Подключите бота к приложению «Уведомления в Max»
Полученный токен используется для подключения созданного бота к приложению «Уведомления в Max».
В настройках приложения укажите токен бота и выполните подключение.
После успешного подключения бот можно использовать для отправки уведомлений из Битрикс24 пользователям и в групповые чаты MAX — в соответствии с возможностями настроенной интеграции.
Что потребуется для подключения
Перед настройкой «Уведомлений в Max» убедитесь, что у вас есть:
- Созданный и прошедший проверку бот в MAX.
- Токен этого бота.
- Разрешение на добавление бота в групповые чаты — если планируется отправка сообщений в группы.
После этого можно переходить к настройке бота в приложении.