Наверх
Подписаться

Настройка интеграции с Microsoft Dynamics CRM

Содержание

  1. Цель интеграции
  2. Передаваемые параметры в Microsoft Dynamics CRM
  3. Скачивание модуля интеграции в Личном Кабинете Calltouch
  4. Установка модуля интеграции в Microsoft Dynamics CRM
  5. Получение адреса модуля и его внесение в настройку интеграции в Личном Кабинете Calltouch
  6. Выбор модели атрибуции
  7. Включение передачи звонков
  8. Пример отображения звонка в интерфейсе Microsoft Dynamics CRM

 

1. Цель интеграции

 

Данная интеграция позволяет отправлять в Microsoft Dynamics CRM всю имеющуюся в Calltouch информацию о зафиксированных звонках, записывая ее в карточках клиентов. По каждому звонку в Microsoft Dynamics CRM отправляется подробная информация о его источнике, о клиенте, совершившем этот звонок, и более 40 других параметров, о которых речь пойдет в следующем пункте.

 

2. Передаваемые параметры в Microsoft Dynamics CRM

 

Следующие параметры передаются из Calltouch в Microsoft Dynamics CRM:

Название

Параметр

Описание

В какой момент звонка передается
Фаза звонка

callphase

Показывает в какой момент звонка по нему был отправлен webhook'.
Возможные значения:
callconnected — в момента начала звонка
calldisconnected — в момент заверешения звонка

В момент начала и завершения звонка
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

Статус звонка. Возможные значения:
successful - удачный звонок
unsuccessful - неудачный звонок

В момент завершения звонка
Уникальный звонок или нет

unique

Уникальный звонок - это первый звонок клиент со своего номера.
Если тот же клиент перезвонит с того же номера - звонок будет повторным. Если тот же клиент перезвонит с другого номера - звонок будет вновь уникальным.
Возможные значения:
true - уникальный звонок
false - повторный звонок

В момент начала и завершения звонка
Целевой звонокили нет

targetcall

Целевой звонок - это звонок, длительность которого уложилась в рамки целевого звонка, заданных в системных настройках ЛК, по умолчанию от 30 сек.
Возможные значения:
target - целевой звонок
non-target - нецелевой звонок

В момент завершения звонка
Уникально-целевой звонокили нет

uniqtargetcall

Уникально-целевой звонок - это первый звонок от клиента, укладывающийся в рамки целевого звонка. Возможные значения:
uniqtarget - уникально-целевой звонок
non-uniqtarget - не уникально-целевой звонок

В момент завершения звонка
Обратный звонок или нет

callback

Обратный звонок - это звонок либо с виджета обратного звонка Calltouch, либо с кастомной формы или кнопки сайта, подключенной к обратному звонку Calltouch.
Возможные значения:
callback - обратный звонок
non-callback - прямой звонок на отслеживаемый номер

В момент начала и завершения звонка
В рабочее или нерабочее время поступил звонок

worktime

Рабочее или нерабочее время, в которое пришел звонок, устанавливается в настройках прежней версии ЛК. Возможные значения:
worktime - рабочее время
non-worktime - нерабочее время

В момент начала и завершения звонка
Звонок на статический или динамический номер

pool

Показывает за каким типом пула закреплен номер, на который позвонил клиент.
Возможные значения:
dynamic - звонок на номер из динамического пула
staticOffline - звонок на статический оффлайн номер
staticOnline - звонок на статический онлайн номер

В момент начала и завершения звонка
Рейтинг звонка

rating

Рейтинг, присвоенный звонку в журнале звонков ЛК.
Возможные значения:
0 - рейтинг не присвоен звонку
1/2/3/4/5 - звонку присвоен рейтинг от 1 до 5 соответственно

В момент завершения звонка
Комментарии ко звонку

comment

Комментарии ко звонку, оставленные через плеер журнала звонков во время разговора.
Передаются массивом по шаблону:
comment[0][party]=user1&
comment[0][comment]=comment_by_user1&
comment[1][party]=user2&
comment[1][comment]=comment_by_user2&
Если звонку не присвоен комментарий, параметр comment не передается вовсе.

В момент завершения звонка
Теги Calltouch Predict

tags_auto_pr

Теги, присвоенные звонку автоматически системой Calltouch Predict.
Если такие теги не были присвоены звонку, передается значение null.

В момент завершения звонка
Теги Calltouch Антифрод

tags_auto_af

Теги, присвоенные звонку автоматически системой Calltouch Антифрод.
Если такие теги не были присвоены звонку, передается значение null.

В момент завершения звонка
Теги по добавочным

tags_auto_ct

Теги, присвоенную звонку автоматически на основе введенных тоновых сигналов (добавочных) клиентом или оператором в ходе разговора.
Если такие теги не были присвоены звонку, передается значение null.

В момент завершения звонка
Теги по номерам

tags_auto_pn

Теги, присвоенную звонку автоматически в зависимости от номеров, на которые или с которых звонят клиенты.
Если такие теги не были присвоены звонку, передается значение null.

В момент начала и завершения звонка
Вручную проставленные теги

tags_manual

Теги, присвоенную звонку во время разговора вручную пользователем в журнале звонков Calltouch.
Если такие теги не были присвоены звонку, передается значение null.

В момент завершения звонка
Модель атрибуции

attribution

Выбранная модель атрибуции в настройках webhook'а, согласно которой будет передаваться источник звонка.
Возможные значение:
1 - выбрана модель атрибуции “Последний непрямой” (по умолчанию)
0 - выбрана модель атрибуции “Последнее взаимодействие”

В момент начала и завершения звонка
Источник

source

Источник трафика перехода на сайт.
Либо название источника в настройках статического пула, если номер закреплен за ним и переход на сайт не предусмотрен.

В момент начала и завершения звонка
Канал

medium

Канал трафика перехода на сайт.
Либо название канала в настройках статического пула, если номер закреплен за ним и переход на сайт не предусмотрен. Если значение отсутствует, передается значение <не указано>.

В момент начала и завершения звонка
Метка utm_source

utm_source

Значение utm-метки utm_source.
Если в URL перехода отсутствовали все utm-метки, то передается значение <не указано>. Если в URL перехода были utm-метки, но utm_source отсутствовала или была пуста, то передается значение <не заполнено>.

В момент начала и завершения звонка
Метка utm_medium

utm_medium

Значение utm-метки utm_medium.
Если в URL перехода отсутствовали все utm-метки, то передается значение <не указано>. Если в URL перехода были utm-метки, но utm_medium отсутствовала или была пуста, то передается значение <не заполнено>.

В момент начала и завершения звонка
Метка utm_campaign

utm_campaign

Значение utm-метки utm_campaign.
Если в URL перехода отсутствовали все utm-метки, то передается значение <не указано>. Если в URL перехода были utm-метки, но utm_campaign отсутствовала или была пуста, то передается значение <не заполнено>.

В момент начала и завершения звонка
Метка utm_content

utm_content

Значение utm-метки utm_content.
Если в URL перехода отсутствовали все utm-метки, то передается значение <не указано>. Если в URL перехода были utm-метки, но utm_content отсутствовала или была пуста, то передается значение <не заполнено>.

В момент начала и завершения звонка
Метка utm_term

utm_term

Значение utm-метки utm_term.
Если в URL перехода отсутствовали все utm-метки, то передается значение <не указано>. Если в URL перехода были utm-метки, но utm_term отсутствовала или была пуста, то передается значение <не заполнено>.

В момент начала и завершения звонка
Дополнительные отслеживаемые параметры

add_url_params

Дополнительный отслеживаемый произвольный параметр в URL, по которому перешли на сайт.
Дополнительные отслеживаемые параметры добавляются в настройках прежней версии ЛК. Например, если клиент перешел на сайт по URL:
https://site.ru?utm_source=yandex&utm_medium=cpc&abtest=a
где параметр abtest был ранее добавлен к отслеживанию в url, то webhook'ах будет передан массив:
add_url_params[0][name]=abtest&
add_url_params[0][value]=a&
Если дополнительных параметров не было в URL перехода, параметр add_url_params не передается вовсе.

В момент начала и завершения звонка
Google Client ID

gcid

Идентификатор Google Client ID. Присутствует при настроенной интеграции с Google Analytics. Если интеграция не настроена, или настроена, но 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-адрес клиента, совершившего звонок.
Если 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, на котором был зафиксирован звонок. В момент завершения звонка

 

3. Скачивание модуля интеграции в Личном Кабинете Calltouch

 

Следующим необходимым шагом для настройки интеграции - это скачивание модуля интеграции. Его можно скачать в окне настройки интеграции в Личном Кабинете Calltouch.

mdc_sketch_alf_v3.png_2018-09-30_16-23-27.png

Скриншот места, откуда можно скачать модуль интеграции в Личном Кабинете Calltouch

 

4. Установка модуля интеграции в Microsoft Dynamics CRM

 

1. Запустите файл пакета установщика Calltouch.msi и нажмите "Далее"

p1.png

 

2. В открывшемся окне необходимо указать данные для настройки решения.

p2.png

Решение предполагает установку решения на уже предустановленные компоненты решения "АРК-РИЭЛТОР", и чистую(Базовую) систему Microsoft Dynamics CRM. 

Выберите один из предложенных программой установки вариантов:

  • 2013(2015) – выберите этот вариант, если у Вас уже установлено решение для систем CRM 2013 – 2015 версии.
  • 2016(365) – выберите этот вариант, если у Вас уже установлено решение для систем CRM 2016 – 365 версии.
  • Без установки Решения – выберите этот вариант, если Вы используете решение компании ТИСА «АРК-РИЭЛТОР»

p3.png

Выберите из раскрывающегося списка способ аутентификации:

p4.png

Выберите один из предложенных программой установки вариантов.

  • ActiveDirectory – выберите этот вариант, если вы находитесь в инфраструктуре компании, где используется ActiveDirectory. Необходимо указать учетные данные администратора CRM.
  • ActiveDirectory (Вне домена – Логин, Пароль, Домен обязательны) – выберите этот вариант, если находитесь вне сети компании. Необходимо указать учетные данные администратора CRM.
  • Online – выберите этот вариант если используете версию 365 и учетные записи Microsoft для входа в систему. Необходимо указать учетные данные администратора CRM.

В поле «Url адрес:» указывается ссылка на систему CRM

p5.png

Укажите логин и пароль администратора CRM.

Логин следует заполнять с указанием домена.

Пример: TISA\ADMIN

TISA\ = Домен сети

ADMIN = Логин администратора

p6.png

Укажите свободный порт, на котором будет настроен веб-сервис.

p7.png

Укажите путь установки программы.

Важно: не указывайте корневую папку системного диска.

p8.png

Далее, дождитесь окончания процесса установки.

p9.png

Закройте программу установщика нажатием кнопки «Готово»

p10.png

В службе IIS (Internet Information Server -Проприетарный набор серверов для нескольких служб Интернета от компании Майкрософт.) появится новое веб приложение (веб сервис): CallTouchWebService

Приложение привязано к тому порту, который был указан при установке.

p11.png

Проверьте работоспособность сервиса перейдя на него с помощью браузера.

Если служба работает правильно, то появится следующее окно.

p12.png

 

5. Получение адреса модуля и его внесение в настройку интеграции в Личном Кабинете Calltouch

 

Следующим действием для настройки интеграции будет получение и внесение адреса модуля в Личном Кабинете Calltouch.

mdc_sketch_alf_v3__1_.png_2018-09-30_17-12-11.png

Адрес модуля можно получить у системного администратора вашей CRM. Данное поле может содержать любые символы, максимум 256 символов.

 

6. Выбор модели атрибуции

 

Вам доступно на выбор две модели атрибуции: последний непрямой и последнее взаимодействие. 

Последнее взаимодействие означает, что в Microsoft Dynamics CRM будут переданы звонки, которым присвоится источник последнего взаимодействия с вашим сайтом. Последний непрямой похож на модель атрибуции Последнее взаимодействие, но он игнорирует прямой переход в конце цепочке касаний.

123213.png

 

7. Включение передачи звонков

 

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

331.png

 

На этом все: интеграция настроена и включена, а данные по звонкам передаются в карточки клиентов в Microsoft Dynamics CRM.

 

8. Пример отображения звонка в интерфейсе Microsoft Dynamics CRM

 

После полноценной настройки интеграции, информация из Calltouch начнет передаваться в Microsoft Dynamics CRM. Ниже представлены примеры того, как это будет выглядеть.

 

Данные по звонку

____________________Calltouch.jpg

 

 

Новая заявка по звонку

__________________________Calltouch.jpg

 

 

 

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 1 из 1
Еще есть вопросы? Отправить запрос

0 Комментарии

Войдите в службу, чтобы оставить комментарий.