Пошаговое подключение модуля Max

Скопировать ссылку на статью

Скопировано

Содержание

1. Приоритетный способ регистрации и верификации
2. Шаг 1: Регистрация и создание бота в MAX
3. Шаг 2: Получение токена
4. Редактирование и удаление бота
5. Шаг 3: Подключение транспорта
6. Ограничения на отправку файлов

MAX - это современный мессенджер, который открывает новые возможности для взаимодействия с клиентами. Интеграция с вашей платформой позволит наладить быструю и удобную коммуникацию с пользователями.

Приоритетный способ регистрации и верификации

Для регистрации и верификации организации в MAX рекомендуется использовать партнерский диплинк, который доступен в модуле MAX при подключении бота. Переход по этой ссылке позволяет юридическим лицам пройти регистрацию, верификацию и создать чат-бота без ограничений, связанных с реестром МСП.рф или RuStore.

1. Перейдите в раздел «Маркетплейс» в RetailCRM → выберите модуль «MAX» → «Перейти в личный кабинет».
2. В окне подключения бота перейдите по партнерской ссылке.
3. На стороне MAX пройдите регистрацию, верификацию организации и создайте чат-бота.
4. После создания чат-бота получите токен и завершите подключение в RetailCRM.

Примечание

Партнерский диплинк отображается в интерфейсе подключения модуля MAX и является приоритетным способом подключения.

Шаг 1: Регистрация и создание бота в MAX

Первый этап — создание и настройка чат-бота на стороне платформы MAX. Для этого необходимо подключиться к платформе MAX для партнёров и создать верифицированный профиль юридического лица, ИП или самозанятого — резидента РФ.

Что нужно сделать:

1. Зарегистрируйтесь на платформе MAX для партнёров. Перейдите по ссылке «Создание профиля организации, ИП или самозанятого» и следуйте инструкции. Рекомендуется использовать корпоративную электронную почту.
2. Создайте и верифицируйте профиль. После успешной верификации профиля станет доступно создание чат-ботов.
3. Создайте чат-бота. В профиле на платформе MAX для партнёров перейдите в раздел «Чат-боты» и нажмите «Создать». Заполните карточку бота: загрузите логотип, укажите название и описание. Никнейм формируется автоматически на основе данных профиля и в дальнейшем не изменяется.

4. Нажмите «Создать» и дождитесь модерации. Проверка занимает до 48 часов по рабочим дням. После успешной модерации бот получит статус «Создан», станет доступен пользователям MAX, а в настройках появится токен доступа.

Шаг 2: Получение токена

После успешной модерации чат-бота формируется токен — уникальный ключ, необходимый для подключения бота к RetailCRM.

Чтобы скопировать токен:

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

3. Справа от поля «Токен доступа» нажмите на значок копирования.

Важно!

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

Редактирование и удаление бота

Чтобы изменить данные бота, перейдите в раздел «Чат-боты», выберите нужного бота и нажмите на стрелку в его карточке. В разделе «Основная информация» внесите изменения и нажмите «Сохранить».

Примечание

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

Удалить бота можно в разделе «Чат-боты» через меню ⋮ → «Удалить» или кнопкой «Удалить чат-бот» в разделе «Основная информация». После удаления клиенты не смогут пользоваться ботом, восстановить его будет невозможно.

Шаг 3: Подключение транспорта

Теперь, когда у вас есть токен, осталось сделать последний шаг - подключить мессенджер к нашей системе.

1. Перейдите в раздел «Маркетплейс» в RetailCRM → выберите модуль «MAX» → «Перейти в личный кабинет»
   
   
   

2. Нажмите «Добавить бота» → вставьте скопированный токен вашего бота в поле «Токен» и нажмите кнопку «Добавить»
   

Примечание

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

Готово! Если вы все сделали правильно, интеграция будет активирована, и вы сможете начать общение с вашими клиентами через мессенджер MAX.

Ограничения на отправку файлов

MAX поддерживает отправку вложений, однако фактические ограничения зависят от ограничений канала и ограничений RetailCRM.

• На стороне MAX при загрузке файла через multipart/form-data заявлен максимальный размер до 4 ГБ на файл.
• В интеграции RetailCRM отправка вложений выполняется через multipart-загрузку, при этом действуют общие ограничения чатов RetailCRM: 1 файл (и до 10 изображений) за сообщение и суммарно до 500 Мб вложений.

Если нужно отправить файл большего размера, удобнее передать его ссылкой (например, на облачное хранилище).