Инструкция модуля интеграции
Max PRO

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

Как создать рассылку

Нажмите Новая рассылка и заполните форму:
Название — для вашего удобства, клиент его не видит.
Сообщение — текст. Можно подставлять данные клиента: имя, фамилия, телефон, сумма заказов. Нажмите на подсказку под полем, чтобы вставить нужную вставку в текст.
Предпросмотр — показывает, как сообщение будет выглядеть с подставленными данными (на примере вымышленного клиента).
Запланировать на — дата и время отправки. Если поле пустое, рассылка сохранится как черновик и будет ждать ручного запуска.

Кому отправить:
Всем клиентам — всем, кто есть в базе бота;
Отдельным клиентам — выбираете вручную, поиск работает по имени и телефону;
По сегментам — сегменты подтягиваются из RetailCRM. Сообщение получат те клиенты сегмента, которые есть в базе бота.

Тип рассылки:
Через CRM — сообщения видны в чатах RetailCRM, старые диалоги поднимутся наверх. Подходит, когда после рассылки ожидаются ответы клиентов.
Напрямую через MAX — быстрее, но сообщения не отображаются в CRM и диалоги не поднимаются. Подходит для информационных рассылок.
Картинка (URL) — одна картинка по ссылке.
Кнопки — текст и ссылка. Кнопок можно добавить несколько; кнопки без текста или без ссылки не сохраняются.
Нажмите Создать.

Как запустить и проконтролировать

В списке рассылок видны название, тип, статус, прогресс и время запланированной отправки.
Запустить — отправка начинается немедленно, не дожидаясь запланированного времени.
Изменить — доступно только для рассылок, которые ещё не запускались (черновик, запланирована, отменена).
Удалить — убирает рассылку из списка.
Статистика — для запущенных и завершённых: сколько всего получателей, сколько отправлено, сколько ошибок, время начала и окончания.

Статусы рассылки: Черновик, Запланирована, Выполняется, Завершена, Отменена, Ошибка. Пока рассылка выполняется, прогресс на экране обновляется автоматически.

Особенности:
Запланированные рассылки проверяются примерно раз в минуту, поэтому отправка может начаться на минуту позже указанного времени — это нормально.
Время указывается по часовому поясу вашего компьютера.
Запущенную или завершённую рассылку изменить нельзя — только посмотреть статистику или удалить.
Сообщения отправляются пачками с ограничением скорости на стороне MAX, поэтому большая рассылка идёт постепенно, а не мгновенно.
Клиенты, которые заблокировали бота или недоступны, попадут в счётчик ошибок — это не сбой модуля.

РАССЫЛКИ

Вкладка Рассылки позволяет отправлять сообщения клиентам бота.
В правом верхнем углу показаны два счётчика:
Всего клиентов — сколько клиентов есть в базе бота;
Активных — сколько из них прошли регистрацию.

Важно: рассылку получат только те, кто уже писал вашему боту. Отправить сообщение всей базе RetailCRM через бота нельзя — у клиента, который никогда не открывал бота, просто нет чата с ним.

Шаг 8. Сайт

Раздел связывает бота с вашим сайтом на RetailCRM: клиент переходит из бота на сайт и оказывается там уже авторизованным, без ввода логина и пароля.
В поле Ссылка на сайт укажите адрес вашего сайта (например, Retailcrmtestsite.retailcrm.site ) и нажмите Сохранить. Именно этот адрес откроется по кнопке «Открыть магазин».

Скопируйте первый блок кода и вставьте его в раздел head в настройках сайта RetailCRM.
Скопируйте второй блок кода и вставьте его в раздел body в настройках сайта RetailCRM.
Сохраните настройки сайта в RetailCRM.
Оба блока кода готовы к вставке — менять в них ничего не нужно, идентификаторы вашего подключения уже подставлены.

Как это работает. При переходе из бота в адресе страницы передаётся идентификатор клиента в MAX. Скрипт запрашивает у модуля учётные данные клиента и авторизует его на сайте. Если что-то пошло не так, скрипт просто ничего не делает — сайт открывается как обычно, клиент может войти вручную.

Шаг 6. Бонусы

Раздел отвечает за бонусы, которые клиент получает за действия в боте. Все начисления идут в программу лояльности RetailCRM и видны в истории операций клиента.

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

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

Сбор e-mail
Запрашивать e-mail при регистрации — после того как клиент поделился контактом, бот попросит ввести e-mail и запишет его в карточку клиента RetailCRM.
Адрес проверяется на формат. Если клиент ввёл что-то не то, бот попросит повторить.

Проверка дня рождения
Переключатель и размер вознаграждения — сколько баллов клиент получает за указание даты рождения.
После регистрации в меню появляется кнопка «🎂 Указать день рождения». Дата вводится в формате ДД.ММ.ГГГГ и записывается в карточку клиента в RetailCRM.
Бонус начисляется один раз.

Нажмите Сохранить.

Шаг 7. QR

Раздел задаёт, что зашивается в персональный QR-код клиента.
Тип QR кода:
Ссылка — QR содержит ссылку;
Объект — QR содержит набор данных, который вы отмечаете переключателями ниже.
Данные в QR (для типа «Объект»): ссылка на профиль клиента в RetailCRM, идентификатор клиента, ссылка на участие в программе лояльности, имя, фамилия, телефон, идентификатор клиента в MAX, заказы, готовые к выдаче.
Статус готовности к выдаче — появляется, если включён пункт «Заказы, готовые к выдаче». Выберите статус заказа из RetailCRM, который у вас означает «готов к выдаче».
Нажмите Сохранить.

Шаг 5. Оформление — меню бота

Здесь вы собираете меню, которое видит клиент. Доступны пять кнопок (описание что делает кнопка ниже):
1) Открыть магазин: Ссылка на ваш сайт
2) Профиль покупателя: Имя, телефон, e-mail, идентификатор в CRM
3) Действия с баллами: История начислений и списаний бонусов
4) Список заказов: Заказы клиента с возможностью открыть любой
5) Вызов оператора: Передаёт диалог оператору в RetailCRM

Для каждой кнопки настраивается:
Переключатель — показывать кнопку или нет. Выключенной кнопки в меню просто не будет.
Текст кнопки — что написано на самой кнопке.
Описание в приветственном сообщении — короткое пояснение, зачем нужна кнопка (доступно для профиля, заказов, баллов и оператора).
Нажмите Сохранить.

Обратите внимание! Кнопка «Открыть магазин» появится в меню только после того, как вы заполните ссылку на сайт в разделе Сайт. Кнопка «Действия с баллами» имеет смысл только при включённой лояльности.

Шаг 4. Транспорт — чат с оператором в RetailCRM

Раздел включает двустороннюю переписку: клиент пишет боту в MAX, оператор отвечает из чатов RetailCRM.
Включить транспорт — главный переключатель раздела.
Транспортный токен и Токен mgBot — появляется автоматически.
Название транспортного канала — как канал будет называться в RetailCRM. Заполняете вы.
Идентификатор транспортного канала — появляется автоматически после регистрации канала.
Порядок действий:
Включите переключатель Включить транспорт.
Убедитесь, что транспортный токен подставился.
Введите название канала.
Нажмите Зарегистрировать канал. Кнопка появляется только тогда, когда токен есть, а канал ещё не зарегистрирован. После успешной регистрации в поле «Идентификатор транспортного канала» появится номер.
Нажмите Сохранить.

Шаг 3. Лояльность

Раздел отвечает за то, видит ли клиент свои бонусные баллы.
Доступ к информации о программе лояльности — главный переключатель раздела. Пока он выключен, бот отвечает «Программа лояльности недоступна», а бонусные счета при регистрации не создаются.
Размер страницы при выводе операций — сколько операций с баллами показывать на странице: 5, 10 или 15.
Нажмите Сохранить.

Как это работает. При регистрации модуль ищет бонусный счёт клиента в RetailCRM по телефону, затем по идентификатору клиента. Если счёта нет — создаёт новый. Если у клиента по какой-то причине счёта нет, бот честно сообщит: «У вас нет бонусного счёта».

Шаг 2. Основные настройки

Это единственный обязательный раздел — без него бот не заработает.
Название магазина (обязательно) — как подключение будет называться в вашем списке. На то, что видит клиент, не влияет.
Токен (обязательно) — токен вашего бота из MAX. Именно по нему модуль управляет ботом.
Магазин в RetailCRM — магазин (сайт), к которому будут привязываться новые клиенты. Список подставляется из вашей CRM.
Размер страницы при выводе заказов — сколько заказов клиент видит на одной странице списка: 5, 10 или 15. Остальные открываются кнопками «Вперёд» / «Назад».
Приветственное сообщение — первое, что видит клиент. Именно к нему прикрепляется кнопка «Поделиться контактом», поэтому в тексте стоит объяснить, зачем нужен номер телефона.
Запрашивать разрешение на обработку данных — если включить, появятся два поля: ссылка на пользовательское соглашение и ссылка на политику конфиденциальности.
Нажмите Сохранить.

Обратите внимание! Если «Магазин в RetailCRM» не выбран, модуль не сможет создать нового клиента: существующие клиенты найдутся по телефону, а новые получат сообщение об ошибке регистрации. Это самая частая причина проблем на старте.

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

Как работает модуль
Клиент открывает вашего бота в MAX и нажимает «Старт».
Бот показывает приветственное сообщение и просит поделиться контактом.
Модуль ищет клиента в RetailCRM по номеру телефона: если находит — обновляет карточку, если нет — создаёт нового клиента. При включённой лояльности заводит бонусный счёт.
Клиент видит меню: профиль, заказы, действия с баллами, вызов оператора, переход в магазин.
Набор кнопок вы настраиваете сами.
Данные подтягиваются из RetailCRM в момент нажатия кнопки — клиент всегда видит актуальную информацию.
Если включён транспорт, сообщения клиента приходят оператору в чаты RetailCRM, а ответы оператора уходят клиенту в MAX.
Из кабинета Radis вы можете отправлять клиентам бота рассылки — сразу или по расписанию.

Перед началом работы
Для успешной настройки вам понадобятся:
Бот в мессенджере MAX и его токен. Токен выдаётся при создании бота в MAX — его нужно будет вставить в настройки модуля.

Как устроены настройки
Работа начинается со списка ботов. Один бот = одно подключение = один MAX-бот. Ботов может быть несколько — например, по одному на каждый магазин.
Настройки одного бота разделены на разделы: Основные, Лояльность, Транспорт, Оформление, QR, Бонусы, Сайт. Отдельно есть вкладка Рассылки.

Три важных особенности:
Каждый раздел сохраняется отдельно. Кнопка «Сохранить» есть в каждом разделе и сохраняет только его. Перешли в другой раздел, не сохранив — изменения потеряются.
После сохранения бот перезапускается автоматически. Это занимает несколько секунд, никаких дополнительных действий не требуется. Новые настройки начинают действовать сразу.
Пока не сохранены Основные настройки, остальные разделы недоступны.
При попытке перейти появится сообщение «Сохраните основные настройки для перехода далее».
Это нормально: у бота ещё нет карточки, к которой можно привязать остальные настройки.

Шаг 1. Создайте бота

Откройте модуль MAX pro в личном кабинете Radis.
Нажмите Добавить бота.
Заполните Основные настройки (см. следующий шаг).
Нажмите Сохранить.
После сохранения бот появится в списке с названием и идентификатором. Чтобы вернуться к его настройкам позже, нажмите на строку в списке или кнопку Редактировать.
Кнопка Удалить убирает подключение полностью — бот перестанет отвечать клиентам. Действие необратимо, данные настроек не восстанавливаются.

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