открытие карточки клиента при входящем звонке
исходящие звонки по клику
сохранение и прослушивание записи звонка в SalesapCRM (обратите внимание, записи хранятся в соответствии с конфигурацией вашего тарифа в UIS)
передача данных коллтрекинга (только для пользователей коллтрекинга в UIS)
уведомления о потерянных звонках

Подключение и настройка

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

И подключите API «Базовые отраслевые решения»:

Чтобы UIS и SalesapCRM могли беспрепятственно обмениваться данными, необходимо внести IP-адрес SalesapCRM в белый список в UIS, а в SalesapCRM указать авторизационный ключ API.

В личном кабинете UIS войдите в раздел Правила и настройки безопасности, вкладка API, и добавьте IP-адрес 51.250.61.115.

Копировать

51.250.61.115

Чтобы получить авторизационный ключ API, войдите в Управление пользователями и разрешите Администратору доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании:

Перейдите в SalesapCRM — Настройки — Интеграции и выберите виджет UIS:

Заполните все поля:

введите логин и пароль от личного кабинета UIS
укажите основной виртуальный номер (скопируйте его в личном кабинете UIS)
введите ключ доступа API, полученный на предыдущем шаге
добавьте короткие номера сотрудников: этими номерами являются шестизначные SIP-логины сотрудников из личного кабинета UIS, скопировать их можно в разделе SIP-линии:

Если сотрудники будут принимать звонки на мобильных, а не SIP, укажите мобильные в качестве внутренних в SalesapCRM, в формате +7ХХХХХХХХХХ

Настройка уведомлений

Чтобы данные из UIS передавались в SalesapCRM, необходимо настроить шесть типов HTTP-уведомлений о событиях.

URL адрес для отправки уведомлений скопируйте в настройках интеграции SalesapCRM из поля Адрес для уведомлений:

В личном кабинете UIS войдите в раздел Уведомления, нажмите Добавить уведомление:

Необходимо настроить шесть уведомлений:

1) Название уведомления: Входящий звонок на виртуальный номер

Тип события: Входящий звонок на виртуальный номер
Способ уведомления: HTTP
Метод: POST
URL: вставьте URL, скопированный из настроек SalesapCRM

В тело уведомления вставьте текст:

Копировать

{
"direction":{{direction}},
"notification_name":{{notification_name}},
"notification_mnemonic":{{notification_mnemonic}},
"virtual_phone_number":{{virtual_phone_number}},
"notification_time":{{notification_time}},
"scenario_name": {{scenario_name}},
"start_time":{{start_time}},
"called_phone_number":{{called_phone_number}},
"calling_phone_number":{{calling_phone_number}},
"call_session_id":{{call_session_id}}
}

2) Название уведомления: Исходящий звонок

Тип события: Исходящий звонок
Способ уведомления: HTTP
Метод: POST
URL: вставьте URL, скопированный из настроек SalesapCRM

В тело уведомления вставьте текст:

Копировать

{
"direction":{{direction}},
"notification_name":{{notification_name}},
"notification_mnemonic":{{notification_mnemonic}},
"virtual_phone_number":{{virtual_phone_number}},
"notification_time":{{notification_time}},
"scenario_name": {{scenario_name}},
"start_time":{{start_time}},
"called_phone_number":{{called_phone_number}},
"calling_phone_number":{{calling_phone_number}},
"call_session_id":{{call_session_id}},
"employee_phone_number":{{employee_phone_number}}
}

3) Название уведомления: Завершение звонка

Тип события: Завершение звонка
Способ уведомления: HTTP
Метод: POST
URL: вставьте URL, скопированный из настроек SalesapCRM

В тело уведомления вставьте текст:

Копировать

{
"direction":{{direction}},
"notification_name":{{notification_name}},
"virtual_phone_number":{{virtual_phone_number}},
"Start_time":{{start_time}},
"finish_time":{{finish_time}},
"called_phone_number":{{called_phone_number}},
"calling_phone_number":{{calling_phone_number}},
"call_session_id":{{call_session_id}},
"total_time_duration": {{total_time_duration}},
"wait_time_duration": {{wait_time_duration}},
"employee_phone_number":{{employee_phone_number}}
}

4) Название уведомления: Потерянный звонок

Тип события: Потерянный звонок
Способ уведомления: HTTP
Метод: POST
URL: вставьте URL, скопированный из настроек SalesapCRM

В тело уведомления вставьте текст:

Копировать

{
"direction":{{direction}},
"notification_name":{{notification_name}},
"notification_mnemonic":{{notification_mnemonic}},
"virtual_phone_number":{{virtual_phone_number}},
"notification_time":{{notification_time}},
"scenario_name": {{scenario_name}},
"start_time":{{start_time}},
"called_phone_number":{{called_phone_number}},
"calling_phone_number":{{calling_phone_number}},
"call_session_id":{{call_session_id}}
}

5) Название уведомления: Запись звонка

Тип события: Запись звонка
Способ уведомления: HTTP
Метод: POST
URL: вставьте URL, скопированный из настроек SalesapCRM

В тело уведомления вставьте текст:

Копировать

{
"notification_name": {{notification_name}},
"virtual_phone_number": {{virtual_phone_number}},
"notification_time": {{notification_time}},
"scenario_name": {{scenario_name}},
"file_link": {{file_link}},
"call_record_duration": {{file_duration}},
"call_session_id":{{call_session_id}},
"direction":{{direction}},
"called_phone_number":{{called_phone_number}},
"calling_phone_number":{{calling_phone_number}},
"employee_phone_number":{{employee_phone_number}}
}

6) Название уведомления: Поднятие трубки

Тип события: Поднятие трубки
Способ уведомления: HTTP
Метод: POST
URL: вставьте URL, скопированный из настроек SalesapCRM

В тело уведомления вставьте текст:

Копировать

{
"notification_name":{{notification_name}},
"notification_mnemonic":{{notification_mnemonic}},
"notification_time":{{notification_time}},
"call_source": {{call_source}},
"call_session_id":{{call_session_id}},
"direction": {{direction}},
"start_time": {{start_time}},
"connection_time":{{connection_time}},
"employee_phone_number":{{employee_phone_number}}
}

Если вы пользуетесь коллтрекингом в UIS, добавьте дополнительное уведомление, которое позволит передать в SalesapCRM данные о рекламе:

Название уведомления: Входящий звонок на виртуальный номер

Тип события: Входящий звонок на виртуальный номер
Способ уведомления: HTTP
Метод: POST
URL: состоит из самого адреса и :uuid и имеет такой вид: https://calltracking-client.app.salesap.ru/integration/:uuid

где :uuid — индивидуальный параметр для пользователя SalesapCRM. Скопируйте его из настроек интеграции SalesapCRM:

В тело уведомления вставьте текст:

Копировать

{
"utm_term": {{utm_term}},
"utm_campaign": {{utm_campaign}},
"utm_medium": {{utm_medium}},
"utm_content": {{utm_content}},
"utm_source":{{utm_source}},
"city": {{visitor_city}},
"call_id": {{call_session_id}},
"landing_page": {{site_domain_name}},
"phone": {{calling_phone_number}}
}

Настройка завершена.

Эта статья была полезна для людей. Эта статья помогла Вам?

Да, помогла!

Вопрос не решён