Навык «YCLIENTS»

Навык подключает Искру к YCLIENTS вашего салона: записи и журнал, свободное время мастеров, клиенты, услуги и цены, сотрудники и графики, онлайн-запись, деньги, склад, лояльность, рассылки, отзывы и аналитика. Любое изменение уходит в YCLIENTS только после вашего подтверждения в форме.

Подключение

Навык работает с ключами собственного непубличного приложения вашего салона в YCLIENTS.

Войдите в YCLIENTS и откройте кабинет разработчика (yclients.ru/appstore/developers). В «Настройках аккаунта» скопируйте API-ключ.
Создайте приложение с типом «Непубличное», отметьте нужные права (записи, клиенты, услуги и т. д.) и скопируйте «User token».
Откройте ссылку приложения из раздела «Общая информация» и нажмите «Подключить» для своего филиала.
В Искре откройте «Навыки» → каталог → YCLIENTS и установите навык лично или в организацию. На карточке нажмите «Требует настройки» (позже — страница навыка → вкладка «Настройки»). Если доступны оба варианта, выберите в строке «Кому доступно» вверху окна «Только мне» или «Всей организации». В группе «Подключение YCLIENTS» заполните:
- API-ключ разработчика YCLIENTS — значение из шага 1.
- Токен пользователя приложения (User token) — значение из шага 2.

Можно начать и из чата: попросите «подключи YCLIENTS». Если ключи ещё не заданы или YCLIENTS их отклонил, Искра откроет форму навыка поверх чата. Ключи вводите только в эту форму, а не в сообщение.

Попросите Искру проверить подключение: она покажет филиалы, доступные токену. Если Искра отвечает, что ключи приняты, но приложение не подключено ни к одному филиалу, вернитесь к шагу 3 и нажмите «Подключить» для своего филиала. Если филиалов несколько, называйте филиал в просьбе — иначе Искра уточнит, о каком речь.

Общее подключение организации один раз настраивает владелец или администратор. Оно доступно сотрудникам, которым предоставлен этот навык. Личное подключение доступно только вам и полностью замещает организационное. Подробнее — Группы настроек.

Сохранённые ключи скрыты: их можно заменить, но нельзя посмотреть. Навык может только то, что разрешено приложению в кабинете разработчика YCLIENTS.

Что можно попросить

«Что у нас завтра?», «у кого из мастеров свободно в субботу после 15?»
«Запиши Иванову к Ольге на маникюр в пятницу в 14:00», «перенеси запись», «отмени запись».
«Подними цену на стрижку», «создай форму записи только на массаж».
«Оприходуй поставку по накладной», «начисли бонусы на карту», «заморозь абонемент».
«Отправь SMS-рассылку клиентам, которые не были с августа».
«Какие групповые занятия завтра? Запиши Иванову на йогу в 19:00».

Свободное время Искра ищет по журналу филиала за период до 14 дней: по услугам (длительность и мастера берутся из услуги) или по заданной длительности, при необходимости — у конкретных мастеров и в заданные часы.

Подтверждение изменений

Перед любым изменением Искра показывает форму со всем, что будет отправлено в YCLIENTS: какой запрос уходит, параметры, поля, позиции документа таблицей. Изменение уходит только после «Подтвердить». Отказ, закрытие формы или отсутствие ответа ничего не отправляют. Форма вмещает документ на несколько сотен позиций (проверено на 600); изменение крупнее Искра предложит оформить прямо в YCLIENTS.

Поля в форме названы так, как их принимает YCLIENTS, с короткой подписью; объекты указаны номерами (id), а их названия Искра называет в своём сообщении.

Навык не предлагает разрешение действовать без подтверждения: каждое изменение ждёт вашего ответа. Прогоны Искры из «Планов» идут без вас, поэтому в них навык только читает данные и сообщает итог.

Если YCLIENTS не ответил на подтверждённое изменение, Искра сначала проверяет результат чтением. Повтор — снова через форму.

Уведомления о новых записях

Попросите «каждый час присылай новые и отменённые записи» — Искра создаст в «Планах» запись с прогоном Искры раз в час. Каждый прогон покажет записи YCLIENTS, изменённые за последние 70 минут. На стыке часов запись может повториться. В каждой сводке Искра называет проверенное окно времени. Если между прогонами прошло больше 70 минут (например, прогон начался позже), изменения в этом промежутке в уведомление не попадут — попросите «покажи изменения за …». Чтобы остановить уведомления, удалите эту запись в «Планах». Запись в «Планах» не зависит от навыка: если навык отключён или ключи удалены, прогон сообщит, что YCLIENTS недоступен, — удалите запись.

Ограничения

Сертификаты — только просмотр: в YCLIENTS нет операций их изменения.
Зарплаты — только просмотр: начисления и расчёты Искра показывает, но не меняет.
Акции сети можно посмотреть и создать, но не изменить или удалить. Эти операции YCLIENTS выполняет по одному API-ключу разработчика и не ограничивает правами пользователя приложения и филиалами салона, поэтому навык их не вызывает — измените или удалите акцию в YCLIENTS.
Удалить расписание групповых событий можно только в YCLIENTS: в описании API YCLIENTS для этой операции не указано, с какими ключами она выполняется, поэтому навык её не вызывает.
Рассылка по фильтру без фильтров уйдёт всем клиентам филиала — форма подтверждения предупреждает об этом.
Оплата лицензии, изменение и удаление компании, права пользователей YCLIENTS — вне навыка.
Новый филиал после создания нужно оплатить в YCLIENTS и подключить к приложению.
Ошибка 403 означает, что YCLIENTS не разрешил действие: отметьте нужное право в приложении в кабинете разработчика или проверьте права пользователя приложения в филиале.
YCLIENTS ограничивает частоту запросов. Если лимит достигнут, Искра сообщит об этом: изменение в этом случае не отправлено — повторите через минуту; для чтения помогает сузить запрос (период, мастер, фильтры).