Интеграция с 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: Через аккаунт разработчика
- Войди в YClients: yclients.com
- Перейди в раздел Интеграции → Аккаунт разработчика
- Зарегистрируйся как разработчик (если ещё не зарегистрирован)
- Открой Настройки аккаунта → Данные аккаунта
- Скопируй значение поля «Токен партнера»
Способ 2: Через поддержку YClients
- Напиши на support@yclients.com
- Укажи, что тебе нужен партнёрский токен для интеграции
- Укажи свой email и ФИО
- Токен пришлют в ответном письме
Шаг 2. Получить User Token (токен пользователя)
User Token нужен для доступа к данным конкретной компании.
Способ 1: Через интерфейс YClients
- Перейди в Аккаунт разработчика → Добавить приложение
- Выбери тип приложения: «Непубличное»
- Заполни данные и сохрани
- Открой раздел «Мои приложения» → «Доступ к API»
- Скопируй User Token
Способ 2: Через логин и пароль
Если есть логин и пароль от YClients, User Token можно получить автоматически через API. Передай нам логин и пароль, и мы получим токен.
Шаг 3. Определить ID компании (филиала)
ID компании — это числовой идентификатор твоего филиала в YClients.
Как найти
- Войди в личный кабинет YClients
- Открой нужный филиал
- Посмотри URL в адресной строке браузера:
https://yclients.com/company/12345/...
Число 12345 — это твой Company ID.
Шаг 4. Создать услуги в YClients
Для синхронизации записей в YClients нужны услуги под каждую длительность бронирования в Sport Groups.
Где создавать
- Войди в YClients: yclients.com
- Перейди в Настройки → Услуги
- Создай услугу для каждой длительности бронирования
Пример настройки услуг
Если у тебя аренда кортов на 60, 90 и 120 минут, создай три услуги:
| Название услуги | Длительность | Цена |
|---|---|---|
| Аренда 60 минут | 60 мин | Твоя цена |
| Аренда 90 минут | 90 мин | Твоя цена |
| Аренда 120 минут | 120 мин | Твоя цена |
Шаг 5. Настроить ресурсы (корты) в YClients
В YClients корты, площадки и залы представлены как ресурсы. Каждому корту в Sport Groups должен соответствовать ресурс в YClients. По ID ресурса (Resource Instance ID) система определяет, на какой корт сделана запись.
Что такое ресурсы в YClients
Ресурсы — это объекты, которые можно бронировать: корты, залы, площадки, столы и т.д. В отличие от сотрудников, ресурсы не привязаны к конкретному человеку, поэтому для бронирования физических объектов они подходят лучше.
Как создать ресурсы
- В YClients перейди в Настройки → Ресурсы
- Создай ресурс для каждого корта/площадки
- Привяжи к каждому ресурсу услуги из Шага 4
Как найти Resource Instance ID
Для настройки интеграции нужно узнать ID созданного ресурса:
- Открой созданный ресурс в YClients
- Посмотри URL в адресной строке браузера: в нём будет ID ресурса
- Или передай нам доступ (шаг 6), и мы получим ID через API
Пример настройки
| Ресурс в YClients | Resource Instance ID | Корт/площадка в Sport Groups |
|---|---|---|
| Корт 1 | 101 | Корт 1 |
| Корт 2 | 102 | Корт 2 |
| Корт 3 | 103 | Корт 3 |
Шаг 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 о новых записях, отменах и изменениях.
Как настроить
- В YClients перейди в Интеграции → Webhooks (или Настройки → Уведомления → Webhooks)
- Нажми «Добавить webhook»
- Укажи URL (адрес мы пришлём, он будет такого вида):
https://ваш-домен.sportgroups.ru/yclients_webhook/ - Выбери события:
- Создание записи (record.created)
- Удаление записи (record.deleted)
- Изменение записи (record.updated)
- Если есть поле Secret, введи секретный ключ (его мы тоже пришлём). По нему проверяется подлинность уведомлений.
- Сохрани webhook
Как работает синхронизация
Записи из YClients → Sport Groups
Когда клиент записывается через YClients:
- YClients отправляет webhook-уведомление в Sport Groups
- Sport Groups находит нужный корт по Resource Instance ID
- Если клиента нет в базе, он создаётся автоматически (по телефону или email)
- Создаётся бронирование, привязанное к записи YClients
Кроме того, раз в 5 минут запускается фоновая синхронизация: она проверяет новые и удалённые записи на 90 дней вперёд. Это страховка на случай, если webhook не дошёл.
Записи из Sport Groups → YClients
Когда клиент записывается через Telegram-бота или веб-виджет:
- После успешной оплаты Sport Groups автоматически создаёт запись в YClients
- Услуга подбирается по длительности бронирования
- В комментарий к записи добавляется ссылка на Sport Groups
- Если клиента нет в 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) делаем мы. Передай нам собранные данные, и мы всё подключим.