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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Вариант A (Анкора): «Владелец бонусов» = Анкора. Поле «ID сети» не нужно.
• Вариант B (зеркало): «Владелец бонусов» = YCLIENTS. Поле «ID сети» оставьте пустым — определим автоматически по филиалу (это main_group_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. Клиент открывает публичную страницу вашей карты и нажимает «Войти в свою карту».
2. Администратор генерирует одноразовый код: в кассирском приложении — раздел «Код входа в карту» → кнопка «Сгенерировать код входа»; либо в личном кабинете — кнопка «Код входа в карту» на странице клиента. Код действует 15 минут.
3. Клиент вводит свой телефон (или email) и код с экрана администратора — попадает в свою карту и сохраняет её в Wallet.

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

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

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

Каждый филиал подключается отдельно: своё приложение YCLIENTS, свои токены и своя программа лояльности в Анкоре. Так доступы не пересекаются, а бонусные правила можно настроить под каждую точку.

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