Интеграция с Max

Для работы с функциональностью Max включите метку "Max. Регистрация заявок и оповещение команд" в интерфейсе технолога в разделе "Настройка бизнес процессов → Метки", подробнее.

Подготовка к настройке

Перед настройкой интеграции с Max необходимо зарегистрироваться в сервисе "MAX для партнеров".

Для этого:

  1. Перейдите на платформу для партнеров: https://business.max.ru.
  2. На открывшейся странице нажмите кнопку Подключить.
  3. На форме входа:

    • если у вас уже есть аккаунт — войдите в него;
    • если аккаунта нет — укажите номер телефона, к которому будет привязан бизнес-аккаунт.
  4. Если у вас еще нет профиля организации, платформа предложит создать его. Следуйте шагам на экране. При регистрации потребуется:

    • ИНН или ОГРН;
    • название организации;
    • контактные данные ответственного лица.
  5. Пройдите верификацию организации и дождитесь подтверждения (обычно 1-2 рабочих дня).

Подробнее о регистрации и верификации смотрите в документации платформы Max.

Создание бота

После прохождения верификации создайте бота:

  1. В личном кабинете платформы перейдите в раздел "Чат-боты" в левом меню.
  2. Нажмите кнопку Добавить бота.
  3. Заполнить данные бота:

    • Логотип — изображение, которое отображается как аватар чат-бота в Max.
    • Имя бота — название, которое увидят пользователи (например, "Помощник").
    • Ник — никнейм, который отображается в публичной ссылке на чат-бот. Заполняется автоматически.
    • Описание — краткое описание возможностей бота. Этот текст будет виден пользователям на карточке бота в Max (в поле "Об этом боте").
  4. Нажмите кнопку Создать — бот будет отправлен на модерацию. После ее прохождения бот станет доступен пользователям (обычно 1–2 рабочих дня).
  5. Для дальнейшей настройки получите токен бота: перейдите "Чат-боты" → "Интеграция" → "Получить токен".

    Токен отображается только один раз — обязательно сохраните его.

Настройка бота для оповещений в Max

Пользователи могут получать оповещения по заявкам в ответственности через чат в Max.

Бот может работать:

  • с конкретным пользователем (уведомления приходят в личный чат);
  • с командой (уведомления приходят в чат команды).

Подключение бота к системе

Для настройки необходимо созданного бота в Max подключить к системе, используя полученный токен.

Для этого:

  1. Перейдите: левое меню НастройкиИнтеграцииМессенджерыMax.
  2. На странице "Интеграция с Max" в блоке "Параметры бота оповещений в Max" нажмите иконку редактирования .
  3. На форме редактирования в поле "Ключ доступа" введите токен, полученный при создании бота, и нажмите кнопку Сохранить.
  4. В блоке "Параметры бота оповещений в Max" нажмите кнопку Активировать бота.

Бот для оповещений создается в единственном экземпляре и никак не связан с ботом для регистрации заявок. Данный бот нужен для информирования ответственных по их заявкам.

Настройка бота для оповещений пользователя

Чтобы пользователи, которые могут быть ответственными за заявки, получали оповещения в Max, авторизуйтесь в чате с ботом, нажав кнопку Авторизоваться.

После успешной авторизации бот отправит сообщение о том, что пользователь распознан. Далее бот будет автоматически уведомлять о новых заявках в ответственности, возобновлении заявок и комментариях к ним.

Настройка бота для оповещений в чат команды

Чтобы бот мог присылать оповещения в чат команды:

  1. Добавьте бота в чат команды в Max. После добавления бот в приветственном сообщении отправит идентификатор чата команды.
  2. В карточке команды в блоке "Дополнительно" нажмите кнопку Редактировать.

  3. На форме редактирования в поле "Идентификатор чата команды в Max" укажите идентификатор, полученный при добавлении бота в чат команды, и нажмите кнопку Сохранить.

    Идентификатор должен быть проставлен обязательно с символом "-" в начале.