SalesapCRM (S2) - облачная CRM для отдела продаж
Функциональность интеграции
- открытие карточки клиента при входящем звонке
- исходящие звонки по клику
- сохранение и прослушивание записи звонка в 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}}
}Настройка завершена.
