Инструкция по интеграции с Макс ботом

Инструкция по интеграции с ботом Max

На текущий момент интеграция с ботом Max используется для отправки уведомлений из системы А2Б. Чтобы получать уведомления в Max, выполните следующие шаги.

Облачная версия

В облачной версии А2Б используется общий бот Max. Отдельно создавать своего бота и получать API-ключ не требуется.

Включение интеграции на уровне компании

Для доступа к настройкам интеграции войдите в аккаунт с правами главного администратора или администратора кабинета компании. Затем кликните на название вашей компании и перейдите во вкладку «Настройка интеграции».

В блоке Max нажмите кнопку «Подключить».

Включение уведомлений для пользователя

После подключения интеграции в настройках компании у каждого пользователя в разделе «Персональные настройки» появится чекбокс «Включить уведомления в Max».

Привязка аккаунта Max

После активации чекбокса отобразится индивидуальная ссылка и QR-код. Перейдите по ссылке или откройте QR-код с мобильного устройства. Откроется чат с ботом в Max, где нужно будет нажать «Начать работу». После запуска бота ваш аккаунт Max будет связан с аккаунтом в системе А2Б.

Получение уведомлений

После привязки аккаунтов все уведомления, отмеченные в системе как push-уведомления, будут автоматически отправляться вам в Max через бота.

Коробочная версия

В коробочной версии используется ваш собственный бот Max.

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

Сначала необходимо создать бота на платформе Max для партнёров.

Важно: по текущим правилам Max создание ботов доступно только для организаций с верифицированным профилем на платформе партнёров.

Получение API-ключа

После создания бота получите API-ключ в кабинете платформы Max для партнёров в разделе «Интеграция» → «Получить токен».

Добавление API-ключа в А2Б

Для доступа к настройкам интеграции войдите в аккаунт с правами главного администратора или администратора кабинета компании. Затем кликните на название вашей компании и перейдите во вкладку «Настройка интеграции».

В блоке Max:

Включение уведомлений для пользователя

После добавления API-ключа в настройках компании у каждого пользователя в разделе «Персональные настройки» появится чекбокс «Включить уведомления в Max».

Привязка аккаунта Max

После активации чекбокса отобразится индивидуальная ссылка и QR-код. Перейдите по ссылке или откройте QR-код с мобильного устройства. Откроется чат с ботом в Max, где нужно будет нажать «Начать работу». После запуска бота ваш аккаунт Max будет связан с аккаунтом в системе А2Б.

Получение уведомлений

После привязки аккаунтов все уведомления, отмеченные в системе как push-уведомления, будут автоматически отправляться вам в Max через бота.

Важно

Для боевого использования Max требует Webhook, а для Webhook поддерживается только HTTPS.

Поэтому в коробочной версии у А2Б должен быть доступный по HTTPS домен, и endpoint https://[ваш_домен]/api/login/max/webhook/* должен быть доступен из интернета серверу Макса.