Yclients

Приложение Yclients подключает один филиал к рабочему столу Promto. Агент работает с записями, клиентами, услугами, сотрудниками, расписанием, складом, финансами и программой лояльности в пределах выбранного филиала.

Назначение

Yclients удобно использовать для расписания на день, контроля загрузки сотрудников, анализа записей и клиентов, а также для подготовки согласованных изменений в выбранном филиале.

Подключение

Для подключения нужны три значения:

1. Partner token интеграции.
2. User token пользователя Yclients.
3. Числовой ID филиала.

Откройте приложение Yclients → Настройки, введите значения и нажмите Проверить и подключить. Promto проверит их запросом GET /api/v1/company/{company_id}.

Подключение принадлежит рабочему столу, но управлять им может только владелец. Токены сохраняются на сервере и не попадают в браузер после подключения или в песочницу агента.

Интерфейс и данные

На главной доступны сценарии Записи на сегодня и Загрузка сотрудников. В настройках показаны подключённый филиал, примеры методов, доступ агента, последняя ошибка и отключение.

Одно подключение всегда закреплено за одним company_id. Для второго филиала нужен другой рабочий стол или отдельное подключение после отключения текущего.

Возможности агента

Инструмент — promto_yclients. После capabilities агент использует, например:

• /api/v1/records/{company_id} — записи;
• /api/v1/clients/{company_id} — клиенты;
• /api/v1/company/{company_id}/staff/quick — сотрудники;
• /api/v1/services/{company_id} — услуги;
• /api/v1/finance_transactions/{company_id} — финансовые операции;
• /api/v1/record/{company_id} — создание записи после подтверждения.

Вместо {company_id} можно оставить шаблон: сервер подставит ID подключённого филиала и проверит, что запрос не пытается обратиться к другому филиалу.

Сценарии

Расписание на сегодня

Через promto_yclients сначала вызови capabilities, затем прочитай записи подключённого филиала на сегодня. Сгруппируй по сотрудникам и времени, ничего не меняй.

Свободные окна команды

Через promto_yclients прочитай сотрудников и доступное время выбранного филиала. Покажи свободные окна без создания записей.

Ограничения и подтверждения

• Запросы жёстко ограничены подключённым филиалом; явный другой company_id в пути, query или теле отклоняется.
• Создание и изменение записей, клиентов, товаров, складских и финансовых данных требует confirm=true после явного согласия.
• В Yclients есть отдельные GET-методы с побочным эффектом: отправка кода подтверждения, включение чаевых, генерация кода и платёжной ссылки. Promto также требует подтверждение для них.
• Права определяются одновременно partner token, user token и доступом пользователя к филиалу.
• Ответ прокси ограничен 512 КБ.

Если что-то не работает

• ID филиала не принимается. Используйте только числовой ID, а не название или адрес.
• 401. Один из токенов неверен или отозван.
• 403. У пользователя нет права на филиал или конкретный метод.
• Запрос отклонён как другой филиал. Уберите вручную подставленный ID и используйте {company_id}.
• Операция чтения просит подтверждение. Проверьте документацию метода: некоторые GET-вызовы Yclients отправляют код, включают функцию или создают платёжную ссылку.

Связанные материалы

• Интеграции
• Агенты
• Настройки Promto