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

YCLIENTS — популярная CRM для салонов красоты, барбершопов, массажа, косметологии и wellness. Связка с программой лояльности Анкоры превращает каждый визит в автоматическое начисление кэшбека или баллов, а карту клиента — в цифровую карту в Apple Wallet и Google Wallet. Без пластика, без приложения и без двойной работы кассира.

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

• Бонусы за визиты автоматически. Клиент оплатил услугу в YCLIENTS — Анкора начисляет кэшбек или баллы по правилам вашей программы.
• Карта в телефоне. Клиент носит карту в Apple Wallet или Google Wallet и видит актуальный баланс без пластика.
• Списание прямо в YCLIENTS. По желанию кэшбек Анкоры показывается на карте лояльности YCLIENTS, и администратор списывает его при оплате визита, не открывая Анкору.
• Единая база. Клиенты из YCLIENTS подтягиваются в Анкору и матчатся по телефону — история не задваивается.
• Возврат клиентов. Push-напоминания о сгорании бонусов и реферальная программа работают поверх ваших визитов.

Подключение идёт через ваше собственное непубличное приложение YCLIENTS — так вы остаётесь владельцем доступа, можете отозвать его в любой момент, а модерация маркетплейса не нужна. Ниже — весь путь по шагам; следуйте по порядку.

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

Шаг 0. Выберите, кто ведёт бонусы (источник правды)

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

Шаг 1. Создайте непубличное приложение

1. В YCLIENTS откройте меню → «Интеграции» → «Аккаунт разработчика» (или напрямую yclients.com/appstore/developers) под аккаунтом владельца салона. Нет аккаунта разработчика — зарегистрируйтесь там же, это бесплатно.
2. Нажмите «Добавить приложение» и в мастере выберите тип «Непубличное» — оно работает в вашем филиале и не проходит модерацию маркетплейса.
3. Название — например, Анкора — <название вашего бизнеса> (скажем, «Анкора — Барбершоп Борода»). Категория — «Онлайн-запись», модель — «Бесплатное».
4. Логотип не обязателен — можно пропустить. Если хотите добавить, вставьте в поле URL наш: https://ankora.pro/icon.png.

Шаг 2. Выдайте права доступа (вкладка «Доступ к API»)

Для начисления бонусов за визиты Анкоре достаточно читать записи и клиентов. На вкладке «Доступ к API» отметьте:

• Журнал записи → «Неограниченный доступ к истории расписания и записей»;
• Форма записи → «Доступ к данным клиентов»;
• Клиентская база → «Показывать номера телефонов и email в списке клиентов», «Показывать номер телефона в карточке клиента», «Выгружать список клиентов», «Просмотр истории посещений клиента»;
• Для зеркала (Вариант B) и для кэшбека на карте лояльности YCLIENTS: там же в «Клиентской базе» — «Просматривать список лояльности клиента», плюс раздел «Лояльность» целиком (все 8 из 8 прав). С ними Анкора читает карты клиентов, а в режиме карты ещё и выдаёт их, пополняет и списывает по ним кэшбек.

Шаг 3. Подключите приложение к своему филиалу

На странице приложения нажмите «Подключить» → «Продолжить» и выберите свой филиал. Это обязательно: без подключения к филиалу токены не получат доступ к данным (ошибка 401). У сети салонов подключите приложение ко всем филиалам, которые хотите связать с Анкорой.

Шаг 4. Скопируйте токены и найдите ID филиала

• User Token — «Мои приложения» → вкладка «Доступ к API».
• Партнёрский токен (Токен партнёра) — «Настройки аккаунта» → «Данные аккаунта» → «Токен партнёра». Это токен всего аккаунта, а не отдельного приложения.
• ID филиала — 5–7 цифр в адресной строке YCLIENTS: число сразу после yclients.com/company/. Например, в yclients.com/company/123456/… это 123456.

Шаг 5. Введите данные в Анкоре

В личном кабинете Анкоры откройте «Интеграции» → YCLIENTS → «Подключить через собственное приложение YCLIENTS» и заполните: ID филиала, Партнёрский токен, User Token и «Владелец бонусов» (по вашему выбору из Шага 0).

• Вариант A (Анкора): «Владелец бонусов» = Анкора. Поле «ID сети» не нужно. Ниже, в панели «Автоматизация», включите галку «Автоматически начислять кэшбек/баллы по визитам YCLIENTS» — по умолчанию она выключена, и без неё визиты будут подтягиваться, а баллы начисляться не будут. Галка подхватывает визиты, завершённые с начала текущего дня: если за них уже начислила бонусы лояльность YCLIENTS, включайте её утром, до первого визита, — иначе сегодняшние визиты получат бонусы дважды.
• Вариант B (зеркало): «Владелец бонусов» = YCLIENTS. Поле «ID сети» оставьте пустым — определим автоматически по филиалу (это main_group_id вашей сети). Галка автоначисления не нужна: бонусы считает YCLIENTS.

В блоке «Точка Анкоры для филиала» выберите точку, к которой относится этот филиал. Начисления за его визиты и карты клиентов из YCLIENTS попадут в аналитику этой точки и в фильтр клиентов по точке. Если точка ещё не заведена, добавьте её в разделе «Точки» и выберите позже — клиентам, которых Анкора уже импортировала, точка проставится при сохранении настройки.

У сети салонов при подключении укажите ID одного филиала — он станет основным. Остальные подключаются после, в настройках интеграции, в блоке «Филиалы сети»: Анкора покажет филиалы, к которым подключено приложение, и у каждого можно выбрать точку, «Без точки» или «Не подключать». Если список не загрузился, филиал добавляется по ID.

Нажмите «Подключить». Готово: клиенты и завершённые визиты начнут подтягиваться синхронизацией каждые несколько минут. Галки автоматизации можно поменять позже — кнопка «Настройки и автоматизация» на странице интеграции.

Шаг 6. Мгновенное начисление через вебхук (необязательно)

Синхронизация и так подтянет визиты за пару минут. Если хотите, чтобы бонусы начислялись сразу в момент визита:

1. На странице интеграции Анкора показывает ваш персональный webhook-URL вида https://ankora.pro/webhooks/yclients/…. Скопируйте его.
2. В приложении YCLIENTS: «Мои приложения» → «Настройки подключения» → поле «Адрес, на который отправлять уведомления» → вставьте этот URL.
3. Переподключите приложение к филиалу (отключить, затем снова «Подключить») — тогда вебхук установится в филиал. У сети — к каждому филиалу: адрес один на все филиалы.

Шаг 7. Выдайте клиентам карты в телефон

После подключения Анкора импортирует базу клиентов YCLIENTS и каждому автоматически выпускает карту лояльности. Остался последний шаг — чтобы клиент сохранил карту себе в телефон. Есть два способа.

Способ 1 — ссылка восстановления (дистанционно).

1. В личном кабинете откройте «Клиенты», выберите клиента и нажмите кнопку «Ссылка восстановления».
2. Скопируйте ссылку (или дайте клиенту отсканировать QR-код с экрана) и отправьте любым способом — в мессенджере, SMS или по email. Ссылка действует 7 дней.
3. Клиент открывает ссылку и сразу выбирает: Apple Wallet, Google Wallet или «Открыть в браузере». Вводить код не нужно — ссылка персональная.

Способ 2 — код входа (клиент рядом, в салоне).

1. Клиент открывает публичную страницу вашей карты и нажимает «Войти в свою карту». Быстрее всего — показать ему «QR заведения» с главного экрана кассирского приложения: код ведёт как раз на эту страницу.
2. Администратор генерирует одноразовый код: в кассирском приложении — раздел «Код входа в карту» → кнопка «Сгенерировать код входа»; либо в личном кабинете — кнопка «Код входа в карту» на странице клиента. Код действует 15 минут.
3. Клиент вводит свой телефон (или email) и код с экрана администратора — попадает в свою карту и сохраняет её в Wallet.

Кэшбек Анкоры на карте лояльности YCLIENTS (необязательно)

Для Варианта A. Если администраторам удобнее списывать бонусы там же, где они принимают оплату, кэшбек Анкоры можно показать на карте лояльности YCLIENTS. Все правила по-прежнему в Анкоре: проценты, уровни, подарки, акции, сгорание. Карта в YCLIENTS только показывает баланс и даёт его списать. Нужны права раздела «Лояльность» (Шаг 2).

В YCLIENTS выберите тип карты.

• У клиентов уже копятся бонусы на карте YCLIENTS (своя лояльность салона) — используйте эту же карту. Её остатки перейдут в Анкору, и дальше это будет одна карта с одним балансом: и в YCLIENTS, и в Wallet клиента. Новый тип в этом случае не заводите: бонусы YCLIENTS остались бы на старой карте, и клиент не увидел бы их в телефоне.
• Своей лояльности в YCLIENTS нет — в сетевом интерфейсе откройте «Лояльность» → «Типы карт» и нажмите «Добавить тип карты». Название — например, «Бонусы Анкоры».

Настройте тип карты:

1. Отметьте свой филиал — без этого карта в нём не действует. Акции снимите (у нового типа — не отмечайте): начисляет только Анкора, иначе клиент получит бонусы дважды.
2. Автоматический выпуск — «Не выдавать новым клиентам»: карты клиентам выдаст Анкора.
3. Сгорание неиспользованных баллов — «Не применять»: сгоранием управляет Анкора.
4. Списание баллов для услуг — «Любые услуги». Для товаров — как вам удобно.
5. Ограничение оплаты баллами — % от суммы чека, тот же процент, что в поле «Макс. списание кэшбека (% от чека)» вашей программы в Анкоре. Без ограничения — 0. Нажмите «Сохранить».
6. Откройте тип карты → вкладка «Уведомления». Для «Уведомление о выдаче карты лояльности», «Уведомление о начислении бонусов» и «Уведомление о списании бонусов» выберите сценарий «Не отправлять» и сохраните. О бонусах клиенту пишет Анкора, иначе он получит два сообщения, а SMS оплатит салон.

В Анкоре включите режим.

1. «Интеграции» → YCLIENTS → «Настройки и автоматизация».
2. Если в «Программе лояльности» у вас несколько карт, в блоке «Ведущая карта Анкоры» выберите ту, которой пользуется большинство клиентов. На неё начисляется кэшбек за визиты, её получают клиенты из YCLIENTS, и её баланс видит администратор. Кэшбек на картах других программ остаётся в Анкоре — его списывает кассир Анкоры.
3. Включите «Автоматически начислять кэшбек/баллы по визитам YCLIENTS» и в блоке «Кэшбек Анкоры на карте лояльности YCLIENTS» — «Показывать кэшбек Анкоры на карте лояльности YCLIENTS». Выберите тип карты из списка. Если сегодня бонусы уже начисляла лояльность YCLIENTS, делайте это утром, до первого визита (подробнее — в разделе «Когда начисляются бонусы»).
4. Выберите, как свести балансы, если у клиента бонусы есть и в Анкоре, и на карте YCLIENTS. «Взять больший» — если это одни и те же бонусы, например вы переносили их из YCLIENTS в Анкору вручную: на обеих картах будет большая из двух сумм. «Сложить» — если бонусы разные, например приветственный бонус Анкоры: на картах будет сумма. Сохраните.
5. Анкора проходит по клиентам в фоне ровным темпом, большой базе нужно до часа. Бонусы, которые есть только на карте YCLIENTS, переходят в Анкору целиком — клиент увидит их в Wallet. Кэшбек, который есть только в Анкоре, появится на карте YCLIENTS; клиентам без карты Анкора её выдаст. Если бонусы есть в обеих системах, баланс сведётся по выбранному правилу, так что бонусы клиента не пропадут.

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

Когда начисляются бонусы

Анкора учитывает завершённые визиты со статусом «клиент пришёл» и начисляет бонусы по сумме услуги. С кэшбеком на карте лояльности YCLIENTS визит начисляется после полной оплаты, а кэшбек считается с суммы, оплаченной деньгами. В режиме «зеркало» вместо начисления Анкора воспроизводит у себя операции лояльности YCLIENTS (начисление и списание), чтобы баланс в Wallet, пуши, сгорание и лесенка работали по вашим настройкам, но на данных YCLIENTS. Начисление идемпотентно — один визит не начислится дважды, даже если придёт и синхронизацией, и вебхуком.

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

Для сети салонов

Вся сеть подключается к одному кабинету Анкоры через одно приложение YCLIENTS. При подключении укажите основной филиал, остальные добавьте в настройках интеграции в блоке «Филиалы сети» и выберите каждому точку Анкоры. Анкора берёт клиентов и визиты всех подключённых филиалов, а начисления и карты клиентов относит к точке своего филиала — это видно в аналитике по точкам. Программа лояльности и баланс клиента общие на всю сеть. Карта лояльности YCLIENTS тоже сетевая: кэшбек Анкоры на ней можно списать в любом подключённом филиале. Приход в кассу YCLIENTS при закрытии визита из Анкоры проводится только в основном филиале: кассы в настройках — его.

Как связка работает изнутри — обе модели на примерах — в обзоре как работает программа лояльности вместе с YCLIENTS. Ещё не настроили саму программу? Начните с гайда как запустить программу лояльности, а затем разберитесь, как выстроить её для салона красоты или массажного салона.