Первичная настройка модуля
Когда вы подключите модуль, вам будет предложено настроить несколько соответствий — вы можете заполнять их по мере необходимости, модуль начинате работать сразу после заполнения каждого из шагов, он запоминает, где вы остановились.
Ниже рассказываем, что и зачем нужно вводить.
Ниже рассказываем, что и зачем нужно вводить.
Шаг 1. Ввод данных для интеграции
Чтобы интеграция заработала, вам нужно ввести данные для доступа к OSMI Cards — они приходят на почту после регистрации личного кабинета. Если у вас еще нет аккаунта в OSMI Cards, вы можете оставить заявку на подключение прямо на странице модуля.
После ввода данных мы сразу проверим их и, если что-то пойдет не так — скажем об этом.
После ввода данных мы сразу проверим их и, если что-то пойдет не так — скажем об этом.
Шаг 2. Соответствие полей шаблона карты с полями в CRM
При изменении значения поля пользовател в RetailCRM, мы будем обновлять его на карте. На этом этапе нужно выбрать, какие поля на карте будут соответствовать полю в CRM. Вы можете выбирать не все поля для синхронизации, или не выбирать их вообще.
Шаг 3. Соответствие уровня шаблону карты
Мы можем автоматически менять шаблон карты покупателя в зависимости от его уровня — если уровень поменяется в RetailCRM, мы поменяем шаблон в OSMI Cards. Вы можете не выбирать соответствия, тогда шаблоны обновляться не будут.
Шаг 4. Соответствие полей анкеты полям в RetailCRM
Мы можем автоматически создавать пользователей из ваших анкет в RetailCRM — для этого нужно настроить соответствие полей. Обратите внимание: после создания пользователя в CRM данные будут безвозвратно удаляться, соответственно те данные, по которым вы не настроили соответствие, будут утеряны.
Шаг 5. Другие настройки
Вы можете настроить передачу некоторых данных модулем так, как вам удобно. Для этого на последнем шаге настройки установите:
— нужно ли сохранять ссылку на добавление карты и куда ее сохранять,
— куда сохранять количество устройств, на которых установлена карта (см ниже),
— как будет подставляться % начисления бонусов или скидки — вы можете добавить любой текст до и после значения,
— нужно ли создавать карты, если у пользователя в CRM указана карта, но ее нет в OSMI Cards,
— нужно ли создавать карты, если у пользователя в CRM не указана карта, но есть участие в программе лояльности.
Создание карт и подстановка ссылки происходит каждый раз, когда в карточке пользователя что-то меняется.
— нужно ли сохранять ссылку на добавление карты и куда ее сохранять,
— куда сохранять количество устройств, на которых установлена карта (см ниже),
— как будет подставляться % начисления бонусов или скидки — вы можете добавить любой текст до и после значения,
— нужно ли создавать карты, если у пользователя в CRM указана карта, но ее нет в OSMI Cards,
— нужно ли создавать карты, если у пользователя в CRM не указана карта, но есть участие в программе лояльности.
Создание карт и подстановка ссылки происходит каждый раз, когда в карточке пользователя что-то меняется.
Личный кабинет
После настройки модуля вы сможете изменять настройки в личном кабинете — его интерфейс визуально напоминает интерфейс OSMI Cards. Вы в любой момент можете посмотреть в нем важную информацию и отредактировать ее.
Лог событий
По логу событий вы можете определить, какие действия совершал модуль с вашей CRM и OSMI Cards. Лог хранится 2 дня.
Шаблоны
Тут настраивается соответствие полей шаблонам, а также соответствие уровней шаблонам карт. Данные по полям в шаблоне обновляются каждые 5 минут или чаще, шаблоны карт в зависимости от уровня обновляются раз в сутки.
Интеграция
В этот раздел стоит заходить только если у вас изменились ключи доступа к OSMI Cards. В таком случае их нужно обновить — модуль сам откроет эту страницу, если с ключом будет что-то не так.
Анкетирование
Мы создаем пользователя из вашего анкетирования в OSMI Cards, если настроено соответствие полей. Если его нужно изменить, это можно сделать в этом разделе.
Мы обрабатываем анкеты раз в минуту. Обновление существующих и создание новых клиентов происходит следующим образом:
Важно
Мы обрабатываем анкеты раз в минуту. Обновление существующих и создание новых клиентов происходит следующим образом:
- Сначала мы пробуем найти клиента по номеру телефона в RetailCRM. Если клиент найден — мы обновим его в соответствии с данными анкетами. Если по номеру будет найдено несколько клиентов, мы попробуем сузить поиск по паре «номер телефона + email». Если и по этой паре тоже будет найдено более одного клиента, мы возьмем самого старого (по дате регистрации в RetailCRM) клиента.
- Если по номеру телефона клиента найти не удалось, повторим попытку поиска по email. Если и она будет безуспешной, создадим нового клиента.
- Аналогично и с программой лояльности (ПЛ) — мы сначала ищем участие в ПЛ по id клиента, найденного в шаге 2 и 3 выше. Если участие найдено, тогда обновляем в ПЛ номер карты. Если не найдено, тогда создаем новое участие в ПЛ с номером карты и привязываем его к клиенту, которого нашли/создали на предыдущих этапах.
Важно
- Для клиента, уже участвующего в ПЛ, вид ПЛ при обработке анкеты не меняется.
- Для нового клиента привязка клиента к ПЛ зависит от настройки, выбранной в разделе модуля Другое - Магазин, и от параметра ?referrer=vash_magazin в строке ссылки на анкету. Если параметр задан и магазин находится в списке доступных активных магазинов (по значению поля символьный код в RetailCRM), то будет использован он. Если параметр не использовался в анкете или магазина из параметра нет в списке, тогда используется магазин из настройки модуля.
- Если в настройках модуля в разделе Другое - Магазин ничего не выбрано, то магазин по умолчанию выбирается как магазин с отметкой Магазин по умолчанию в RetailCRM. Если магазин по умолчанию в RetailCRM не установлен, то магазин выбирается по минимальному номеру из колонки Порядок в списке магазинов в RetailCRM.
- Если в RetailCRM нет активных ПЛ, то обработка анкет будет пропущена.
- Если в настройках модуля Другое - Создавать карты клиентам, у которых еще нет карты в CRM выключена возможность создания карты, то обработка анкеты будет пропущена.
Другое
Вы можете настроить передачу некоторых данных модулем так, как вам удобно. Для этого на последнем шаге настройки установите:
— нужно ли сохранять ссылку на добавление карты и куда ее сохранять,
— куда сохранять количество устройств, на которых установлена карта (см ниже),
— как будет подставляться % начисления бонусов или скидки — вы можете добавить любой текст до и после значения,
— нужно ли создавать карты, если у пользователя в CRM указана карта, но ее нет в OSMI Cards,
— нужно ли создавать карты, если у пользователя в CRM не указана карта, но есть участие в программе лояльности (см Важно в разделе Анкетирование)
Создание карт и подстановка ссылки на карту происходит каждый раз, когда в карточке пользователя что-то меняется.
Если в личном кабинете OSMICards в разделе Интеграции -> Вэб-хуки настроить вэб-хук (как показано на скриншоте), то тогда каждый раз при установке карты на устройство или удаление карты с устройства (или включении/выключение автообновления на обороте карты), в CRM в реальном времени обновится кастомное поле с количеством устройств, на которых установлена карта.
— нужно ли сохранять ссылку на добавление карты и куда ее сохранять,
— куда сохранять количество устройств, на которых установлена карта (см ниже),
— как будет подставляться % начисления бонусов или скидки — вы можете добавить любой текст до и после значения,
— нужно ли создавать карты, если у пользователя в CRM указана карта, но ее нет в OSMI Cards,
— нужно ли создавать карты, если у пользователя в CRM не указана карта, но есть участие в программе лояльности (см Важно в разделе Анкетирование)
Создание карт и подстановка ссылки на карту происходит каждый раз, когда в карточке пользователя что-то меняется.
Если в личном кабинете OSMICards в разделе Интеграции -> Вэб-хуки настроить вэб-хук (как показано на скриншоте), то тогда каждый раз при установке карты на устройство или удаление карты с устройства (или включении/выключение автообновления на обороте карты), в CRM в реальном времени обновится кастомное поле с количеством устройств, на которых установлена карта.
Если там-же дополнительно настроить вэб-хук на событие "device updated its card", то в тогда в CRM в кастомном поле дата последнего обновления электронной карты будет автоматически сохранятся дата и время события, когда информация на электронной карте в телефоне клиента обновилась. Обновление в телефоне происходит тогда, когда телефон либо получил пуш уведомление об изменении содержимого карты, либо когда пользователь обновил содержимое карты в телефоне вручную, потянув ее пальцем вниз. Но следует учитывать, что ручное обновление карты срабатывает только в том случае, если в сервисе ОСМИ есть обновленные данные для карты. То есть например был отправлен пуш, изменился шаблон карты или содержимое полей карты.
В качестве логина укажите строку {apiid}
В качестве пароля укажите строку {apikey}
URL: https://rcrm.osmicards.com/api/updatedevices.php
Важно: Указывайте в полях Логин и Пароль строки именно так, как показано, {apiid} и {apikey}, а не подставляйте значения реальных APIID и APIKEY из данных вашей учетной записи ОСМИ!
В качестве пароля укажите строку {apikey}
URL: https://rcrm.osmicards.com/api/updatedevices.php
Важно: Указывайте в полях Логин и Пароль строки именно так, как показано, {apiid} и {apikey}, а не подставляйте значения реальных APIID и APIKEY из данных вашей учетной записи ОСМИ!
Часто задаваемые вопросы
В первую очередь, проверьте, что у клиента в его карточке установлен требуемый уровень лояльности. Если у вас настроено изменение уровня лояльности в зависимости от суммы накоплений, то помните, что RetailCRM не учитывает покупки, сделанные клиентом до попадания в программу лояльности.
так же имейте ввиду, что изменения на электронную карту выводятся на основе изменений в истории клиента и истории бонусов. RetailCRM не пишет ни в одну доступную историю факт изменения уровня лояльности клиента - ни ручное, ни по триггеру, ни по правилу. Поэтому чтобы на карту вывелось изменение уровня лояльности клиента, его нужно сопроводить изменением/списанием бонусных баллов. Тогда станет доступна история изменения бонусов и модуль обработает изменение уровня и обновит карту соответственно.
так же имейте ввиду, что изменения на электронную карту выводятся на основе изменений в истории клиента и истории бонусов. RetailCRM не пишет ни в одну доступную историю факт изменения уровня лояльности клиента - ни ручное, ни по триггеру, ни по правилу. Поэтому чтобы на карту вывелось изменение уровня лояльности клиента, его нужно сопроводить изменением/списанием бонусных баллов. Тогда станет доступна история изменения бонусов и модуль обработает изменение уровня и обновит карту соответственно.
такое может произойти по нескольким причинам:
- В СРМ есть более одного клиента с таким-же номером телефона. В этом случае необходимо соединить таких клиентов в СРМ в одного клиента
- Клиент уже есть в СРМ, но в СРМ не настроена или не активна программа лояльности. Необходимо в СРМ настроить программу лояльности и выбрать ее в настройках модуля "Другое -> Магазин для новых клиентов"
- У клиента в СРМ нет карты, но в настройках модуля создание карты запрещено. Необходимо разрешить создание карт в настройках модуля "Другое -> Создавать электронные карты клиентам, у которых уже есть карта в CRM" и в "Другое -> Создавать карты клиентам, у которых еще нет карты в CRM"
Интеграция использует несколько полей:
Но если вы хотите хранить информацию, относящуюся к первым двум полям, в своих собственных пользовательских переменных, то создайте их и настройте мапировку данных на эти поля в настройках Модуля ОСМИ в разделе Другое.
- Ссылка на добавление электронной карты
- Количество устройств с электронными картами
- дата последнего обновления электронной карты
- дата последнего прохождения электронной анкеты
Но если вы хотите хранить информацию, относящуюся к первым двум полям, в своих собственных пользовательских переменных, то создайте их и настройте мапировку данных на эти поля в настройках Модуля ОСМИ в разделе Другое.
Для этого нужно перейти в раздел «Продажи» → «Клиенты» → «Список». Выбрать всех клиентов у которых есть активные электронные карты (для таких клиентов можно создать сегмент и в дальнейшем выбирать по этому сегменту). Внизу появится кнопка действия, нажав ее, выбираем написать в чат, формируем сообщение и отправляем.