# Интеграция с YCLIENTS для amoCRM

Интеграция позволяет обмениваться и редактировать информацию о записях прямо из amoCRM.

---

# Установка интеграции и подключение

# Шаг 1. Подключение филиала в YCLIENTS

После активации виджета в amoCRM перейдите в YCLIENTS и откройте раздел «Интеграции». Введите в поиске «Интеграция с amoCRM» и перейдите к появившейся в списке интеграции.

На странице интеграции с amoCRM нажмите на кнопку «Подключить».

В открывшемся окне выберите филиалы для подключения, нажмите «Далее», а после нажмите «Продолжить» для предоставлению доступа интеграции к филиалу.

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

# Шаг 2. Подключение филиала в amoCRM

Перейдите в раздел amoМаркет → Установленные → YCLIENTS: запись, визиты, оплаты → Настройки. Нажмите кнопку «Сохраните».

Перейдите в раздел Настройки → YCLIENTS → Пользователи. Введите логин и пароль сотрудника Altegio с максимальными правами доступа во всех подключаемых филиалах. Как правило, это сотрудник с правами владельца, который создавал филиалы. После этого нажмите «Подключить».

Перейдите в раздел Филиалы. Нажмите «Добавить филиал» и выберите филиал в появившемся списке.

Нажмите «Проверить подключение» и включите филиал. Интеграция работает только во включенных филиалах. Включить можно ограниченное количество филиалов, которое указано выше в «доступно»

Активное подключение филиала отображается следующим образом:

---

# Настройка полей

После подключения филиалов перейдите к настройке соответствия полей amoCRM с данными из YCLIENTS. Вы можете использовать созданные вами поля или же создать новые прямо через настройки интеграции с помощью кнопки «Создать поле» напротив нужного параметра.

# Системные поля

Для начала настройте обязательные поля для передачи ID записи, ID компании (филиала) и ID клиента. Поля для ID записи и ID компании должны быть настроены в карточке сделки, поле для ID клиента - в карточке контакта.

# Данные по записи

Далее настройте поля для передачи необходимых вам данных по записи в карточку сделки.

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

Также вы можете настроить связку дополнительных полей записи YCLIENTS с полями сделки amoCRM. Для этого в пункте Связка полей YCLIENTS с полями amoCRM нажмите «Настроить связку», в открывшемся окне выберите филиал, нажмите «Добавить связку» и настройте соответствие.

При настройке полей учтите ограничения amoCRM:

• Для текстовых полей длина значения составляет не более 256 символов;
• Ограничение на количество символов в значении полей типов «Список» и «Мультисписок» составляет 256 символов. Если символов больше, услуга может не передаться в значение поля.

# Данные по продажам товаров

Дополнительно вы можете настроить поля сделки для передачи данных по продаже товаров, если в разделе «Автоматизация» → «Логика обработки данных из YCLIENTS» включена функция «Создавать сделки при продаже товаров».

# Данные клиента

После этого настройте поля для передачи необходимых вам данных по клиенту в карточку контакта.

Вы можете включить функцию «Обновлять название контакта». В таком случае имя контакта в amoCRM будет обновляться согласно данным клиента, указанным в YCLIENTS.

Дополнительно есть возможность передавать имя и фамилию в одно поле. Если в YCLIENTS активно только поле «Имя», то данную функцию необходимо включить. Если в YCLIENTS используются отдельные поля «Имя» и «Фамилия», то функция должна быть выключена для корректного обновления имени клиента.

Помимо этого, вы можете настроить формат номера телефона контакта: +7, 7, 8 или свой формат, например, с кодом страны. При создании/обновлении контакта в amoCRM формат номера телефона клиента будет автоматически меняться на установленный в настройках.

Также вы можете настроить связку дополнительных полей клиента YCLIENTS с полями контакта amoCRM. Для этого в пункте Связка полей YCLIENTS с полями amoCRM нажмите «Настроить связку», в открывшемся окне выберите филиал, нажмите «Добавить связку» и настройте соответствие аналогично настройке дополнительных полей записи, описанных в предыдущем пункте Данные по записи.

# Данные по абонементу

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

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

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

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

---

# Настройки пользователей

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

После выберите доступ к YCLIENTS: использование главного аккаунта, использование аккаунта другого пользователя или подключение аккаунта.

При выборе «Подключить аккаунт» укажите логин и пароль сотрудника YCLIENTS, после чего нажмите кнопку «Подключить».

Далее в пункте «Доступные филиалы для оформления записи» выберите филиалы, которые будут доступен пользователю в amoCRM.

Если подключен один филиал, то вы можете указать его в качестве филиала по умолчанию в соответствующем пункте. После этого в виджете достаточно будет выбрать тип графика, выбор филиала будет выбран автоматически.

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

---

# Автоматизация

Раздел позволяет задать поведение интеграции — от синхронизации статусов до логики задач и дублей.

# Синхронизация статусов

Для начала выберите способ синхронизации статусов:

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

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

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

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

В выборе условий доступны: «Категория услуг», «Воронка», «Сотрудник», «Филиал» и «Категория записи», «Количество визитов» (в филиале).

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

# Работа виджета в amoCRM

В данном блоке настраивается работа с интеграцией из amoCRM. Вам доступны следующие функции:

• Ставить задачу по созданию записи — при создании записи как из amoCRM, так и из YCLIENTS на дату и время назначенного визита установится задача;
• Добавить журнал записи в разделе Сделки — при открытии раздела «Сделки» в выбранных Вами воронках добавится кнопка «Журнал записи» (слева от кнопки «Новая сделка»), с помощью которой вы сможете оформить запись, не заходя в карточку сделки;
• Отображать кнопку «Перейти в сделку» в журнале записи — при открытии журнала записи вы сможете перейти в сделке, к которой прикреплена запись;
• Скрывать окно записи в сделке на этапах — в сделках, находящихся на выбранных этапах, будет скрыто окно записи, поэтому создать или отредактировать уже имеющуюся запись не получится в таких сделках;
• Создавать на другом этапе при создании из amoCRM — при создании записи через amoCRM сделка будет создана на выбранном этапе воронки, в дальнейшем перемещение сделки по этапам будет соответствовать настроенной синхронизации статусов;
• Сделать обязательным выбор услуги при создании записи в YCLIENTS — выбор услуг становится обязательным при создании записи из amoCRM;
• Перезаписывать записи в сделке — при создании новой записи из сделки она перезаписывает более раннюю запись из этой сделки, а не создает новую сделку;
• Запретить менять данные контакта в amoCRM при создании записи из сделки — при создании записи из сделки нельзя менять данные в amoCRM в полях, связанных с контактом в amoCRM (ФИО и контактные данные);
• Отображать и делать доступными для записи услуги, которые не оказывает сотрудник — в окне редактирования записи будет доступен полный список услуг. Запись будет успешно создаваться с услугами, которые выбранный сотрудник не оказывает.

# Логика обработки данных из YCLIENTS

В данном блоке настраивается логика передачи данных из YCLIENTS в amoCRM. Вам доступны следующие функции:

• Не обновлять статус сделки, если она находится на выбранных этапах — при создании или изменении записи в YCLIENTS сделка, находящаяся на выбранных этапах, обновится без перемещения на этап согласно синхронизации статусов;
• Не создавать сделку при создании записи — при создании записи через YCLIENTS данные по ней не будут переданы в amoCRM, то есть сделка не будет создана;
• Не создавать сделку, если в записи нет клиента — при создании записи не будет создана сделка, если в записи нет клиента;
• Назначать ответственного по созданию записи в amoCRM — ответственным за сделку будет указанный пользователь, создатель или исполнитель записи (подробнее функционал описан в инструкции Настройки ответственного);
• Объединять все записи за один день в одну сделку — при создании нескольких записей для клиента на один день будет создана только одна сделка, данные в полях сделки будут указаны по самой ранней записи в этот день;
• Откреплять старый контакт от сделки при смене клиента — если к сделке прикреплено более одного контакта, то при создании и/или изменении записи контакты, не относящиеся к записи, будут откреплены;
• При создании записи в YCLIENTS искать дубли среди сделок — необходимо выбрать этапы для поиска дублей, какую сделку выбирать для обновления и при необходимости три дополнительных параметра (подробнее функционал описан в инструкции Поиска дублей);
• Не изменять название сделки при обновлении — в сделках, которые будут обновлены, не изменится название;
• Считать сделку имеющую ID записи подходящей к обновлению — если в результате проверки на дубли виджет найдет в выбранных этапах сделку, у которой уже заполнен ID записи (то есть данная сделка уже связана с другой записью), то данная сделка будет обновлена;
• Какую сделку выбирать для обновления — приоритет выбора сделки для объединения;
• Создавать сделки при продаже товаров — при продаже товара в YCLIENTS будет создана сделка в amoCRM.

---

# 🆘 Поддержка

Если у вас возникнут вопросы, обратитесь в техническую поддержку Rubikon.

Наши специалисты помогут с установкой, настройкой и тестированием интеграции с YCLIENTS.