← Назад к интеграциям

🗓️ YClients Integration

Интеграция с системой онлайн-записи YClients для сервисных AI-ассистентов

⚠️ Доступно только для: Service агентов (сервисные ассистенты)

Возможности

  • ✅ Проверка доступности слотов в YClients перед записью
  • ✅ Автоматическое создание записей в YClients
  • ✅ Синхронизация специалистов и услуг
  • ✅ Фоновая синхронизация каждые 10 минут
  • ✅ Защита от двойного бронирования
  • ✅ Маппинг внутренних ID на YClients ID

Настройка

Шаг 1: Получите данные YClients

  1. Войдите в личный кабинет YClients
  2. Перейдите в раздел API
  3. Скопируйте Partner Token
  4. Создайте учётную запись администратора для API
  5. Запишите логин и пароль
  6. Узнайте Company ID (в URL или через API)

Шаг 2: Включите интеграцию

  1. Откройте страницу агента → вкладка Интеграции
  2. Включите переключатель Интеграция с YClients
  3. Заполните поля:
    • Partner Token - из личного кабинета
    • Логин - логин администратора
    • Пароль - пароль администратора
    • Company ID - ID компании
  4. Настройте синхронизацию и кэш
  5. Нажмите Сохранить интеграции

Шаг 3: Настройте маппинг

  1. Откройте вкладку Специалисты и услуги
  2. Для каждого специалиста выберите соответствие в YClients
  3. Для каждой услуги выберите соответствие в YClients
  4. Сохраните маппинг

API Reference

Endpoints

GET /api/v1/yclients/:agentId/settings

Получить настройки интеграции (без секретов)

PUT /api/v1/yclients/:agentId/settings

Обновить настройки интеграции

GET /api/v1/yclients/:agentId/specialists

Список специалистов YClients

GET /api/v1/yclients/:agentId/services

Список услуг YClients

GET /api/v1/yclients/:agentId/slots

Проверка доступных слотов

POST /api/v1/yclients/:agentId/appointments

Создание записи

🔒 Безопасность

  • ✅ Все секреты шифруются (AES-256-CBC)
  • ✅ API возвращает только маскированные данные
  • ✅ Partner Token, логин и пароль хранятся в зашифрованном виде
  • ✅ Токены кэшируются (55 минут)
  • ✅ Данные слотов кэшируются (15 минут)

🐛 Troubleshooting

Ошибка аутентификации

Проблема: Неверный Partner Token или логин/пароль

Решение: Перепроверьте данные в личном кабинете YClients

Синхронизация не работает

Проблема: Специалисты/услуги не синхронизируются

Решение: Проверьте маппинг и включите синхронизацию в настройках

Двойное бронирование

Проблема: Запись на уже занятое время

Решение: Уменьшите TTL кэша слотов (минимум 5 минут)

← Все интеграцииCRM системы →