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

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

Телефония:

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

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

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

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

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

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

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

Далее откройте раздел Интеграции → CRM и подключите YCLIENTS:

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

• авторизация для телефонии;
• авторизация REST API.

Разберем подробнее каждый из них.

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

Вернитесь в раздел настроек интеграции с YCLIENTS. Заполните поле с названием (можно указать любое понятное наименование) и внесите скопированный токен в поле Yclients CRM Token:

Авторизация REST API — заполните учетные данные:

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

Чтобы убедиться, что все настроено корректно, кликните на «Проверить соединение с аккаунтом CRM». В случае успеха вы увидите уведомление о том, что синхронизация прошла успешно. Если будет отображаться ошибка — убедитесь, что авторизационные данные (логин и пароль от аккаунта в YCLIENTS, а так же токен телефонии) введены корректно.

При включении интеграции с телефонией доступы следующие разделы настроек: Основное и Шаблоны.

Разберем подробнее каждый из них.

Вкладка «Основное»

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

В разделе Обработка звонков кликните на Создавать клиента при первичном входящем звонке, если необходимо автоматически создавать клиента при поступлении входящего первичного звонка.

Фильтровать звонки — данная настройка необходима для фильтрации передаваемых в CRM звонков по определенным условиям. При включении настройки станет доступно для выбора две поднастройки: «Фильтр входящих» и «Фильтр исходящих» звонков. Для каждой из них доступен одинаковый набор параметров для фильтрации:

• виртуальный номер;
• сценарии;
• сайты;
• источники;
• рекламные кампании.

Условия можно прописывать через операторы И/ИЛИ. Если фильтр настроен, то он будет помечен зеленой точкой в верхнем правом углу. Если клиент нажал на чекбокс «Фильтровать звонки», но не выбрал никакую настройку в выпадающем списке — передаем все звонки.

Основной филиал — выберите филиал по умолчанию, в который будут попадать все звонки, не попавшие под условия ниже.

Филиалы — укажите соотношение виртуальных номеров с филиалами выбранной сети

Вкладка «Шаблоны»

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

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

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

Если потребуется вернуться к исходному варианту шаблона — просто воспользуйтесь кнопкой сброса к значению по умолчанию.

Не забудьте сохранить настройки телефонии!

Дополнительные настройки в YCLIENTS

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

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

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

• история звонков сети и всех салонов — всплывающее окно о звонке будет появляться во всех филиалах сети, звонок будет виден во всех филиалах в разделе Обзор — Звонки;
• история звонков сети и уведомленных салонов — всплывающее окно о звонке будет появляться в том филиале/филиалах, которые будут выбраны в этом маршруте

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

Укажите номера телефонов своей компании без плюса, скобок, дефисов, пробелов и других символов и сохраните.

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

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

При включении интеграции с текстовыми коммуникациями доступы следующие разделы настроек: Основное и Шаблоны.

Разберем подробнее каждый из них.

Вкладка «Основное»

Заявки — включите настройку «Создавать клиента при первичном обращении», если требуется создавать клиента при первом обращении. В остальных случаях заявка добавляется комментарием. В YCLIENTS нет уведомлений о новых комментариях — настройте уведомления на почту (через сторонние сервисы) или обрабатывайте заявки в РМО при использовании UIS.

Фильтры — данная настройка необходима для фильтрации заявок по определенным условиям. При включении настройки станет возможно фильтровать обращения по следующим параметрам:

• сайт;
• рекламная кампания;
• источник;
• тип заявки.

Условия можно прописывать через операторы И/ИЛИ. Если фильтр настроен, то он будет помечен зеленой точкой в верхнем правом углу.

Чаты — включите настройку «Создавать клиента при первичном обращении», если требуется создавать клиента при первом обращении. При ее выборе выводится дополнительная настройка вариантов создания клиента по чату:

• на начало чата;
• на завершение чата;
• при простановке тега.

При выборе простановки тега выводится список тегов: их можно использовать для разных целей — например, для квалификации обращений на целевые и нецелевые, чтобы в CRM попадали только квалифицированные лиды.

Фильтры — данная настройка необходима для фильтрации чатов по определенным условиям. При включении настройки станет возможно фильтровать обращения по следующим параметрам:

• сайт;
• рекламная кампания;
• источник;
• канал;
• тег.

Условия можно прописывать через операторы И/ИЛИ. Если фильтр настроен, то он будет помечен зеленой точкой в верхнем правом углу.

Филиал по умолчанию — выберите основной филиал, в который будут попадать все чаты и заявки, не попавшие под условия ниже.

Филиалы — укажите соотношение сайтов (для заявок) и каналов чата (для чатов) с филиалами выбранной сети.

Вкладка «Шаблоны»

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

С помощью кнопки «+» вы можете добавлять в шаблон динамические параметры обращения — например, название сайта, источник, канал и другие данные.

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

Если потребуется вернуться к исходному варианту шаблона — просто воспользуйтесь кнопкой сброса к значению по умолчанию.

Не забудьте сохранить настройки!

Установка расширения:

• Переходим по ссылке и устанавливаем расширение в магазине Chrome;
• Нажимаем кнопку «Войти» и логинимся под сотрудником UIS, который будет принимать чаты и звонки.

После успешного входа в расширение, открывается совершенно простое меню: кнопка «Показать софтфон» (открывает окно софтфона) и «Показать чаты» (открывает окно чатов).

Чаты

Вызвать окно с чатами можно несколькими способами:

• кликнув на кнопку Чаты UIS в боковой панели YCLIENTS, вызовется общее окно РМО, в котором можно посмотреть все доступные чаты, а также написать новому клиенту;
• включив свитч в расширении UIS.

Звонки

Как было сказано ранее, софтфон можно отображать всегда, активировав свитч «показать софтфон» в настройках расширения, а также Софтфон автоматически покажется:

• при входящем звонке;
• при звонке по клику (например, из карточки клиента в разделе «Основные данные».

В чем преимущества использования нашего расширения:

Расширение позволяет использовать все дополнительные инструменты нашего РМО, такие как:

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

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

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

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

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

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

Обязательно сохраните настройки в кабинете UIS, так как в противном случае скрипт для сайта (дальнейший шаг настройки) не будет отображаться в ЛК!

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

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

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

Пример:

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

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

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

Для корректного определения сессии, добавьте доп. поле «comagic_id» во всех филиалах, по которым есть форма онлайн записи, для этого выбираем Сеть , Настройки → Дополнительные поля → Доп. параметры записи.

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

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

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

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

Если вы уже добавляли учетные данные YCLIENTS, выберите их из списка, если нет — нажмите верхнюю кнопку «Авторизация REST API» и заполните поля в форме «Добавление учетных данных»:

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

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

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

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

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

На этом настройка интеграции завершена!