YCLIENTS: интеграция в новом ЛК UIS

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

Телефония:

• всплывающие уведомления о входящих звонках;
• создание контакта при первичном обращении;
• исходящие звонки по клику из YCLIENTS;
• сохранение истории и записей звонков в YCLIENTS.

Текстовые коммуникации:

• встроенное рабочее место оператора (РМО) для переписки в онлайн-чате, мессенджерах и соцсетях: Telegram, WhatsApp, VK Groups, Авито, Авто.ру;
• автоматическое создание контактов при поступлении чатов и заявок.

Данные о заявках из онлайн-виджета YCLIENTS, которые передаются в отчеты UIS для аналитики рекламы:

• имя, телефон, e-mail;
• дата и время создания;
• данные сессии: рекламная кампания, источник, UTM-метки;
• в случае отсутствия сессии — дефолтная рекламная кампания или источник.

Данные о сделках, которые передаются в отчеты UIS для аналитики рекламы:

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

В старом Личном кабинете UIS откройте раздел Администратор → Аккаунт → Тариф и опции, разверните все опции:

Подключите необходимые опции:

• Базовые отраслевые решения — нужна для базовой работы интеграции: назначение ответственных, создание сущностей в YCLIENTS при входящих обращениях, звонки по клику из YCLIENTS;
• ОМНИ Чаты — если нужна работа с чатами и заявками;
• CU Сквозная Аналитика — если нужно передавать данные о сделках из YCLIENTS в отчеты UIS;
• Загрузка офлайн-заявок из внешней системы — передача заявок с онлайн-виджета.

Вернитесь в новый Личный кабинет, раздел Интеграции → CRM и подключите YCLIENTS:

Заполните учетные данные:

• Название: произвольное, понятное, чтобы ни с чем не перепутать;
• Login: логин аккаунта в YCLIENTS;
• Password: пароль от аккаунта в YCLIENTS.

В YCLIENTS откройте раздел Сеть ⟶ Телефония ⟶ Интеграция и скопируйте значение из поля «Токен»:

В Личном кабинете UIS откройте раздел Интеграции ⟶ CRM ⟶ YCLIENTS, нажмите нижнюю кнопку «Подключить учетную запись» и вставьте скопированный токен из YCLIENTS в поле Токен телефонии:

Настройте логику работы со звонками:

• Сеть: название сети, с которой подключаете интеграцию. С каждой сетью интеграция подключается отдельно, так как User token в YCLIENTS формируется индивидуально под каждую сеть.
• Внешние номера филиалов: укажите соотношение виртуальных номеров с филиалами выбранной сети.
• Филиал по умолчанию: укажите филиал, в который будут попадать звонки с номеров, не выбранных в настройке выше.
• Условия фильтрации: если не настроить фильтр, в YCLIENTS будут попадать все входящие звонки на ваши номера UIS. YCLIENTS не отличает звонки клиентов от звонков в бухгалтерию, поэтому при поступлении любых звонков будет создавать заказы и контрагентов. Чтобы не засорять CRM, настройте фильтр по сайту, источникам, сценариям или типам.
• Создавать клиента: при поступлении звонка в YCLIENTS будет автоматически создан клиент.

После сохранения настроек в Личном кабинете YCLIENTS появятся дополнительные разделы в блоке Сеть ⟶ Телефония: Маршрутизация, Маршруты и Звонки, а статус интеграции изменится на Интеграция подключена.

Откройте раздел Маршруты:

Настройка маршрута по умолчанию — сохранять историю звонков по маршруту в Истории сети:

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

• История звонков сети и всех салонов: всплывающая карточка контакта будет появляться во всех филиалах сети, звонок будет виден во всех филиалах в разделе Обзор ⟶ Звонки.
• История звонков сети и уведомленных салонов: всплывающая карточка контакта будет появляться в тех филиалах, которые выбраны в этом маршруте.

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

Для проверки работы интеграции сделайте тестовый звонок и посмотрите, отобразился ли он в отчете Звонки в YCLIENTS:

Если нет, проверьте, совпадают ли номера телефонов в настройках маршрутизации YCLIENTS и Личном кабинете UIS.

Добавьте учетные данные сети: название авторизации, логин и пароль от YCLIENTS.

Передача заявок

Включите передачу заявок и настройте логику обработки данных в YCLIENTS:

• Соотношение филиалов: задайте соответствие сайтов с вашими филиалами.
• Филиал по умолчанию: выберите филиал для сайтов, не выбранных в настройке выше.
• Условия фильтрации: если не настроить фильтр, в YCLIENTS будут попадать все заявки, которые оставили через виджеты UIS на ваших сайтах. Чтобы не засорять CRM, настройте фильтр по сайтам и/или типам заявок.
• Создавать клиента: при поступлении заявки в YCLIENTS будет автоматически создан клиент.

Передача чатов

Включите передачу чатов и настройте логику обработки данных в YCLIENTS:

• Соотношение филиалов: задайте соответствие сайтов с вашими филиалами.
• Филиал по умолчанию: выберите филиал для сайтов, не выбранных в настройке выше.
• Условия фильтрации: если не настроить фильтр, в YCLIENTS будут попадать все чаты. Чтобы не засорять CRM, настройте фильтр.
• Создавать клиента: при поступлении чата в YCLIENTS будет автоматически создан клиент. Выберите, когда именно нужно создавать клиента: при поступлении чата, при завершении или после простановки тега. При выборе простановки тега выводится список тегов: их можно использовать для разных целей — например, для квалификации обращений на целевые и нецелевые, чтобы в CRM попадали только квалифицированные лиды.

Активируйте интеграцию и нажмите Сохранить.

Чтобы передавать в Личный кабинет UIS данные о заявках, оформленных через виджет онлайн-записи YCLIENTS, нужно:

• создать приложение и настроить вебхук в YCLIENTS;
• включить настройку YCLIENTS: передача заявок с Онлайн-виджета в Личном кабинете UIS;
• установить скрипты на сайт (понадобится доступ к админке сайта).

Отправка вебхука настраивается в YCLIENTS через создание собственного приложения по инструкции.

После создания и подключения приложения откройте Личный кабинет UIS, включите настройку YCLIENTS: передача заявок с Онлайн-виджета и скопируйте значение из поля Webhook URL:

В YCLIENTS откройте раздел Настройки ⟶ Системные настройки ⟶ WebHook и вставьте скопированное значение в поле Адрес, на который отправлять уведомления. В разделе Отправлять события по сущностям выберите Событие по записям и Событие по клиентам:

Перейдите в Личный кабинет UIS и скопируйте скрипт из поля Скрипт для вашего сайта:

Установите скрипт на всех страницах сайта, где расположен виджет YCLIENTS, а так же требуется добавить наш скрипт и стандартный код вставки в саму форму в YCLIENTS (инъекция скрипта).

Если вы добавляете на сайт не виджет YCLIENTS (кнопку), а отдельную ссылку на лендинг, то в этой ссылке необходимо добавить: class="yclick".

Пример:

где "https://n822081.yclients.com/" — это домен страницы, на которой установлен виджет.

Настройте логику передачи заявок:

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

Нажмите Сохранить.

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

Чтобы передавать в Личный кабинет UIS данные о сделках из YCLIENTS, нужно:

• включить настройку YCLIENTS: передача заявок с Онлайн-виджета в Личном кабинете UIS;
• создать приложение и настроить вебхук в YCLIENTS.

В Личном кабинете UIS включите передачу сделок:

• Название: произвольное, понятное, чтобы ни с чем не перепутать;
• Login: логин аккаунта в YCLIENTS;
• Password: пароль от аккаунта в YCLIENTS.

Отправка вебхука настраивается в YCLIENTS через создание собственного приложения по инструкции.

После создания и подключения приложения вернитесь к настройкам интеграции в ЛК UIS и скопируйте значение из поля Webhook URL.

В YCLIENTS откройте раздел Настройки ⟶ Системные настройки ⟶ WebHook и вставьте скопированное значение в поле Адрес, на который отправлять уведомления. В разделе Отправлять события по сущностям выберите Событие по записям и Событие по клиентам:

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