YClients + Telegram-бот: полный гайд по интеграции

Почему YClients так важен

YClients — это система онлайн-записи №1 в сегменте услуг в РФ. По нашим оценкам, он стоит в:

• ~40% салонов красоты
• ~25% стоматологий
• ~30% фитнес-клубов
• Плюс массажные салоны, барберы, ногтевые студии, тату-салоны

Если клиент спрашивает про бот для салона или клиники, YClients-интеграция — это killer feature, а не опция.

Что можно делать через API YClients

YClients даёт публичный REST API. Через него бот умеет:

1. Получать расписание мастеров / врачей

GET /company/{company_id}/staff — список мастеров

GET /book_staff/{company_id} — свободные слоты конкретного мастера

Это позволяет боту показывать клиенту реальные свободные окна в Telegram без перехода на сайт.

2. Создавать записи

POST /book_record/{company_id} — создать запись

Параметры: мастер, услуга, дата/время, телефон клиента, комментарий. После создания запись появляется в YClients как обычная. Администратор видит её в журнале.

3. Переносить / отменять записи

PUT /records/{record_id} — перенос

DELETE /records/{record_id} — отмена

Это позволяет боту принимать переносы от клиента в 2 клика, без звонка администратору.

4. Получать список услуг и цен

GET /company/{company_id}/services — прайс

Бот автоматически знает цены и может отвечать на «сколько стоит маникюр?» без ручного обновления.

5. Webhooks на события

YClients умеет присылать webhook'и:

• Новая запись (от любого источника)
• Отмена записи
• Перенос записи

Бот ловит webhook и отправляет клиенту уведомление в Telegram. Это заменяет SMS-напоминания, которые дороже и хуже читаются.

Подводные камни

1. Авторизация через Partner Token

YClients API требует два уровня auth:

• Partner Token — выдаётся YClients провайдеру (партнёру). Бесплатно, но подаётся заявка в поддержку.
• User Token — индивидуальный ключ каждого салона. Салон сам заходит в личный кабинет и подключает вашу интеграцию.

Если провайдер бота говорит "мы подключим YClients за 5 минут" — скорее всего, у него нет Partner Token'а и он делает это хаком. Потом посыпется.

2. Rate limits

YClients ограничивает: не более 60 запросов/минуту на компанию. Для салона 20 записей/день — это не проблема. Для сети с 10 точками — надо кэшировать расписание локально, а не дёргать API при каждом "покажи свободное время".

3. Депозиты не поддерживаются напрямую

YClients не умеет собирать депозит при записи. Если хотите снизить no-show депозитом (см. статью про no-show), бот должен:

1. Создать запись в YClients

2. Одновременно сгенерировать ссылку на оплату в ЮKassa / СБП

3. Отправить клиенту обе штуки

4. При оплате — записать факт в отдельный учёт (не в YClients)

Это делается через отдельную таблицу в БД бота, связанную с record_id YClients.

4. Разные филиалы = разные компании

В YClients каждая точка (филиал) — это отдельная "компания" с отдельным company_id. Если у вас сеть — бот должен уметь работать с несколькими company_id и роутить запросы по филиалам.

Как это устроено у Tyaga Lab

Наша YClients-интеграция:

• Partner Token есть (сертифицированный партнёр)
• Кэш расписания в Redis с TTL 30 минут — не бьём API на каждый запрос
• Webhook-слушатель на события YClients → автоматические уведомления в Telegram
• Депозиты через СБП — отдельная таблица deposits, связана с yclients_record_id
• Multi-company — сеть филиалов работает из коробки

Подключение занимает 1 день работы (включено в setup fee тарифа Бизнес).

Альтернативы YClients

Если у вас не YClients, есть альтернативы, которые мы тоже умеем:

• Altegio (бывший Beauty Pro) — аналогичный API
• Dikidi — попроще, но поддерживаем
• Bitrix24 CRM — нативно
• IDENT / Dental4Windows / Инфодент — для стоматологий
• Любая CRM через webhook — fallback вариант

ROI для салона

Типичный салон красоты 4 мастеров с YClients:

• Средний чек: 4 000 ₽
• Конверсия из обращения в запись без бота: 40%
• С ботом + мгновенный ответ: 65% (+25 п.п.)
• Приходят 100 обращений/мес → +25 дополнительных записей → +100 000 ₽ выручки/мес

Тариф Бизнес Tyaga Lab 24 900 ₽/мес → ROI ×4 в первый месяц.

Обсудить интеграцию с YClients →