U-ON Travel - CRM для турбизнеса

Функциональность интеграции

• открытие карточки клиента при входящем звонке
• соединение звонящего с персональным менеджером 
• исходящий звонок по клику на номер:

• исходящий звонок из карточки клиента:

• история звонков и прослушивание их записей из интерфейса CRM U-ON Travel:

• прослушивание звонков из карточки клиента:

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

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

Если вы хотите использовать соединение с персональным менеджером, подключите API Расширенный:

Если соединение с персональным менеджером не нужно, подключите API Оптимальный:

Для того, чтобы UIS и U-ON Travel могли обмениваться данными, необходимо внести IP-адрес 0.0.0.0/0 в белый список UIS и создать авторизационный ключ API.

Перейдите в раздел Аккаунт - Правила и настройки безопасности - вкладка API добавьте 0.0.0.0/0

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

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

Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в личном кабинете UIS, и в сервисе U-ON Travel.

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

Заполните необходимые поля и добавьте SIP линию сотруднику. Кликните Создать:

Перейдите в аккаунт в U-ON Travel,  меню Интеграции - IP-телефония:

В списке выберете UISCOM и кликните Подключить:

В открывшемся окне заполните поля:

Постоянный ключ API мы получили на первом шаге настройки интеграции.

Номер телефона ВАТС - основной номер, арендуемый в UIS.

В качестве SIP-номера используйте шестизначный SIP-логин сотрудника из личного кабинета UIS:

Чтобы увидеть SIP-логины ваших сотрудников, в личном кабинете UIS откройте раздел Виртуальная АТС - SIP-линии:

Кликните Сохранить.

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

Для передачи данных из UIS (история звонков, записи разговоров и пр.) потребуется ID вашего аккаунта в U-ON Travel: его можно скопировать из адресной строки, находясь в аккаунте:

Скопируйте и сохраните ID, он понадобится для дальнейшей настройки.

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

В открывшейся форме заполните следующие поля:

• для первого уведомления

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

Тип события: Завершение звонка

Способ уведомления: HTTP

Метод: POST

URL: https://*<ID вашего кабинета>*.u-on.ru/api/uiscom_incoming.php

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

{
 "event":{{notification_mnemonic}},
 "call_session_id":{{call_session_id}},
 "duration":{{talk_time_duration}},
 "start":{{start_time}},
 "scenario_name": {{scenario_name}},
 "calling_phone_number":{{calling_phone_number}},
 "employee_phone_number":{{employee_phone_number}},
 "direction":{{direction}},
 "virtual_phone_number":{{virtual_phone_number}}
}

Кликните Создать.

• для второго уведомления:

Название уведомления: Записанный разговор

Тип события: Записанный разговор

Способ уведомления: HTTP

Метод: POST

URL: https://*<ID вашего кабинета>*.u-on.ru/api/uiscom_incoming.php

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

{
 "event":{{notification_mnemonic}},
 "scenario_name": {{scenario_name}},
 "call_session_id":{{call_session_id}},
 "file_link":{{file_link}}
}

Кликните Создать.

• третье уведомление

Название уведомления: Ожидание ответа

Тип события: Ожидание ответа

Способ уведомления: HTTP

Метод: POST

URL: https://*<ID вашего кабинета>*.u-on.ru/api/uiscom_incoming.php

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

{
 "event":{{notification_mnemonic}},
 "call_session_id":{{call_session_id}},
 "calling_phone_number":{{calling_phone_number}},
 "scenario_name": {{scenario_name}},
 "employee_phone_number":{{employee_phone_number}},
 "direction":{{direction}},
 "virtual_phone_number": {{virtual_phone_number}}
} 

Кликните Создать.

• последнее:

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

Тип события: Поднятие трубки

Способ уведомления: HTTP

Метод: POST

URL: https://*<ID вашего кабинета>*.u-on.ru/api/uiscom_incoming.php

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

{
 "event":{{notification_mnemonic}},
 "call_session_id":{{call_session_id}},
 "duration":{{talk_time_duration}},
 "start":{{start_time}},
 "calling_phone_number":{{calling_phone_number}},
 "scenario_name": {{scenario_name}},
 "employee_phone_number":{{employee_phone_number}},
 "extension_phone_number":{{extension_phone_number}},
 "employee_id":{{employee_id}},
 "direction":{{direction}}
}

Кликните Создать.

Во каждом уведомлении есть параметр "scenario_name", который передает в историю звонков U-On Travel название сценария, по которому прошел входящий звонок:

Если вы не хотите видеть эту информацию в истории звонков, удалите параметр "scenario_name" из тела всех уведомлений.

Соединение с персональным менеджером

Логика соединения с ответственным такая: при поступлении входящего звонка UIS посылает в U-ON Travel запрос, а U-ON Travel в ответ присылает ответ: с каким сотрудником CRM соединять звонящего.

В Личном кабинете UIS перейдите в раздел Виртуальная АТС - Сценарии, кликните Добавить сценарий, в открывшемся окне задайте название и выберите операцию Интерактивная обработка вызова:

В открывшейся форме:

• в поле Метод выберите POST
• в поле URL для авторизации укажите URL с адресом вашего кабинета U-ON: https://<адрес вашего кабинета в U-ON>/api/uis_incoming.php
• отметьте все поля в блоке Название - Мнемоника
• в блоке Связанные операции в пунктах Ошибка http-запроса и Переадресация не удалась выберите "Вставить сценарий" и вставьте тот, который обычно используете для обработки входящих звонков. Это нужно для того, чтобы звонки, не дошедшие до персонального менеджера, не потерялись.
• сохраните.

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

Не удаляйте старые сценарии и правила обработки звонков на случай, если передумаете пользоваться U-ON Travel и захотите вернуться к старой схеме.