О добавлении и настройке сервисов на странице Сервис
Содержание
Подключение
Добавление — с вводом логина и пароля, от чьего имени работает интеграция.
Один аккаунт Yclients может быть подключен в несколько проектов, если добавление происходит из под разных пользователей Yclients.
При подключении сервиса в систему подгружаются следующие данные аккаунта:
- Пользователи
- Филиалы (компании)
- Дополнительные поля
- Услуги
При необходимости актуализации данных в MoreKIT, после изменения их на стороне Yclients, можно вручную запустить обновление.
Настройки сервиса
Пользователи
Здесь отображаются пользователи полученные из аккаунта amoCRM.
Каждому пользователю может быть назначено расписание, в котором он работает, для использования в функции “Выбор пользователя” ( Общие функции)
Группы
Страница предназначена для создания групп пользователей и управления приоритетом распределения внутри них.
Источники
Yclients вебхук
Предназначен для обработки хуков Yclients. Возможные фильтры для входящих данных:
- ID компании
- ID ресурса
- ресурс — запись/клиента/компания/категория услуг/услуга/сотрудник/финансовая операция
- статус — создано/обновлено/удалено
Для фильтров доступны все данные сущности. Для этого надо в стартовом блоке выбрать фильтр {{ресурс}}, после чего в правой части выбрать ожидаемую сущность.
В случае если сущностей больше одной, вы можете произвольно обратиться ко входящим данным через маску input.
Например:
{{input.attendance}}— статус записи{{input.importance_id}}— важность клиента
Функции
Функции Yclients соответствуют методам REST API Yclients и разделены по типу сущностей: Клиенты, Сетевые клиенты, Записи.
Доступные функции:
- Клиенты
- Добавить клиента
- Изменить клиента
- Получить клиента
- Сетевые клиенты
- Найти клиента по телефону
- Записи
- Создать запись
- Удалить запись
- Изменить запись
- Найти запись
Изменение
Функции изменения очень требовательны к заполняемым полям, поэтому, если необходимо изменить какое-то поле записи без изменения остальных, необходимо предварительно сделать поиск этой записи и в блоке изменения заполнить все обязательные поля масками со ссылками на эти же поля из поиска.
Для передачи услуг в неизменном составе в функции “Изменить запись” есть поле “Массив услуг”, в которое можно передать маску вида {{#3.массив услуг}}.
Поиск
При поиске сущностей следует опираться на значения при которых результат будет наиболее точным (в идеале через ID записи или ID клиента), чтобы исключить возможность возврата более одной сущности.