Как подключить RetailCRM к программе лояльности

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

Что даёт связка RetailCRM и Анкоры

• Баллы за заказы автоматически. Заказ переведён в «Выполнен» — начисление по правилам вашей программы в ту же секунду, клиенту — push.
• Карта в телефоне. Apple Wallet и Google Wallet, новые клиенты получают карту сами — по данным заказа.
• Баланс в CRM. Поле «Баланс Анкоры» в карточке клиента обновляется при каждом изменении.
• Бонусный счёт RetailCRM. По желанию — синхронизация с их модулем лояльности: клиент видит и тратит баллы в заказе, списания зеркалятся в Анкору.

Хотите сначала разобраться, как связка устроена в принципе? Прочитайте обзор: как работает программа лояльности вместе с RetailCRM.

Шаг 1. Подключите интеграцию в Анкоре

В кабинете Анкоры: «Интеграции» → RetailCRM → «Подключить». Анкора сгенерирует персональный адрес вебхука (он содержит секретный ключ — не публикуйте его) и покажет готовые параметры для триггера. Здесь же включите «Автоматически заводить клиента с картой» — для интернет-магазина почти каждый покупатель «новый» для программы, без этой галки начисления по ним будут пропускаться.

Шаг 2. Создайте триггер о выполненных заказах

Триггер — это правило внутри RetailCRM: «когда случилось такое-то событие, сделай такое-то действие». Наш триггер будет при каждом выполненном заказе отправлять Анкоре сообщение. Создаётся один раз, по шагам:

1. В левом меню RetailCRM откройте Автоматизация (иконка робота) → Триггеры и нажмите синюю кнопку «+ Триггер».
2. Вверху вместо «Новый триггер» впишите понятное название, например «Анкора — баллы за заказы». Переключатель «Активность» оставьте включённым, поля «Группа», «Комментарий» и «Порядок» можно не трогать.
3. В блоке «Событие» нажмите «+ Событие» и выберите из списка «Изменение заказа».
4. В блоке «Условие If (если)» оставьте отмеченным «Конструктор» и нажмите «+ Условие». В открывшейся панели выберите «Изменение статуса заказа», дальше две настройки: «Начальное значение» — отметьте «Любой»; «Новое значение» — отметьте «Равняется» и выберите в списке статус «Выполнен». Это значит: триггер сработает, когда заказ из любого статуса перейдёт в «Выполнен».
5. В блоке «Действие Then (то)» нажмите «+ Действие» и выберите последний пункт списка — «Выполнить HTTP-запрос». В форме действия: в поле «Адрес» вставьте адрес вебхука со страницы интеграции в Анкоре (скопируйте целиком); «HTTP метод» смените с GET на POST; «HTTP-заголовки» оставьте пустыми; в «Передавать параметры» отметьте «В теле запроса (urlencode)».
6. Семь раз нажмите «Добавить параметр» и заполните пары полей по таблице со страницы интеграции в Анкоре: в поле «Параметр» — имя (например, order_id), в поле «Значение» — текст в двойных фигурных скобках (например, {{ order.id }}), скопированный точно. Пугаться скобок не нужно: это подстановки RetailCRM — при отправке он сам заменит их на реальные номер заказа, сумму, телефон, имя и почту клиента.
7. Сохраните триггер кнопкой внизу страницы.

Шаг 3. Проведите тестовый заказ

Создайте заказ с клиентом, у которого указан телефон, добавьте позицию с ценой и переведите заказ в статус «Выполнен». Проверьте с двух сторон:

• в журнале интеграции в Анкоре — событие «Начислено за покупку…» либо причина пропуска;
• в журнале действий RetailCRM — отправка HTTP-запроса и ответ сервера.

Клиент увидит push и обновлённый баланс на карте.

Шаг 4. Покажите баланс в карточке клиента (по желанию)

Создайте API-ключ: в RetailCRM Настройки → Интеграция → Ключи доступа к API → «Добавить». Ключу нужны права customer_read, customer_write, custom_fields_read, custom_fields_write и доступ к вашему магазину. Скопируйте ключ сразу — после сохранения RetailCRM его больше не покажет.

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

Шаг 5. Синхронизируйте бонусный счёт (по желанию)

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

1. Включите модуль: в RetailCRM откройте Настройки → Маркетплейс, найдите плитку «Программа лояльности» и активируйте её. Создайте программу, а в её правилах поставьте начисления на ноль: баллы считает Анкора, и если кто-то начислит на счёт вручную — Анкора автоматически откатит его к настоящему балансу.
2. Откройте свой API-ключ (Настройки → Интеграция → Ключи доступа к API) и добавьте ему права Лояльность: Получение (loyalty_read) и Редактирование (loyalty_write).
3. В кабинете Анкоры в настройках интеграции включите «Вести бонусный счёт RetailCRM» и сохраните — на странице интеграции появится блок с адресом и параметрами для второго триггера.
4. Создайте второй триггер (Автоматизация → Триггеры → «+ Триггер»), он проще первого: событие — «Изменение бонусного счёта»; блок «Условие» пропустите; действие — «Выполнить HTTP-запрос», метод POST, параметры «В теле запроса (urlencode)». В поле «Адрес» вставьте bonus-адрес со страницы интеграции — он оканчивается на /bonus, это не тот же адрес, что в первом триггере. Добавьте один параметр со страницы интеграции: account_id со значением {{ loyaltyBonusOperation.loyaltyAccount.id }} — по нему Анкора сама найдёт счёт и клиента.

Готово: списание баллов на кассе RetailCRM автоматически списывает их и в Анкоре — клиент получает push с новым балансом, а счёт и карта всегда совпадают.