---
title: "Интеграция YClients: онлайн-запись клиентов через мессенджеры"
nav_title: "YClients"
url: https://docs.tuk-tuk.online/integrations/yclients
markdown: https://docs.tuk-tuk.online/integrations/yclients.md
section: "Интеграции"
description: "Как подключить YClients к tuk-tuk.online через маркетплейс: расписание мастеров, услуги, записи и клиенты в чате, метки и статусы посещения из цепочек, запись через AI-ассистента."
keywords: ["YClients интеграция мессенджер", "онлайн запись через Telegram", "YClients подключить бот", "CRM салон красоты", "запись клиентов чат-бот", "YClients бот записи", "напоминание о записи", "автозапись через мессенджер", "YClients Marketplace"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Интеграция YClients подключается через маркетплейс YClients и даёт доступ к записям, мастерам, услугам, клиентам, филиалам и меткам. AI-ассистент записывает клиентов из чата, цепочки меняют статус посещения, метки и цвет записи.
>
> - Где: «Интеграции» → YClients → «Подключить» → страница приложения в маркетплейсе YClients → возврат на lk.tuk-tuk.online/yclients/callback → подтверждение.
> - Подпись возврата из маркетплейса проверяется по HMAC-SHA256; ручной ввод токенов не предусмотрен.
> - Действия в цепочках: yc_change_attendance (2, 1, 0, -1), yc_add_label, yc_remove_label, yc_change_color.
> - Без ID записи действие применяется к ближайшей записи клиента, найденного по телефону.
> - Нужна подписка YClients с доступом к API; поддерживаются несколько филиалов в одной интеграции.
> - Страница интеграции в кабинете: карточка компании, записи, сотрудники, услуги, поиск клиентов, создание и отмена записи.
>
> Связанные страницы: https://docs.tuk-tuk.online/ai/calendar-booking, https://docs.tuk-tuk.online/chains/blocks/integration, https://docs.tuk-tuk.online/calendar/events, https://docs.tuk-tuk.online/integrations/google-calendar, https://docs.tuk-tuk.online/integrations

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

YClients ведёт расписание салонов, клиник, автосервисов и фитнес-клубов. Интеграция открывает это расписание мессенджерам: клиент пишет боту «хочу подстричься в пятницу», AI-ассистент смотрит свободные окна мастеров в YClients, предлагает время и создаёт запись, не выводя клиента из чата.

Записями можно управлять и из tuk-tuk.online: смотреть расписание, создавать и отменять записи, менять статус посещения и метки из цепочек.

## Что синхронизируется

| Данные YClients | Чтение | Запись |
|---|---|---|
| Записи | Расписание за период, записи клиента | Создание записи, отмена, статус посещения, метки, цвет |
| Сотрудники | Список мастеров с рейтингом и специализацией | Нет |
| Услуги | Каталог с ценами и длительностью, услуги конкретного мастера | Нет |
| Клиенты | Поиск по имени и телефону | Клиент создаётся вместе с первой записью |
| Метки записей | Список меток компании | Добавление и удаление метки на записи |
| Филиалы | Список филиалов и карточка компании (город, адрес, телефон, сайт, часовой пояс, расписание) | Выбор филиала для записи |

## Что нужно на стороне YClients

- Подписка YClients с доступом к API.
- Права владельца или администратора компании: установка приложений из маркетплейса доступна только им.
- Один или несколько филиалов: интеграция поддерживает мультифилиалы, филиал выбирается при записи.

## Как подключить


![Подключение YClients](https://docs.tuk-tuk.online/assets/screens/integrations/yclients.webp "YClients подключается через маркетплейс: установите интеграцию там, вас вернут обратно для подтверждения.")

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

1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите YClients и нажмите «Подключить»: появится подсказка «Подключение происходит через маркетплейс YClients» и ссылка на страницу приложения.
2. Перейдите по ссылке в маркетплейс YClients и нажмите «Подключить» на странице приложения tuk-tuk.online.
3. Дождитесь возврата на `lk.tuk-tuk.online/yclients/callback`: платформа проверит подпись HMAC-SHA256 от YClients и покажет экран подтверждения.
4. Подтвердите подключение: интеграция активируется через Partner API YClients, карточка получит отметку «Интеграция подключена».
5. Нажмите «Управлять»: откроется страница YClients в кабинете с карточкой компании, записями, сотрудниками, услугами и клиентами.

## Проверить, что работает

1. На странице YClients в кабинете откройте вкладку «Сотрудники»: список мастеров загрузился из YClients.
2. Откройте «Записи» за текущую неделю: видны записи из журнала YClients.
3. Создайте тестовую запись (телефон, имя, email, комментарий): она появится в журнале YClients у выбранного мастера.

## Что происходит после подключения

| Событие | Действие платформы |
|---|---|
| Клиент просит записаться в чате | AI-ассистент в режиме [Запись в календарь](https://docs.tuk-tuk.online/ai/calendar-booking) читает услуги, мастеров и свободные окна и создаёт запись в YClients |
| Клиент просит отменить запись | Запись удаляется в YClients |
| Цепочка дошла до действия YClients | Меняется статус посещения, метка или цвет записи |
| Оператор создал запись в кабинете | Запись появляется в журнале YClients с указанным клиентом |

## YClients в цепочках

Действия доступны в блоке [Интеграция с CRM](https://docs.tuk-tuk.online/chains/blocks/integration). Если ID записи не указан, платформа находит клиента в YClients по телефону и берёт его ближайшую запись начиная с сегодняшнего дня.

| Действие | Ключ | Что делает |
|---|---|---|
| Изменить посещаемость | `yc_change_attendance` | Ставит статус посещения записи: 2 подтвердил, 1 пришёл, 0 ожидание, -1 не пришёл |
| Добавить метку | `yc_add_label` | Добавляет метку к записи, существующие метки сохраняются |
| Удалить метку | `yc_remove_label` | Снимает метку с записи |
| Изменить цвет | `yc_change_color` | Меняет цвет записи в журнале |

> [!TIP] Клиент подтвердил визит в чате: цепочка ставит статус «подтвердил» и зелёный цвет записи. Администратор видит подтверждение в журнале YClients без звонка.

## Что умеет AI-ассистент

С доступом к YClients ассистент отвечает на вопросы в естественном разговоре:

- «Когда можно записаться на маникюр?»: показывает свободные окна.
- «Кто свободен в субботу?»: предлагает мастера.
- «Запишите меня на 15:00 к Марии»: создаёт запись.
- «Хочу отменить запись на пятницу»: отменяет запись.
- «Сколько стоит стрижка?»: называет цену из каталога услуг.

## Ограничения

- Подключение только через маркетплейс YClients; ручной ввод токенов не предусмотрен.
- Данные читаются из API YClients в момент запроса, локальной копии расписания нет.
- Действия цепочек работают с одной записью: последней записью клиента или записью с указанным ID.

## Частые проблемы

| Проблема | Что делать |
|---|---|
| AI не видит расписание | Проверьте, что интеграция активна и в настройках ассистента выбран филиал |
| Не создаётся запись | Убедитесь, что у мастера есть свободное окно нужной длительности и услуга привязана к мастеру |
| Ошибка авторизации | Переустановите приложение из маркетплейса YClients и подтвердите подключение заново |
| Филиалы не загружаются | Проверьте, что у аккаунта YClients есть доступ к API и приложение установлено для нужной компании |
| Пришёл возврат из маркетплейса с ошибкой подписи | Начните подключение заново со страницы приложения в маркетплейсе, не редактируя адрес возврата |