Интеграция с YClients

Интеграция синхронизирует записи и клиентов между Sport Groups и YClients в обе стороны. Запись, созданная в одной системе, автоматически появляется в другой. Отмены и изменения тоже синхронизируются.

Возможности интеграции

  • YClients → Sport Groups — записи из YClients автоматически появляются в Sport Groups (через webhook и периодическую синхронизацию)
  • Sport Groups → YClients — записи через бота или веб-виджет автоматически создаются в YClients
  • Синхронизация клиентов — если клиента нет в одной из систем, он создаётся автоматически
  • Отмены — отмена записи в любой системе синхронизируется в обе стороны
  • Изменение времени — перенос записи в YClients отражается в Sport Groups
  • Защита от дублей — у каждой записи уникальный идентификатор, поэтому повторная синхронизация не создаёт дублей

Шаг 1. Получить Partner Token (токен партнёра)

Partner Token — основной ключ доступа к YClients API.

Способ 1: Через аккаунт разработчика

  1. Войди в YClients: yclients.com
  2. Перейди в раздел Интеграции → Аккаунт разработчика
  3. Зарегистрируйся как разработчик (если ещё не зарегистрирован)
  4. Открой Настройки аккаунта → Данные аккаунта
  5. Скопируй значение поля «Токен партнера»

Способ 2: Через поддержку YClients

  1. Напиши на support@yclients.com
  2. Укажи, что тебе нужен партнёрский токен для интеграции
  3. Укажи свой email и ФИО
  4. Токен пришлют в ответном письме
Partner Token — это длинная строка символов. Храни его в надёжном месте и не передавай третьим лицам.

Шаг 2. Получить User Token (токен пользователя)

User Token нужен для доступа к данным конкретной компании.

Способ 1: Через интерфейс YClients

  1. Перейди в Аккаунт разработчика → Добавить приложение
  2. Выбери тип приложения: «Непубличное»
  3. Заполни данные и сохрани
  4. Открой раздел «Мои приложения» → «Доступ к API»
  5. Скопируй User Token

Способ 2: Через логин и пароль

Если есть логин и пароль от YClients, User Token можно получить автоматически через API. Передай нам логин и пароль, и мы получим токен.

User Token меняется при смене пароля пользователя в YClients. Если интеграция перестала работать после смены пароля, токен нужно обновить.

Шаг 3. Определить ID компании (филиала)

ID компании — это числовой идентификатор твоего филиала в YClients.

Как найти

  1. Войди в личный кабинет YClients
  2. Открой нужный филиал
  3. Посмотри URL в адресной строке браузера:
https://yclients.com/company/12345/...

Число 12345 — это твой Company ID.

Шаг 4. Создать услуги в YClients

Для синхронизации записей в YClients нужны услуги под каждую длительность бронирования в Sport Groups.

Где создавать

  1. Войди в YClients: yclients.com
  2. Перейди в Настройки → Услуги
  3. Создай услугу для каждой длительности бронирования

Пример настройки услуг

Если у тебя аренда кортов на 60, 90 и 120 минут, создай три услуги:

Название услуги Длительность Цена
Аренда 60 минут 60 мин Твоя цена
Аренда 90 минут 90 мин Твоя цена
Аренда 120 минут 120 мин Твоя цена
Запиши ID каждой созданной услуги. ID виден в URL, если открыть услугу в YClients. Ещё его можно запросить у нас: мы получим его через API.

Шаг 5. Настроить ресурсы (корты) в YClients

В YClients корты, площадки и залы представлены как ресурсы. Каждому корту в Sport Groups должен соответствовать ресурс в YClients. По ID ресурса (Resource Instance ID) система определяет, на какой корт сделана запись.

Что такое ресурсы в YClients

Ресурсы — это объекты, которые можно бронировать: корты, залы, площадки, столы и т.д. В отличие от сотрудников, ресурсы не привязаны к конкретному человеку, поэтому для бронирования физических объектов они подходят лучше.

Как создать ресурсы

  1. В YClients перейди в Настройки → Ресурсы
  2. Создай ресурс для каждого корта/площадки
  3. Привяжи к каждому ресурсу услуги из Шага 4

Как найти Resource Instance ID

Для настройки интеграции нужно узнать ID созданного ресурса:

  1. Открой созданный ресурс в YClients
  2. Посмотри URL в адресной строке браузера: в нём будет ID ресурса
  3. Или передай нам доступ (шаг 6), и мы получим ID через API

Пример настройки

Ресурс в YClients Resource Instance ID Корт/площадка в Sport Groups
Корт 1 101 Корт 1
Корт 2 102 Корт 2
Корт 3 103 Корт 3
Не забудь привязать услуги из Шага 4 к каждому созданному ресурсу. Без привязки записаться на этот ресурс не получится.
Если ресурсы в твоём YClients уже настроены, новые создавать не нужно. Достаточно передать нам их ID.

Шаг 6. Передать данные нам

Когда шаги 1–5 выполнены, передай нам эти данные:

Данные Откуда взять
Partner Token Шаг 1
User Token (или логин и пароль) Шаг 2
Company ID Шаг 3, число из URL
ID услуг с их длительностями Шаг 4
Resource Instance ID ресурсов и соответствие кортам Шаг 5

Оставить заявку на подключение

Получив данные, мы настроим интеграцию на своей стороне:

  • Включим синхронизацию для твоего аккаунта
  • Настроим маппинг услуг (длительность → ID услуги YClients)
  • Настроим маппинг кортов/площадок (корт → Resource Instance ID YClients)
  • Проведём тестовую синхронизацию

Шаг 7. Настройка webhook в YClients

Через webhook YClients сразу сообщает Sport Groups о новых записях, отменах и изменениях.

Как настроить

  1. В YClients перейди в Интеграции → Webhooks (или Настройки → Уведомления → Webhooks)
  2. Нажми «Добавить webhook»
  3. Укажи URL (адрес мы пришлём, он будет такого вида): https://ваш-домен.sportgroups.ru/yclients_webhook/
  4. Выбери события:
    • Создание записи (record.created)
    • Удаление записи (record.deleted)
    • Изменение записи (record.updated)
  5. Если есть поле Secret, введи секретный ключ (его мы тоже пришлём). По нему проверяется подлинность уведомлений.
  6. Сохрани webhook
Webhook URL и секретный ключ мы пришлём после настройки интеграции на нашей стороне (Шаг 6). Настройку webhook можно поручить и нам.

Как работает синхронизация

Записи из YClients → Sport Groups

Когда клиент записывается через YClients:

  1. YClients отправляет webhook-уведомление в Sport Groups
  2. Sport Groups находит нужный корт по Resource Instance ID
  3. Если клиента нет в базе, он создаётся автоматически (по телефону или email)
  4. Создаётся бронирование, привязанное к записи YClients

Кроме того, раз в 5 минут запускается фоновая синхронизация: она проверяет новые и удалённые записи на 90 дней вперёд. Это страховка на случай, если webhook не дошёл.

Записи из Sport Groups → YClients

Когда клиент записывается через Telegram-бота или веб-виджет:

  1. После успешной оплаты Sport Groups автоматически создаёт запись в YClients
  2. Услуга подбирается по длительности бронирования
  3. В комментарий к записи добавляется ссылка на Sport Groups
  4. Если клиента нет в YClients, он создаётся автоматически

Отмена записей

  • Отмена в YClients — запись автоматически отменяется в Sport Groups
  • Отмена в Sport Groups — запись автоматически удаляется из YClients

Изменение записей

  • Если перенести запись на другое время в YClients, время обновится и в Sport Groups
  • Если изменить длительность, окончание бронирования пересчитается

Частые вопросы

Нужно ли оплачивать интеграцию отдельно?

Нет, интеграция с YClients входит в стоимость Sport Groups, доплачивать за неё не нужно.

Как быстро синхронизируются записи?

Через webhook за несколько секунд. Для подстраховки каждые 5 минут запускается ещё и фоновая проверка.

Что произойдёт с существующими записями?

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

Можно ли синхронизировать только часть услуг?

Да. Синхронизируются только услуги и сотрудники (корты), которые настроены в маппинге. Остальные данные в YClients не затрагиваются.

Поддерживается ли синхронизация оплат?

Записи из YClients создаются со статусом «внешняя оплата». Оплаты каждая система обрабатывает сама.

Интеграция перестала работать после смены пароля в YClients

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

Что делать, если клиент без телефона записался через YClients?

Для создания пользователя в Sport Groups нужен телефон или email. Если в YClients у клиента нет ни того, ни другого, запись не импортируется. Добавь клиенту контактные данные в YClients.

Могу ли я настроить всё самостоятельно?

Шаги 1–5 и 7 ты выполняешь в своём аккаунте YClients. Шаг 6 (активацию интеграции на стороне Sport Groups) делаем мы. Передай нам собранные данные, и мы всё подключим.

Напиши нам
Напиши нам в Telegram