YClients ведёт расписание салонов, клиник, автосервисов и фитнес-клубов. Интеграция открывает это расписание мессенджерам: клиент пишет боту «хочу подстричься в пятницу», AI-ассистент смотрит свободные окна мастеров в YClients, предлагает время и создаёт запись, не выводя клиента из чата.
Записями можно управлять и из tuk-tuk.online: смотреть расписание, создавать и отменять записи, менять статус посещения и метки из цепочек.
#Что синхронизируется
| Данные YClients | Чтение | Запись |
|---|---|---|
| Записи | Расписание за период, записи клиента | Создание записи, отмена, статус посещения, метки, цвет |
| Сотрудники | Список мастеров с рейтингом и специализацией | Нет |
| Услуги | Каталог с ценами и длительностью, услуги конкретного мастера | Нет |
| Клиенты | Поиск по имени и телефону | Клиент создаётся вместе с первой записью |
| Метки записей | Список меток компании | Добавление и удаление метки на записи |
| Филиалы | Список филиалов и карточка компании (город, адрес, телефон, сайт, часовой пояс, расписание) | Выбор филиала для записи |
#Что нужно на стороне YClients
- Подписка YClients с доступом к API.
- Права владельца или администратора компании: установка приложений из маркетплейса доступна только им.
- Один или несколько филиалов: интеграция поддерживает мультифилиалы, филиал выбирается при записи.
#Как подключить
Подключение идёт только через маркетплейс YClients: ключи вручную вводить не нужно.
- Откройте раздел Интеграции, выберите YClients и нажмите «Подключить»: появится подсказка «Подключение происходит через маркетплейс YClients» и ссылка на страницу приложения.
- Перейдите по ссылке в маркетплейс YClients и нажмите «Подключить» на странице приложения tuk-tuk.online.
- Дождитесь возврата на
lk.tuk-tuk.online/yclients/callback: платформа проверит подпись HMAC-SHA256 от YClients и покажет экран подтверждения. - Подтвердите подключение: интеграция активируется через Partner API YClients, карточка получит отметку «Интеграция подключена».
- Нажмите «Управлять»: откроется страница YClients в кабинете с карточкой компании, записями, сотрудниками, услугами и клиентами.
#Проверить, что работает
- На странице YClients в кабинете откройте вкладку «Сотрудники»: список мастеров загрузился из YClients.
- Откройте «Записи» за текущую неделю: видны записи из журнала YClients.
- Создайте тестовую запись (телефон, имя, email, комментарий): она появится в журнале YClients у выбранного мастера.
#Что происходит после подключения
| Событие | Действие платформы |
|---|---|
| Клиент просит записаться в чате | AI-ассистент в режиме Запись в календарь читает услуги, мастеров и свободные окна и создаёт запись в YClients |
| Клиент просит отменить запись | Запись удаляется в YClients |
| Цепочка дошла до действия YClients | Меняется статус посещения, метка или цвет записи |
| Оператор создал запись в кабинете | Запись появляется в журнале YClients с указанным клиентом |
#YClients в цепочках
Действия доступны в блоке Интеграция с CRM. Если ID записи не указан, платформа находит клиента в YClients по телефону и берёт его ближайшую запись начиная с сегодняшнего дня.
| Действие | Ключ | Что делает |
|---|---|---|
| Изменить посещаемость | yc_change_attendance | Ставит статус посещения записи: 2 подтвердил, 1 пришёл, 0 ожидание, -1 не пришёл |
| Добавить метку | yc_add_label | Добавляет метку к записи, существующие метки сохраняются |
| Удалить метку | yc_remove_label | Снимает метку с записи |
| Изменить цвет | yc_change_color | Меняет цвет записи в журнале |
#Что умеет AI-ассистент
С доступом к YClients ассистент отвечает на вопросы в естественном разговоре:
- «Когда можно записаться на маникюр?»: показывает свободные окна.
- «Кто свободен в субботу?»: предлагает мастера.
- «Запишите меня на 15:00 к Марии»: создаёт запись.
- «Хочу отменить запись на пятницу»: отменяет запись.
- «Сколько стоит стрижка?»: называет цену из каталога услуг.
#Ограничения
- Подключение только через маркетплейс YClients; ручной ввод токенов не предусмотрен.
- Данные читаются из API YClients в момент запроса, локальной копии расписания нет.
- Действия цепочек работают с одной записью: последней записью клиента или записью с указанным ID.
#Частые проблемы
| Проблема | Что делать |
|---|---|
| AI не видит расписание | Проверьте, что интеграция активна и в настройках ассистента выбран филиал |
| Не создаётся запись | Убедитесь, что у мастера есть свободное окно нужной длительности и услуга привязана к мастеру |
| Ошибка авторизации | Переустановите приложение из маркетплейса YClients и подтвердите подключение заново |
| Филиалы не загружаются | Проверьте, что у аккаунта YClients есть доступ к API и приложение установлено для нужной компании |
| Пришёл возврат из маркетплейса с ошибкой подписи | Начните подключение заново со страницы приложения в маркетплейсе, не редактируя адрес возврата |