1.⠀Предварительные условия подключения мессенджера MAX

Возможность создания ботов в мессенджере MAX предоставляются только зарегистрированным юридическим лицам. Перед началом интеграционных работ ваша компания должна быть зарегистрирована в системе MAX как организация с заполненными реквизитами:

  • ИНН (обязательный первичный ключ контрагента);
  • КПП, ОГРН, юридический адрес (в зависимости от тарифа и объема прав).

Без завершенной регистрации юридического лица функционал создания ботов и отправки сообщений в чаты/каналы недоступен. Процедура регистрации проводится через личный кабинет или менеджера MAX до начала технических работ.

Более подробно вы можете ознакомиться с инструкцией MAX для бизнеса https://dev.max.ru/docs/maxbusiness/connection.

2.⠀Раздел «Мессенджер MAX»

Интеграция с мессенджером MAX позволяет получать уведомления о событиях, происходящих в системе, непосредственно в выбранный чат. После подключения интеграции можно настроить, о каких событиях будут приходить уведомления: о новых заказах, изменении статусов заказов и других доступных событиях.

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

Для настройки интеграции в левом меню откройте раздел «Интеграции» и выберите подстраницу «Интеграция с MAX» (рис.1).

Рисунок 1. Раздел «Интеграция с MAX» в панели навигации

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

3.Подключение интеграции

Для получения уведомлений необходимо сначала подключить интеграцию с MAX (рис.2).

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

Рисунок 2-2.1. Страница «Интеграция с MAX»

Введите данные, необходимые для подключения:

  • Токен бота — уникальный токен, полученный при создании бота в MAX.
  • ID чата — идентификатор чата/канала, в который будут отправляться уведомления.

Поля являются обязательными для заполнения.

После заполнения всех полей нажмите кнопку «Сохранить».

Во время сохранения система проверяет корректность введенных данных.

Проверьте, что:

  • заполнены все обязательные поля;
  • указан действующий токен бота;
  • указан корректный ID чата.

Если одно из условий не выполнено, система сообщит об ошибке и не сохранит настройки. После исправления данных нажмите «Сохранить» повторно.

Если введенные данные корректны, система сохранит настройки, после чего интеграция станет активной. С этого момента можно перейти к настройке уведомлений.

Отключение интеграции

Если необходимость получать уведомления в MAX отпала, интеграцию можно отключить.

Для этого:

  1. Переведите переключатель «Интеграция с MAX» в неактивное положение.
  2. Нажмите «Сохранить».

После сохранения уведомления в MAX отправляться не будут.

4. Выбор уведомлений

После успешного подключения интеграции можно выбрать, какие уведомления будут поступать в чат MAX.

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

Например:

  • новые заказы
  • изменение статусов заказов.

Активируйте тумблер "Уведомления о новых заказах", чтобы получать в мессенджере информацию только о новых заказах. Если вы хотите получать уведомления об изменении статусов заказов, станет доступен список статусов. Отметьте только те статусы, по которым необходимо получать уведомления. Например, можно получать уведомления только о новых заказах и заказах, готовых к выдаче, исключив остальные статусы.

После выбора необходимых статусов нажмите кнопку «Сохранить».


Если вы внесли изменения в доступные для редактирования поля, но не сохранили их и пытаетесь закрыть страницу, система отобразит модальное окно с текстом: «Вы уверены, что хотите покинуть страницу? Внесённые изменения не сохранятся.» В этом окне вы можете нажать «Отмена», чтобы остаться на странице и продолжить редактирование, или «Покинуть без сохранения», чтобы закрыть страницу без сохранения изменений. Модальное окно не появляется, если изменения не вносились (рис.3).

После внесения необходимых изменений нажмите кнопку «Сохранить». При успешном сохранении система покажет уведомление об успешном сохранении.

Рисунок 3. Выход из режима редактирования

5. Получение уведомлений о заказах в MAX

При включенной интеграции с MAX пользователю автоматически отправляются уведомления о новых заказах.

После создания нового заказа в MAX отправляется сообщение с информацией о заказе:

  • ресторан;
  • точка;
  • дата и время создания заказа;
  • номер заказа;
  • тип заказа;
  • время доставки, если заказ с доставкой;
  • ссылка на заказ в админ-панели.

В сообщении доступна ссылка на конкретный заказ.

При переходе по ссылке пользователь попадает непосредственно в карточку соответствующего заказа в админ-панели.

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

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

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