Планфикс: интеграция в новом ЛК UIS

Функциональность интеграции: решение включает работу со звонками и чатами в окне Planfix CRM и передачу данных о сделках из Planfix CRM в отчеты UIS для аналитики рекламы.

Телефония:

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

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

• встроенное рабочее место оператора (РМО) для переписки в онлайн-чате, мессенджерах и соцсетях;
• автоматическое создание контактов и задач при поступлении чатов и заявок;
• передача дополнительных полей в контакты и/или задачи.

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

• сумма и статус сделки.

Далее в ЛК UIS откройте раздел «Интеграции», введите в поисковой строке «Planfix» и кликните на интеграцию

После создания робота для запросов вернитесь в ЛК UIS, нажмите «Добавить учетные данные» и заполните поля в поле «Авторизация REST API»:

• Название: произвольное, понятное вам;
• URL: берется из Planfix CRM по пути «Управление аккаунтом → Доступ к API → REST API → Адрес для API запросов»;
• Bearer token: берется из Planfix CRM по тому же пути «Управление аккаунтом → Доступ к API → REST API → Создать новый токен → Токен авторизации»

Из-за особенностей работы CRM для корректной настройки и работы телефонии нужна еще одна авторизация. Для этого необходимо в ЛК UIS кликнуть на «Авторизация для телефонии» → «Добавить учетные данные» и ввести:

• Название: произвольное, понятное вам;
• URL: берется из Planfix CRM по пути «Управление аккаунтом → Интеграции → Виртуальные АТС → найти и установить приложение «Api ПланФикса для телефоний»;
• Token: берется из Planfix CRM по тому же пути «Управление аккаунтом → Интеграции → Виртуальные АТС → приложение «Api ПланФикса для телефоний» → Ключ авторизации (token) ПланФикса;

Синхронизация — это импорт сотрудников из Planfix CRM в UIS.

Выберите отдельно тех, кто будет работать с обращениями (доступен поиск по ФИО), и нажмите «Синхронизировать», либо воспользуйтесь чекбоксом «Синхронизировать всех сотрудников»:

Не забудьте нажать на кнопку «Синхронизировать». Так же в этом разделе отображается статус, дата и время последней синхронизации сотрудников.

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

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

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

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

• Виртуальный номер
• Сценарии
• Сайты
• Источники
• Рекламные кампании

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

«Звонки по клику из CRM»: данный функционал позволяет звонить прямо из карточки Planfix CRM.

Для корректной работы функционала необходимо скопировать Webhook URL и указать его по пути «Управление аккаунтом → Интеграции → Виртуальные АТС → приложение «Api ПланФикса для телефоний» → Адрес АТС

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

Ниже в настройках выберите:

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

«Входящие звонки»: гибкая настройка создания сущностей в CRM по первичным и повторным обращениям, выберите, какие сущности создавать по каждому типу обращений (клиента автоматически всегда создает Planfix), а так же ответственных сотрудников. Укажите необходимый объект, по которому будет создаваться задача по обращению (подробнее про сущность «Объекты» в Planfix CRM можно почитать в инструкции)

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

Нюанс передачи звонков: если в звонке участвовали несинхронизированные сотрудники, ответственного за такой звонок проставляем сотрудника из настройки «Ответственный по умолчанию».

«Исходящие звонки»: гибкая настройка создания сущностей в CRM по первичным и повторным обращениям, выберите какие сущности создавать по каждому типу обращений (клиента/клиента и заказ), а так же ответственных сотрудников.

Укажите необходимый объект, по которому будет создаваться задача по обращению (подробнее про сущность «Объекты» в Planfix CRM можно почитать в инструкции).

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

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

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

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

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

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

Укажите ответственного сотрудника по умолчанию по входящим и исходящим звонкам

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

Вкладка «Дополнительные поля»

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

Сопоставьте дополнительные поля из Planfix CRM с параметрами, которые будет передавать UIS. Если нужно передавать значение в поля не только при первичных звонках (при создании контакта), но и при повторных, выберите настройку «Обновлять всегда».

Дополнительные поля берем из Planfix CRM, настроить их можно по следующему пути: Управление аккаунтом → Настраиваемые поля → Поля задач/Поля контактов.

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

Далее разберем каждый пункт подробнее.

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

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

• Сайт
• Рекламная кампания
• Источник
• Тип заявки

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

Если чекбокс «Фильтровать заявки» включен, но фильтр не настроен, то будут передаваться все заявки.

Ниже гибкая настройка создания сущностей в CRM по первичным и повторным заявкам, выберите какие сущности создавать по каждому типу обращений (контакт/контакт и задачу/ничего не создавать), а так же ответственных сотрудников.

Укажите необходимый объект, по которому будет создаваться контакт и/или задача по обращению (подробнее про сущность «Объекты» в Planfix CRM можно почитать в инструкции).

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

• Сайт
• Канал
• Тег
• Рекламная кампания
• Источник

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

Для первичных и повторных заявок можно создавать контакт и/или задачу, а так же выбирать ответственных исходя из бизнес-процессов вашей компании. Дополнительно укажите, в какой момент необходимо создавать сущность в CRM: на начало чата, на конец чата, при проставлении тега. Если выбрать «при проставлении тега», то отобразиться дополнительная настройка со списком тегов клиента, в котором необходимо выбрать нужный вам тег.

Включите чекбокс «Передавать чаты без контактных данных», если необходимо передаваться чаты от посетителей, у которых отсутствует номер телефона. При каждом новом чате с посетителем без контактных данных будет создаваться новый контакт и задача, что может привести к дублям в Planfix CRM.

Укажите необходимый объект, по которому будет создаваться контакт и/или задача по обращению (подробнее про сущность «Объекты» в Planfix CRM можно почитать в инструкции).

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

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

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

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

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

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

Гибкая настройка ответственных по заявкам и чатам: задайте ответственного по умолчанию, а так же по необходимости укажите ответственного сотрудника, используя дополнительные фильтры (например, можно настроить отдельного ответственного сотрудника для конкретного сайта)

Вкладка «Дополнительные поля»

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

Сопоставьте дополнительные поля из Planfix CRM с параметрами, которые будет передавать UIS. Если нужно передавать значение в поля не только при первичных обращениях (при создании Контакта), но и при повторных, выберите настройку «Обновлять всегда»

Передача сделок

При активации данной настройки мы будем подтягивать сделки из Planfix CRM в UIS в реал-тайме.

Для корректной работы функционала часть настроек необходимо произвести на стороне Planfix CRM. Для этого необходимо перейти в Planfix CRM в «Управление аккаунтом → Объекты → выбрать нужный объект, который вы считаете за сущность „Сделка“ и кликнуть на него → Автоматические сценарии → Новый сценарий»

В открывшемся окне необходимо задать название сценария, далее в пункте «Событие, при котором будет запущен сценарий» очень важно указать корректное событие, а именно: «Задача создана и соответсвует условиям». Ниже в п.4 настройки под названием «Выполнить следующие операции» выбираем «Послать HTTP-запрос», метод — POST, в URL указываем адрес, который берется из настроек интеграции в UIS в разделе «Передача сделок»

далее Тип — application/json, в пункте «Содержание запроса» в «Параметре» необходимо указать task_id, а в «Значение» — {{Задача.Номер}}, после чего не забудьте сохранить изменения!

После сохранения сценария нужно создать еще один, но уже с другим типом события. Для этого вернитесь в раздел «Автоматические сценарии» в Planfix CRM и создайте новый сценарий. У него должны быть следующие настройки:

• Название сценария
• Событие, при котором будет запущен сценарий — выберите «Задача изменена, но все еще соответствует условиям»
• Ниже в п.4 настройки под названием «Выполнить следующие операции» выбираем «Послать HTTP-запрос», метод — POST, в URL указываем адрес, который берется из настроек интеграции в UIS в разделе «Передача сделок»

• далее Тип — application/json, в пункте «Содержание запроса» в «Параметре» необходимо указать task_id, а в «Значение» — {{Задача.Номер}}
• не забудьте сохранить изменения!

Итого у вас должно получиться 2 сценария, в которых будет отличаться пункт «Событие, при котором будет запущен сценарий». Далее вернемся в личный кабинет UIS и завершим настройки передачи сделок:

в пункте «Выберите объект задачи» укажите тот же объект, для которого настраивались автоматические сценарии в Planfix CRM (в нашем примере на скринах выше это был объект «Доставка», поэтому здесь, в ЛК UIS, мы выбираем тот же объект «Доставка»), далее укажите, какой этап задачи считать успешным и провальным, а так же из какого поля забирать сумму сделки (поле обязательно должно быть числовое!)

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