YCLIENTS API в n8n: записи и напоминания клиентам

В этой статье вы получите токены YCLIENTS, подключите их к n8n и соберёте сценарий напоминаний о записи и сбора отзывов. Методы сверены с документацией YCLIENTS REST API в октябре 2026 года.

Что понадобится

• Аккаунт разработчика в маркетплейсе интеграций YCLIENTS.
• Отдельный пользователь YCLIENTS для сценария с доступом только к нужному филиалу и разделам.
• ID филиала (company_id).
• n8n на своём сервере с HTTPS, если нужны вебхуки.

Шаг 1. Получить партнёрский токен

Зарегистрируйтесь в маркетплейсе интеграций YCLIENTS и скопируйте API-ключ в разделе «Настройки аккаунта». Это партнёрский токен. Он подтверждает, что запрос идёт от вашего приложения.

Шаг 2. Получить пользовательский токен

Для доступа к записям и клиентам нужен ещё пользовательский токен. Его выдаёт метод авторизации:

curl -X POST https://api.yclients.ru/api/v1/auth \
  -H "Accept: application/vnd.yclients.v2+json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ПАРТНЁРСКИЙ_ТОКЕН" \
  -d '{"login": "+79990000000", "password": "пароль"}'

При успешном входе приходит ответ 201 с полем user_token. Если у пользователя включена двухфакторная аутентификация, метод сначала вернёт 200 и потребует отправить код подтверждения вторым запросом.

После смены пароля пользователя его токен меняется, и сценарий перестанет работать. Поэтому для n8n заведите отдельного пользователя и не меняйте ему пароль без нужды.

Шаг 3. Создать доступ в n8n

YCLIENTS ждёт оба токена в одном заголовке через запятую. В Credentials создайте доступ типа Header Auth:

• Name: Authorization
• Value: Bearer ПАРТНЁРСКИЙ_ТОКЕН, User ПОЛЬЗОВАТЕЛЬСКИЙ_ТОКЕН

В каждом узле HTTP Request добавьте заголовок Accept со значением application/vnd.yclients.v2+json. Без него API не поймёт версию формата ответа.

Шаг 4. Получить записи

GET https://api.yclients.ru/api/v1/records/{company_id}?start_date=2026-10-10&end_date=2026-10-10&count=50&page=1

Полезные параметры:

• start_date и end_date: дата сеанса;
• c_start_date и c_end_date: дата создания записи;
• changed_after: записи, созданные или изменённые после указанного момента;
• staff_id и client_id: записи конкретного сотрудника или клиента.

Дату завтрашнего дня в n8n удобно подставить выражением:

{{ $now.plus({ days: 1 }).toFormat('yyyy-MM-dd') }}

Записи лежат в data. Для сценариев важны поля id, datetime, client.name, client.phone, services, staff.name, deleted и attendance. Значения attendance: 2 клиент подтвердил запись, 1 клиент пришёл, 0 ожидание, −1 клиент не пришёл.

Шаг 5. Вебхуки о новых записях

Опрашивать API не обязательно. В настройках филиала YCLIENTS есть раздел WebHook, право на изменение его настроек описано и в документации API. Включите отправку, укажите production-адрес узла Webhook из n8n и выберите события, например создание, изменение и удаление записи.

Точное название пункта меню и формат тела запроса уточните в справке YCLIENTS. Надёжнее всего создать тестовую запись и посмотреть, что пришло в n8n. Если вебхуки настроить не получается, используйте Schedule Trigger раз в 5–10 минут и параметр changed_after. Подробнее о приёме событий в статье о вебхуках в n8n.

Шаг 6. Собрать сценарий напоминаний и отзывов

Напоминание о записи:

1. Schedule Trigger каждый день, например в 12:00.
2. HTTP Request: записи на завтра.
3. Filter: deleted равно false, attendance не равно −1.
4. Отправка напоминания по выбранному каналу.

Перед запуском проверьте встроенные уведомления YCLIENTS. В записи есть поле notify_by_sms: за сколько часов отправить SMS-напоминание. Если они уже включены, клиент получит два сообщения.

Сбор отзывов после визита:

1. Schedule Trigger вечером: записи за сегодня с attendance равным 1.
2. Сообщение клиенту с просьбой оценить визит.
3. Оценка 4–5: ссылка на карточку компании в Яндекс Картах или 2ГИС.
4. Оценка 1–3: уведомление управляющему, чтобы он связался с клиентом.

Каналы отправки

Имя клиента, телефон и время визита относятся к персональным данным. Если они уходят в Telegram, это передача данных на серверы за рубежом, и для неё у вас должны быть основания по 152-ФЗ. Компромисс для Telegram: короткое сообщение без имени и услуги, а детали по ссылке на вашем сайте. Для клиник и других чувствительных услуг используйте только SMS или MAX. Подробнее в статье о 152-ФЗ и автоматизации. Это общая информация, она не заменяет консультацию юриста.

Условия создания ботов в MAX уточните на портале разработчиков MAX.

Частые ошибки

• 401 «Необходима авторизация». Неверный формат заголовка. Проверьте запятую и слово User перед пользовательским токеном.
• Сценарий работал и перестал. Пользователю сменили пароль, и пользовательский токен стал недействительным. Получите новый.
• 429. YCLIENTS разрешает 200 запросов в минуту или 5 запросов в секунду с одного IP-адреса. Включите в HTTP Request Batching с паузой.
• Вебхук не срабатывает. В YCLIENTS указан тестовый адрес n8n или сценарий не активирован.
• Время записи сдвинуто. datetime приходит со смещением часового пояса. Форматируйте его с учётом пояса филиала.