Как работает интеграция Loyal Club с amoCRM

Что нужно для работы интеграции

Перед началом проверьте, что:

• интеграция Loyal Club с amoCRM подключена
• в воронке созданы этапы для списания и начисления бонусов
• к сделке привязан контакт
• у контакта указан корректный номер телефона
• сумма покупки внесена в поле «Бюджет»

Названия этапов зависят от настроек вашей воронки. В примере используются этапы «Списать бонусы» и «Тур завершен».

Как распределяются действия между amoCRM и Loyal Club

Все настройки программы лояльности задаются в Loyal Club.

В кабинете Loyal Club настраиваются:

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

amoCRM получает эти данные из Loyal Club. Менеджер не рассчитывает кэшбэк и допустимую сумму списания самостоятельно.

В amoCRM менеджер работает только с двумя основными значениями:

• указывает сумму сделки в поле «Бюджет»
• вручную вводит желаемую сумму в поле «Сумма списания бонусами»

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

Важно

Поля с балансом, уровнем и процентом кэшбэка в amoCRM носят информационный характер.

Даже если вручную изменить процент кэшбэка в amoCRM, бонусы будут начислены по проценту, установленному в Loyal Club. Настройки карты меняются только в кабинете Loyal Club.

Какие данные передаются в amoCRM

После синхронизации в сделке появляется раздел LoyalClub.

В нём отображаются основные данные карты:

Менеджер вручную заполняет только поле «Сумма списания бонусами». Остальные данные поступают из Loyal Club автоматически.

Сценарий 1. У клиента ещё нет карты Loyal Club

Шаг 1. Создайте контакт и сделку

Создайте контакт в amoCRM и укажите номер телефона клиента.

Затем создайте сделку:

• Привяжите к ней контакт.
• Укажите сумму покупки в поле «Бюджет».
• Сохраните сделку.

Интеграция проверит, есть ли в Loyal Club клиент с таким номером телефона.

Шаг 2. Передайте клиенту ссылку на установку карты

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

Ссылка появится:

• в ленте событий сделки
• в поле «Ссылка на карту»

Передайте ссылку клиенту. По ней он сможет выпустить карту и добавить её в кошелёк телефона.

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

Шаг 3. Дождитесь обновления данных

После установки карты интеграция синхронизирует данные с amoCRM.

В разделе LoyalClub появятся:

• номер карты
• статус «Установлена»
• текущий бонусный баланс
• уровень клиента
• процент кэшбэка
• дата подключения

Клиент также появится в разделе «Клиенты» в кабинете Loyal Club.

В дальнейшем система будет находить этого клиента по номеру телефона.

Сценарий 2. Начисление бонусов после покупки

Чтобы начислить бонусы, переведите сделку в успешный финальный этап. В примере он называется «Тур завершен».

Интеграция передаст сумму сделки в Loyal Club. Loyal Club рассчитает начисление по настройкам карты.

Например:

• сумма сделки 10 000 ₽
• кэшбэк по карте 1%
• начисление 100 бонусов

Менеджеру не нужно рассчитывать сумму вручную.

После операции обновятся:

• бонусный баланс
• доступная сумма
• статус операции
• дата операции
• технические номера операции

В ленте сделки появится сообщение о начислении и новом балансе.

Повторное начисление

Одна сделка может сформировать только одно начисление.

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

Сценарий 3. Новая сделка с постоянным клиентом

При повторном обращении создайте новую сделку и привяжите к ней тот же контакт.

Интеграция найдёт клиента по номеру телефона и автоматически загрузит данные из Loyal Club:

• номер карты
• статус карты
• текущий баланс
• уровень программы
• процент кэшбэка
• дату подключения

Повторно выпускать карту не нужно.

Баланс клиента общий для всех его сделок. После каждого начисления или списания он обновляется и в amoCRM, и в Loyal Club.

Сценарий 4. Списание бонусов

Списание проводится до завершения сделки.

Шаг 1. Проверьте баланс клиента

Откройте раздел LoyalClub и найдите поле «Доступно к списанию бонусами».

В поле «Сумма списания бонусами» укажите количество бонусов, которое клиент хочет использовать.

Менеджер вводит только сумму. Все проверки проводит Loyal Club.

Система учитывает:

• текущий баланс клиента
• сумму сделки
• максимальный процент оплаты бонусами
• другие ограничения карты

Пример ограничения

В настройках карты разрешено оплачивать бонусами не более 30% покупки.

При сумме сделки 10 000 ₽ максимальное списание составит 3 000 бонусов.

Даже если на балансе клиента находится 5 000 бонусов, списать через amoCRM больше 3 000 не получится. Loyal Club отклонит операцию, поскольку она нарушает настройки карты.

Шаг 2. Переведите сделку в этап «Списать бонусы»

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

amoCRM передаст введённую сумму в Loyal Club.

Если операция соответствует правилам карты, бонусы будут списаны.

После успешного списания:

• уменьшится баланс клиента
• обновится доступная сумма
• появится статус «Успешно»
• заполнятся дата и ID операции
• в ленте сделки появится результат

Шаг 3. Измените бюджет сделки

После успешного списания уменьшите поле «Бюджет» на использованное количество бонусов.

Например:

• первоначальная сумма сделки 20 000 ₽
• клиент списал 50 бонусов
• новый бюджет 19 950 ₽

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

Шаг 4. Завершите сделку

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

Loyal Club рассчитает новое начисление по настройкам карты.

В рассматриваемом примере:

• до покупки у клиента было 100 бонусов
• клиент списал 50 бонусов
• после списания осталось 50 бонусов
• сумма к оплате составила 19 950 ₽
• при кэшбэке 1% начислено 199 бонусов
• итоговый баланс составил 249 бонусов

Правильная последовательность:

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

Что происходит при ошибках

К сделке не привязан контакт

Если сделка создана без контакта, интеграция не сможет определить клиента.

В ленте появится сообщение о необходимости ручной проверки.

Чтобы исправить ситуацию:

• Привяжите контакт к сделке.
• Проверьте номер телефона.
• Сохраните изменения.
• Повторите нужное действие.

У контакта нет номера телефона

Номер телефона используется как основной идентификатор клиента.

Если номер отсутствует, карта не будет найдена, а бонусная операция не будет проведена.

Номер указан в неверном формате

Интеграция может не распознать номер, если он:

• введён с ошибкой
• содержит недостаточное количество цифр
• указан в неподдерживаемом формате
• относится не к тому клиенту

Исправьте номер в контакте и сохраните изменения.

После повторной проверки интеграция:

• загрузит данные существующей карты
• либо сформирует ссылку на установку новой карты

Ошибки при списании бонусов

Недостаточно бонусов

Если введённая сумма превышает баланс клиента, списание не проводится.

Например, на карте доступно 249 бонусов, а менеджер вводит 500.

В статусе операции появится сообщение о недостаточном количестве бонусов. Исправьте сумму и повторно переведите сделку в этап «Списать бонусы».

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

Превышен разрешённый процент списания

Если в Loyal Club установлено ограничение, например до 30% от суммы покупки, списать больше этого значения нельзя.

Уменьшите сумму в соответствии с условиями карты и повторите операцию.

Сумма списания больше суммы сделки

Количество списываемых бонусов не может превышать бюджет сделки.

Укажите корректную сумму и повторите действие.

Повторное списание

После успешного списания не переводите сделку в этап «Списать бонусы» повторно.

Интеграция защищает баланс от двойной операции. Повторное списание будет отклонено или направлено на ручную проверку.

Ручное изменение данных Loyal Club в amoCRM

Не изменяйте вручную следующие поля:

• бонусный баланс
• процент кэшбэка
• уровень клиента
• статус карты
• номер карты

Такие изменения не меняют настройки программы в Loyal Club.

При следующей синхронизации amoCRM снова получит актуальные данные из Loyal Club. Все расчёты в любом случае будут выполнены по настройкам карты в Loyal Club.

Как проверить результат в Loyal Club

После проведения операций откройте профиль клиента в Loyal Club.

В нём можно проверить:

• имя клиента
• номер карты
• статус установки
• текущий баланс
• дату выпуска карты
• дату последнего начисления
• кошелёк, в который добавлена карта

Данные в профиле клиента должны совпадать с информацией в сделке amoCRM.

Памятка для менеджера

Перед проведением операции проверьте:

• к сделке привязан контакт
• номер телефона указан корректно
• в поле «Бюджет» стоит актуальная сумма покупки
• в поле «Сумма списания бонусами» введено нужное значение
• сумма не превышает баланс клиента
• сумма соответствует лимиту списания
• списание получило статус «Успешно»
• бюджет уменьшен на списанную сумму
• финальный этап выбран после успешного списания

Все правила программы лояльности настраиваются в Loyal Club. В amoCRM менеджер вводит только сумму списания и управляет этапами сделки.