Yclients: инструкция

Последние изменения: 04.02.2026

Yclients

Информация

YCLIENTS - облачная платформа по автоматизации бизнес-процессов компаний сферы услуг. Это сервис онлайн-записи клиентов, автоматизации и управления бизнесом в сфере услуг: учет, склад, статистика, SMS, работа с клиентами и др.

Возможности виджета

Благодаря виджету интеграции amoCRM и YCLIENTS у Вас появляется возможность синхронизировать базы контактов, записывать клиентов к специалисту из виджета в amoCRM и настроить автоматическое создание сделок в аmoCRM при записи из личного кабинета YCLIENTS.

Установка виджета

Предупреждение

Интеграция amoCRM с YCLIENTS доступна только на тарифах "Расширенный" и "Профессиональный".

Виджет YCLIENTS устанавливается из маркетплейса amoCRM и является бесплатным.

59deeac2c4a45c13765e15d9735d1f33.png

Для установки виджета необходимо дать согласие на передачу персональных данных и нажать кнопку "Установить".

01090cb6fa674ea308cfb221033dbcc5.png

Далее, в появившемся окне, требуется ввести логин и пароль от личного кабинета YCLIENTS и нажать кнопку "Сохранить".

Предупреждение

Для корректной работы требуется указать логин/пароль аккаунта с правами администратора (полными правами) в YCLIENTS.

8218b0ab2e0aac3ec956565fdb6f9a11.png

После проделанных действий потребуется перейти в расширенные настройки интеграции и задать основную логику работы.

При установке виджета в аккаунте amoCRM, автоматически будут созданы дополнительные поля в сущностях Сделка и Контакт.

Сделка:

  • ID записи, YClients (тип поля "Текст");
  • ID документа, YClients (тип поля "Текст");
  • Дата записи, YClients (тип поля "Текст");
  • Сотрудник, YClients (тип поля "Текст");
  • Длительность процедуры, YClients (тип поля "Текст");
  • Время записи, YClients (тип поля "Текст").
cf6f0b5ad2d7f41a4f3a38caba8883ab.png

Контакт:

  • Общая сумма (LTV), YClients (тип поля "Число");
  • Кол-во визитов, YClients (тип поля "Число");
  • ID клиента, YClients (тип поля "Число").
5faf0a72bf998aff81eeb9a4f96df81d.png

А также будут созданы дополнительные списки: Услуги, YClients и Товары, YClients. В эти списки автоматически будут переданы данные об услугах и товарах из аккаунта YCLIENTS.

a587cdf865d639a567c10d0e9514f382.png

b8336b630390010a40446cc0718c6ba6.png

e824e43252af2bb70cd29916c7ac3101.png

Данные товары или услуги прикрепляются к сделкам в amoCRM при создании записи в YCLIENTS (в том числе через виджет).

Технические детали

Стоит учитывать, что если прикрепить товар или услугу к сделке amoCRM вручную, то это изменение не передастся в запись YCLIENTS, в данном случае интеграция односторонняя: из YCLIENTS в amoCRM - да; из amoCRM в YCLIENTS - нет.

c97d445bfec34166eb2da4eb1d4fbe60.png

Для использования этих списков в сделках требуется добавить их в настройках полей. Инструкция представлена в скриншотах:

270392e9fdc80a4132e4d2b2b42cc833.png

6f265606882eca6872abc4ec8a18c91d.png

dbd0441c483a77e80d6e50274a517ec3.png

Предупреждение

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

60dd70888e7f48b4efb42fdb0da3246c.png

Для того, чтобы узнать из-под какого пользователя amoCRM установлен виджет YCLIENTS можно или перейти в Настройки-Интеграции, найти в списке интеграций YCLIENTS, открыть модальное окно и перейти во вкладку "Выданные доступы". Здесь должен быть указан Администратор аккаунта. Если ни один пользователь не указан, то работа интеграции будет нарушена и потребуется переустановка виджета.

Настройка интеграции

После установки виджета должны автоматически настроиться вебхуки, как в аккаунте amoCRM, так и в личном кабинете YC. Для работы интеграции настройка вебхуков критична, поэтому после установки требуется проверять корректность вебхуков.

Для проверки вебхука в amoCRM требуется перейти в Настройки-Интеграции и открыть окно настроек вебхуков:

d77670aca893b1b94756b76e7e27bbba.png

В появившемся окне должен присутствовать и быть включенным вебхук yclients.get8.ru/amocrm/callback/, где - домен вашего аккаунта amoCRM, а в списке событий выбраны следующие события:

  • Пункт добавлен;
  • Статус сделки изменен.
df33ac68b2e853b8b7873dac224186e6.png

b90510e126be136e07ae9ce63de078eb.png

Технические детали

Если вебхук отсутствует, его необходимо создать вручную с помощью кнопки "Добавить хук".

Если вебхук есть, но он выключен, то требуется включить вебхук.

Для проверки вебхука в YCLIENTS требуется перейти в Настройки-Системные настройки-WebHook. В открывшемся окне должен быть указан URL yclients.get8.ru/yclients/callback/, где - субдомен вашего аккаунта amoCRM, в поле "Отправлять хуки" выберите вариант "Отправлять", а также отметьте события:

  • Событие по товару;
  • Событие по услуге;
  • Событие по клиентам;
  • Событие по записям;
  • Событие по продаже товара;
  • Событие по финансовым операциям.

f0cb06ff1ecb6e25b0092d6e8179e718.png

aa283f6ff4ed6dc0bdc9503a149383fb.png

01929279642990ffbccae406c306a926.png

b2b412972036be7fff4359471a61cb2f.png

Если вебхук отсутствует, то создайте его вручную с помощью кнопки "Добавить" и настройте в соответствии со скриншотами.

Предупреждение

В настройках вебхуков следует указывать только те события, которые указаны в данной инструкции. Иные события, даже при указании их в настройках, не обрабатываются сервером.

Для того, чтобы перейти в настройки виджета YCLIENTS необходимо перейти в раздел Настройки => YCLIENTS.

fa9f01b01cb166c7156e995f48dd5405.png

В настройках виджета присутствует 4 раздела:

  • Филиалы;
  • Сделки;
  • Синхронизация;
  • Дополнительные поля.

Филиалы

В данном разделе необходимо выбрать филиалы, которые будут использоваться для интеграции с amoCRM. Выбранные филиалы будут доступны при использовании виджета в карточке сделки. Также по ним синхронизируются контакты, имеющиеся в YCLIENTS до установки виджета (клиенты передаются только после первой установки виджета YCLIENTS).

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

035813d262b2dd8cfea0413985769450.png

Предупреждение

Для того, чтобы у Вас была возможность выбрать филиалы, в YCLIENTS должна быть создана сеть филиалов, и выбран главный филиал в этой сети. Иначе филиалы не отобразятся в выпадающем списке филиалов в настройках виджета.

da55915412a04fe2e0c498fb46314b65.png

Сделки

Создание сделок:

e7813d436f6547d3116d12dcbb659c00.png

Если переключатель "Создание сделки без контакта" активен, то вы сможете создавать запись в YCLIENTS без добавления номера телефона/email контакта. Данная опция необходима для создания событий, по которым планируется вносить контакты позже.

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

Предупреждение

При активировании переключателя "Распределение сделок по категории записи", схема "Распределение по статусу записи" игнорируются системой, т.е. в параллели эти настройки работать не могут!

Распределение сделок по статусу записи

ff770bb4d26c229db49795c784f79353.png

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

3bc55adeda9f8f32f4bf87c33c1138a7.png

В выпадающем списке можно увидеть статусы записи из системы YCLIENTS.

f93d11c0d33d33520488d66b45057b87.png

Для каждого статуса записи YCLIENTS можно настроить соответствующий этап воронки, а также саму воронку, если в Вашем аккаунте их несколько.

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

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

Технические детали

Если для статуса "Ожидание клиента" не настроено соответствие с этапом воронки, то сделки будут создаваться на первом этапе воронки по умолчанию.

Существует возможность выбрать ответственного за сделку менеджера. Это можно сделать как для всех филиалов в целом, так и для каждого отдельного в частности.

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

642e751c89a2a9d9f3ebf99989e8a59e.png

Распределение сделок по категориям записи.

В данном разделе можно настроить распределение сделок по существующим категориям записи YCLIENTS.

d20ea02e2d9729569ecab586d335f94d.png

Категории записи выбираются в карточке записи клиента YCLIENTS.

a0efd7f8003abb03d51a96f78b295e91.png

При выборе соответствующей категории записи YCLIENTS сделка будет переходить на заданный в настройках этап воронки продаж amoCRM.

a97f531ff239bf448601f24571212eb2.png

e8948766335ff26fb4b145422ab5911a.png

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

Технические детали

Стоит отметить, что при отмене записи через окно виджета в карточке сделки запись в YCLIENTS удаляется, соответственно, сделка будет перемещена на этап, указанный в настройках виджета.

При удалении записи из журнала YCLIENTS сделка в amoCRM перемещается на этап, заданный в настройках распределения.

Если этап воронки для удаленных записей не выбран, то сделка по умолчанию будет перемещена на этап "Закрыто и не реализовано" той воронки, где находится сделка.

Распределение сделок между менеджерами

448bfe5fa49d0c23b247b1fcfc4c42f9.png

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

По умолчанию (если никто не выбран) ответственным будет указан пользователь, из-под которого был установлен виджет YCLIENTS в amoCRM.

2806cbe37771436f35f07d99679f54bc.png

Переключатель "Назначать ответственным за сделку менеджера, ответственного за Контакт, если тот уже существует в amoCRM" необходим для того, чтобы отмечать ответственным менеджера за его контакт, если ответственный отсутствует, сделка распределяется согласно очереди.

Если переключатель "Назначать ответственным за сделку менеджера, ответственного за Контакт, если тот уже существует в amoCRM" активен, то все сделки, созданные интеграцией с YCLIENTS будут назначаться на того пользователя (пользователь будет указан ответственным за сделку), из-под которого установлен виджет, т.к. все Контакты в amoCRM создаются от лица пользователя, из-под которого установлен виджет.

89edffa034c4375f593f6459529785da.png

Условия создания сделок

638525a8af2182a5e5e6fad908ec35da.png

Если переключатель "Добавлять новую запись в активную сделку контакта" активен, то при создании записи в YCLIENTS по уже существующему контакту запись будет добавляться примечанием в уже активную сделку amoCRM по этому клиенту, а не отдельной новой сделкой. (Активная сделка - это сделка находящаяся на любом этапе воронки, кроме стандартных этапов "Успешно реализовано", "Закрыто и не реализовано").

764b7185adbcbb46444e81cf41d420f0.png

9e43e3d97bf0b554136d5041ebafa110.png

Технические детали

При этом, при обновлении сделки, значения кастомных (дополнительных) полей YCLIENTS перезапишутся, т.е. старые - сотрутся, новые - добавятся (ID записи, ID документа и др.).

То есть, если для одного клиента в журналеYC существует 2 записи, то в сделке amoCRM будут указаны данные по самой поздней записи, а связь сделки с более ранней записью будет разорвана и все обновления более ранней записи будут игнорироваться.

В случае активного переключателя "Добавлять новую запись в активную сделку контакта", если сделка по какой-то причине не была создана, то обновление соответствующей записи будет игнорироваться.

Если сделка в amoCRM, по каким либо причинам, не связалась с записью YCLIENTS, а переключатель "Добавлять новую запись в активную сделку контакта" активен, существует возможность связать их вручную. Для этого требуется в поле amoCRM "ID записи, YClients" вручную вписать ID филиала, ID записи в формате: филиал-запись:

7576190ff05f3d91c7d576a5548edf3e.png

Если переключатель "Добавлять новую запись в активную сделку контакта" неактивен, то для каждой новой записи в журнале YC будет создана отдельная сделка в amoCRM.

Если переключатель "Не создавать сделку при новой записи" активен, то при создании новых записей в YCLIENTS сделки по ним в amoCRM создаваться не будут. При этом в amoCRM будут передаваться клиенты по новым записям в YCLIENTS в виде контактов.

Дополнительные параметры

de5fd8dab491f9af9453578d68f9f53a.png

Если переключатель "Добавлять в тег название услуги YCLIENTS" активен, то при записи через YCLIENTS в amoCRM в сделку будет добавляться тег с названием услуги, на которую записан клиент. Если в записи указаны несколько услуг, то тег будет добавлен по каждой.

Название группы услуг в тег передаваться не будут.

Синхронизация

При нажатии кнопки "Синхронизировать" и подтверждения все записи и, связанные с ними клиенты, созданные в YCLIENTS, передадутся в amoCRM в виде сделок и контактов, на необходимый этап, заданный в настройках в разделе "Сделки". При синхронизации, создании и обновлении Записей к сделке привязываются Услуги и Товары.

Технические детали

Синхронизация происходит только с главным филиалом в сети.

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

Технические детали

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

Во время синхронизации даже при включенной настройке "Добавлять новую запись в активную сделку контакта" для каждой записи контакта будет создаваться новая сделка в amoCRM.

f59dd9d3a19dbad7d15767bf677b612f.png

Для отслеживания статуса процесса синхронизации требуется повторно кликнуть по кнопке "Синхронизировать", в появившемся окне, в нижней части будет выведено сообщение о текущем статусе (Выполняется; Ошибка) или сообщение с датой и временем последней успешной синхронизации.

f93682d5689375631c58cd913941b919.png

Дополнительные поля

В данном разделе можно настроить кастомные (дополнительные) поля YCLIENTS.

Если в Вашем YCLIENTS отсутствуют дополнительные поля, раздел будет выглядеть таким образом:

bd2e96a64827e2af14c6d0bc47631306.png

О том, как настроить дополнительные поля в личном кабинете YCLIENTS, можно прочитать по ссылке: support.yclients.com/hc/ru/articles/360022887694-%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BB%D1%8F

Технические детали

Интеграция с amoCRM подтягивает кастомные (дополнительные) поля из доп. параметров записи, но не подтягивает из доп. данных клиента.

0d3fcd6ee8be99c7694a04f9bbe6fd6c.png

После того, как вышеуказанные действия будут выполнены, у Вас появятся дополнительные поля YCLIENTS, благодаря которым можно будет передавать дополнительную, необходимую Вам информацию в сделку amoCRM при записи клиента из YCLIENTS.

Описание работы

Запись через amoCRM.

  • Создаем новую сделку в amoCRM;
  • Заполняем в ней имя клиента, его телефон или email, после чего сохраняем ее;

После указанных действий в боковой панели виджетов появится виджет YCLIENTS.

61ab740334bc7d06044c8a8b1ac579dc.png

  • Нажимаем кнопку "Записать" (также можно дописать Email и комментарий);
  • Выбираем филиал (если филиал один, то данный шаг отсутствует);
  • Указываем тип записи (шаг доступен только, если в настройках личного кабинета YCLIENTS выбран смешанный тип записей);
51875cab72b23a78956db208d84337b0.png

  • Выбираем мастера (мастер будет отображаться в виджете только при условии, что у него выставлено расписание в личном кабинете YCLIENTS);
c7ae8d91065012aa1ac118bd8188fabd.png

  • Выбираем услугу (возможен выбор нескольких услуг);
7d3aa835dec7d6b09b4fbd7e55671f5e.png

  • Выбираем дату (в окне виджета отображается не всё расписание сотрудника, а лишь расписание на текущий месяц + 2 следующих месяца, даже если есть расписание на год);
472ecf9bca5b63096d3c516b8442dbdb.png

  • Указываем нужное время записи;
51c9b30ac37da17c331360e1fa84e98f.png

  • Также Вы можете выбрать теги для записи;
2c25ec89106212a66cfe53cd80ad3b9d.png

  • После указанных действий выведется вся информация о записи клиента;
03501d1be82e7e06e7b4ad03571e6ca5.png

  • После нажатия кнопки “Записать” запись появляется в журнале YCLIENTS.

Вы видите уведомление о том, что клиент записан, а также название услуги, сотрудника к которому он записан и дату сеанса. Вы имеете возможность отменить или перенести запись. Информация о созданной записи тут же отобразится в виде сделки, а также в виде примечания:

6b175fb8f200bb36cf4bfdf2a6611a3d.png

Предупреждение

Порядок заполнения информации через окно виджета, на данный момент, менять нельзя. Также, в виджете для записи доступны только онлайн услуги (услуги оффлайн недоступны).

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

Условия заполнения поля "Бюджет" в amoCRM:

При записи через виджет в amoCRM:

  • при создании/редактировании записи бюджет передается в Сделку, при этом, если в сделке уже есть какой-то бюджет, то он не сложится с бюджетом YCLIENTS, а обновится/перезапишется. Будет указана минимальная цена за услугу YCLIENTS;
  • при удалении записи бюджет Сделки обнуляется.

При записи через журнал YCLIENTS:

  • при создании записи в бюджет Сделки передается стоимость всех услуг и товаров. Если в amoCRM есть сделка в активном этапе воронки и в настройках виджета стоит галочка "Добавлять новую запись в активную сделку контакта", то бюджет сделки не обновляется;
  • при изменении записи обновляется бюджет Сделки, если были добавлены/удалены товары/услуги, при условии, что не было оплаты в кассу;
  • при оплате в записи в Сделку передается сумма оплаты;
  • при удалении оплаты, проверяется условие, есть ли оплаты, и если оплат нет, то в бюджет Сделки передается стоимость всех услуг и товаров. Если же оплата есть, то считается сумма всех транзакций и передается в бюджет сделки;
  • при удалении записи бюджет Сделки обнуляется.
Технические детали

  • На данный момент любые изменения сделки amoCRM (кроме изменения этапа/статуса сделки) не передаются в YCLIENTS и не влияют на запись. Изменения записи в YCLIENTS передаются в сделку amoCRM;
  • Любые изменения контакта amoCRM также не передаются в YCLIENTS и не влияют на клиента. Изменения клиента YCLIENTS передаются в контакт amoCRM.

Запись через YCLIENTS

Для того, чтобы записать клиента через сервис YCLIENTS необходимо выбрать дату в левом верхнем углу экрана и затем выбрать время в открывшемся поле записи. Затем - создать запись.

92423269c459cd1c0ed61b5f90d5a088.png

После создания записи создастся сделка в amoCRM.

Далее, специалист салона меняет статус записи в системе YCLIENTS после посещения клиента, и сделка автоматически двигается по воронке в amoCRM на тот этап который указан в настройках:

963e9fb07c44fe4f2e5275352fe662bc.png

Движение сделки по этапам воронки:

b13efb03e4cb303f9c2aceb6b3a6bc46.png

При смене этапа сделки, автоматически меняется статус записи в YC, т.е. интеграция двухсторонняя.

Особенности работы интеграции

  • При создании записи из журнала YC без номера телефона или Email, интеграцией будет создана сделка "Новая запись YClients", при условии, что переключатель "Не создавать сделку при новой записи" деактивирован. Если в amoCRM существует сделка с этим же контактом, то запись из YC не свяжется с этой сделкой;
  • Для создания полей "Сотрудник, YClients" и "Длительность записи, YClients" у действующих клиентов необходим переподключить (переустановить) виджет, чтобы обновления вступили в силу;
  • Интеграция НЕ РАБОТАЕТ с Неразобранным в amoCRM (т.е. в качестве этапа создания сделок в amoCRM нельзя выбрать этап "Неразобранное");

Помогла ли вам статья?