Microsoft Dynamics CRM
Цель интеграции
Данная интеграция позволяет отправлять в Microsoft Dynamics CRM всю имеющуюся в Calltouch информацию о зафиксированных звонках, записывая ее в карточках клиентов. По каждому звонку в Microsoft Dynamics CRM отправляется подробная информация о его источнике, о клиенте, совершившем этот звонок, и более 40 других параметров, о которых речь пойдет в следующем пункте.
Данная интеграция поддерживает все версии Microsoft Dynamics CRM.
Настройка передачи данных в Microsoft Dynamics CRM
Передаваемые параметры в Microsoft Dynamics CRM
Следующие параметры передаются из Calltouch в Microsoft Dynamics CRM:
| Название |
Параметр |
Описание |
В какой момент звонка передается |
| Фаза звонка |
callphase |
Показывает в какой момент звонка по нему был отправлен webhook'. |
В момент начала и завершения звонка |
| ID звонка |
id |
Уникальный идентификатор звонка в Calltouch. |
В момент начала и завершения звонка |
| ID клиента |
ctCallerId |
Уникальный идентификатор клиента в Calltouch. |
В момент начала и завершения звонка |
| Номер клиента |
callerphone |
Телефонный номер клиента, с которого он выполняет звонок. Формат: 7XXXXXXXXXX |
В момент начала и завершения звонка |
| Отслеживаемый номер |
phonenumber |
Отслеживаемый номер, на который звонит клиент. Формат: 7XXXXXXXXXX |
В момент начала и завершения звонка |
| Номер переадресации | redirectNumber |
Номер переадресации, на который переадресовался звонок клиента. Если номер не удалось определить, а так же во всех webhook'ах по началу звонка, передается значаение undefined. |
В момент завершения звонка |
| Длительность разговора |
duration |
Длительность телефонного разговора в секундах. |
В момент завершения звонка |
| Длительность ожидания |
waiting_time |
Длительность ожидания (гудки до поднятия трубки оператором) в секундах. |
В момент завершения звонка |
| Дата и время звонка в формате YYYY-MM-DD hh:mm:ss |
calltime |
Дата и время звонка начала звонка. |
В момент начала и завершения звонка |
| Дата и время звонка в формате Unix Time Stamp |
timestamp |
Дата и время начала звонка в формате Unix Time Stamp в секундах. |
В момент начала и завершения звонка |
| Статус звонка |
status |
Статус звонка. Возможные значения: |
В момент завершения звонка |
| Уникальный звонок или нет |
unique |
Уникальный звонок - это первый звонок клиент со своего номера. |
В момент начала и завершения звонка |
| Целевой звонокили нет |
targetcall |
Целевой звонок - это звонок, длительность которого уложилась в рамки целевого звонка, заданных в системных настройках ЛК, по умолчанию от 30 сек. |
В момент завершения звонка |
| Уникально-целевой звонок или нет |
uniqtargetcall |
Уникально-целевой звонок - это первый звонок от клиента, укладывающийся в рамки целевого звонка. Возможные значения: |
В момент завершения звонка |
| Обратный звонок или нет |
callback |
Обратный звонок - это звонок либо с виджета обратного звонка Calltouch, либо с кастомной формы или кнопки сайта, подключенной к обратному звонку Calltouch. |
В момент начала и завершения звонка |
| В рабочее или нерабочее время поступил звонок |
worktime |
Рабочее или нерабочее время, в которое пришел звонок, устанавливается в настройках прежней версии ЛК. Возможные значения: |
В момент начала и завершения звонка |
| Звонок на статический или динамический номер |
pool |
Показывает за каким типом пула закреплен номер, на который позвонил клиент. |
В момент начала и завершения звонка |
| Рейтинг звонка |
rating |
Рейтинг, присвоенный звонку в журнале звонков ЛК. |
В момент завершения звонка |
| Комментарии ко звонку |
comment |
Комментарии ко звонку, оставленные через плеер журнала звонков во время разговора. |
В момент завершения звонка |
| Теги Calltouch Predict |
tags_auto_pr |
Теги, присвоенные звонку автоматически системой Calltouch Predict. |
В момент завершения звонка |
| Теги Calltouch Антифрод |
tags_auto_af |
Теги, присвоенные звонку автоматически системой Calltouch Антифрод. |
В момент завершения звонка |
| Теги по добавочным |
tags_auto_ct |
Теги, присвоенную звонку автоматически на основе введенных тоновых сигналов (добавочных) клиентом или оператором в ходе разговора. |
В момент завершения звонка |
| Теги по номерам |
tags_auto_pn |
Теги, присвоенную звонку автоматически в зависимости от номеров, на которые или с которых звонят клиенты. |
В момент начала и завершения звонка |
| Вручную проставленные теги |
tags_manual |
Теги, присвоенную звонку во время разговора вручную пользователем в журнале звонков Calltouch. |
В момент завершения звонка |
| Модель атрибуции |
attribution |
Выбранная модель атрибуции в настройках webhook'а, согласно которой будет передаваться источник звонка. |
В момент начала и завершения звонка |
| Источник |
source |
Источник трафика перехода на сайт. |
В момент начала и завершения звонка |
| Канал |
medium |
Канал трафика перехода на сайт. |
В момент начала и завершения звонка |
| Метка utm_source |
utm_source |
Значение utm-метки utm_source. |
В момент начала и завершения звонка |
| Метка utm_medium |
utm_medium |
Значение utm-метки utm_medium. |
В момент начала и завершения звонка |
| Метка utm_campaign |
utm_campaign |
Значение utm-метки utm_campaign. |
В момент начала и завершения звонка |
| Метка utm_content |
utm_content |
Значение utm-метки utm_content. |
В момент начала и завершения звонка |
| Метка utm_term |
utm_term |
Значение utm-метки utm_term. |
В момент начала и завершения звонка |
| Дополнительные отслеживаемые параметры |
add_url_params |
Дополнительный отслеживаемый произвольный параметр в URL, по которому перешли на сайт. |
В момент начала и завершения звонка |
| Google Client ID |
gcid |
Идентификатор Google Client ID. Присутствует при настроенной интеграции с Google Analytics 4. Если интеграция не настроена, или настроена, но Google Client ID не удалось определить, параметр передается с пустым значением. |
В момент начала и завершения звонка |
| Yandex Client ID |
yaClientId |
Идентификатор Yandex Client ID. Присутствует при настроенной интеграции с Яндекс.Метрика на отправку звонков. Если интеграция не настроена, или настроена, но Yandex Client ID не удалось определить, параметр передается с пустым значением. |
В момент начала и завершения звонка |
| ID сессии Calltouch |
sessionId |
Идентификатор сессии Calltouch. |
В момент начала и завершения звонка |
| Отслеживаемый сайт |
hostname |
Отслеживаемый домен или поддомен ресурса, на который был осуществлен переход (например: ok.ru, vk.com, google.com). |
В момент начала и завершения звонка |
| Страница входа на сайт |
url |
URL, по которому попали на сайт (куда перешел посетитель). Фиксируется только страница входа в пределах сессии. Если URL не удалось определить, параметр передается с пустым значением. |
В момент начала и завершения звонка |
| Сторонние cookie | attrs | Название зафиксированной cookie и ее значение, например: "cookie1":"value1","cookie2":"value2". Сторонние cookie могут быть зафиксированы Calltouch по запросу в тех. поддержку. Данный функционал может быть полезен для сквозной аналитики между Calltouch и другими сервисами. | В момент начала и завершения звонка |
| Страница звонка | call_url | URL, находясь на котором, посетитель совершил звонок. | В момент начала и завершения звонка |
| Источник реферального перехода |
ref |
URL источника пользовательского перехода (откуда пришел посетитель). Присутствует только если был выполнен реферальный переход с какой-либо рекламной площадки, иначе передается пустое значение. |
В момент начала и завершения звонка |
| Город |
city |
Город, в котором находится клиент, совершивший звонок. Определение города происходит по IP-адресу клиента, используется гео-база sypexgeo.net. Если город не удалось определить, параметр передается с пустым значением. |
В момент начала и завершения звонка |
| Браузер |
browser |
Наименование и версия браузера, в котором был осуществлен переход. Определяется по User Agent клиента. Если браузер не удалось определить, параметр передается с пустым значением. |
В момент начала и завершения звонка |
| Операционная система |
os |
Наименование и версия операционной системы. Определяется по User Agent клиента. Если ОС не удалось определить, параметр передается с пустым значением. |
В момент начала и завершения звонка |
| Устройство |
device |
Информация об устройстве, с которого клиент перешел на сайт. Определяется по User Agent клиента. Если устройство не удалось определить, параметр передается с пустым значением. |
В момент начала и завершения звонка |
| IP-адрес |
ip |
IP-адрес клиента, совершившего звонок. |
В момент начала и завершения звонка |
| ID сеанса SIP |
sip_call_id |
Уникальный идентификатор сеанса связи с АТС Calltouch. Его значение отправляется на ваше оборудование в случае использования переадресации по SIP trunk. Может быть полезен при интеграции с вашей АТС. | В момент завершения звонка |
| ID звонка с АТС | callReferenceNumber | Технический идентификатор звонка внутри БД Calltouch. Может применяться для отладки каких-либо интеграций между Calltouch и внешними сервисами. | В момент начала и завершения звонка |
| Запись разговора |
reclink |
Ссылка на запись звонка. Присутствует, если в настройках webhook'ов не запрещено скачивание записей разговоров. Содержит ссылку со специальным JWT-токеном, по которой можно будет скачать только ту запись звонка, по которому был отправлен этот webhook. Таким образом, при каждой отправке webhook’а будет генерироваться уникальный JWT-токен. |
В момент завершения звонка |
| ИД сделки | orderId | Идентификатор сделки по звонку, если таковая была создана во время разговора из плеера журнала звонков ЛК либо по API Calltouch. | В момент завершения звонка |
| ИД сайта | siteId | Уникальный идентификатор вашего сайта внутри Calltouch, на котором был зафиксирован звонок. | В момент завершения звонка |
| Название сайта | siteName | Название вашего сайта внутри Calltouch, на котором был зафиксирован звонок. | В момент завершения звонка |
Скачивание модуля интеграции в Личном Кабинете Calltouch
Следующим необходимым шагом для настройки интеграции - это скачивание модуля интеграции. Его можно скачать в окне настройки интеграции в Личном Кабинете Calltouch.
Скриншот места, откуда можно скачать модуль интеграции в Личном Кабинете Calltouch
Установка модуля интеграции в Microsoft Dynamics CRM
1. Запустите файл пакета установщика Calltouch.msi и нажмите "Далее"
2. В открывшемся окне необходимо указать данные для настройки решения.
Решение предполагает установку решения на уже предустановленные компоненты решения "АРК-РИЭЛТОР", и чистую(Базовую) систему Microsoft Dynamics CRM.
Выберите один из предложенных программой установки вариантов:
- 2013(2015) – выберите этот вариант, если у Вас уже установлено решение для систем CRM 2013 – 2015 версии.
- 2016(365) – выберите этот вариант, если у Вас уже установлено решение для систем CRM 2016 – 365 версии.
- Без установки Решения – выберите этот вариант, если Вы используете решение компании ТИСА «АРК-РИЭЛТОР»
Выберите из раскрывающегося списка способ аутентификации:
Выберите один из предложенных программой установки вариантов.
- ActiveDirectory – выберите этот вариант, если вы находитесь в инфраструктуре компании, где используется ActiveDirectory. Необходимо указать учетные данные администратора CRM.
- ActiveDirectory (Вне домена – Логин, Пароль, Домен обязательны) – выберите этот вариант, если находитесь вне сети компании. Необходимо указать учетные данные администратора CRM.
- Online – выберите этот вариант если используете версию 365 и учетные записи Microsoft для входа в систему. Необходимо указать учетные данные администратора CRM.
В поле «Url адрес:» указывается ссылка на систему CRM
Укажите логин и пароль администратора CRM.
Логин следует заполнять с указанием домена.
Пример: TISA\ADMIN
TISA\ = Домен сети
ADMIN = Логин администратора
Укажите свободный порт, на котором будет настроен веб-сервис.
Укажите путь установки программы.
Важно: не указывайте корневую папку системного диска.
Далее, дождитесь окончания процесса установки.
Закройте программу установщика нажатием кнопки «Готово»
В службе IIS (Internet Information Server -Проприетарный набор серверов для нескольких служб Интернета от компании Майкрософт.) появится новое веб приложение (веб сервис): CallTouchWebService
Приложение привязано к тому порту, который был указан при установке.
Проверьте работоспособность сервиса перейдя на него с помощью браузера.
Если служба работает правильно, то появится следующее окно.
Получение адреса модуля и его внесение в настройку интеграции в Личном Кабинете Calltouch
Следующим действием для настройки интеграции будет получение и внесение адреса модуля в Личном Кабинете Calltouch.
Адрес модуля можно получить у системного администратора вашей CRM. Данное поле может содержать любые символы, максимум 256 символов.
Выбор модели атрибуции
Вам доступно на выбор две модели атрибуции: последний непрямой и последнее взаимодействие.
Последнее взаимодействие означает, что в Microsoft Dynamics CRM будут переданы звонки, которым присвоится источник последнего взаимодействия с вашим сайтом. Последний непрямой похож на модель атрибуции Последнее взаимодействие, но он игнорирует прямой переход в конце цепочке касаний.
Включение передачи звонков
Последним действием будет включение передачи звонков, которое делается простым нажатием на переключатель в окне настройки интеграции.
На этом все: интеграция настроена и включена, а данные по звонкам передаются в карточки клиентов в Microsoft Dynamics CRM.
Пример отображения звонка в интерфейсе Microsoft Dynamics CRM
После полноценной настройки интеграции, информация из Calltouch начнет передаваться в Microsoft Dynamics CRM. Ниже представлены примеры того, как это будет выглядеть.
Данные по звонку
Новая заявка по звонку
Создание и обновление сделок в Calltouch
Перед началом настройки, вам необходимо скачать и установить расширение для вашей CRM.
TisaCallTouch_2018_04_04_target_CRM_6.0_managed.zip — для CRM 2013(2015);
TisaCallTouch_2018_04_04_target_CRM_8.0_managed.zip — для CRM 2016(365).
Установка решения
Выберите файл решения, который был скачан ранее для загрузки в CRM.
Выберите пункт «Заменить настройки» и нажмите кнопку «Импорт»:
Дождитесь завершения импорта и нажмите кнопку «Закрыть»:
Применение настраиваемого шага в бизнес-процессе
Создание сделки в Calltouch
Имейте в виду, что события создания сделки в CRM определяется Вами.
1. В бизнес-процессе выберите, появившийся после установки решения, шаг бизнес-процесса «Создание или обновление сделки в CallTouch»
2. Заполните все необходимые параметры в настраиваемом шаге бизнес-процесса
Обновление сделки в Calltouch
Имейте в виду, что события создания сделки в CRM определяется Вами.
1. В бизнес-процессе выберите, появившийся после установки решения, шаг бизнес-процесса «Создание или обновление сделки в CallTouch»
2. Заполните все необходимые параметры в настраиваемом шаге бизнес процесса
Ссылка на документацию по созданию и управлению сделками через API — https://www.calltouch.ru/support/api-metod-vygruzki-zhurnala-sdelok/
Результат выполнения настраиваемого шага бизнес процесса CRM
На выходе настраиваемого шага бизнес процесса получаем:
- «Выполнено успешно» - Признак успешности выполнения создания или обновления сделки в CallTouch.
- «Описание ошибки» - Ошибка, возвращаемая API CallTouch.
- «Результат» - Возвращаемые данные API CallTouch, в случае успешного создания или обновления сделки.
- A/B тестирование (раздел «Подключение»)
- Email-трекинг (раздел «Подключение»)
- Отслеживание офлайн конверсии (раздел «Подключение»)
- Подключение к отслеживанию дополнительных доменов (раздел «Подключение»)
- Подмена номеров на AMP-страницах Google (раздел «Подключение»)
