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
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 войдите в раздел Уведомления, кликните Добавить уведомление:
Необходимо настроить четыре уведомления:
1) Название уведомления: Завершение звонка
Тип события: Завершение звонка
Способ уведомления: 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}}
}2) Название уведомления: Записанный разговор
Тип события: Записанный разговор
Способ уведомления: 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}}
}3) Название уведомления: Ожидание ответа
Тип события: Ожидание ответа
Способ уведомления: 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}}
} 4) Название уведомления: Поднятие трубки
Тип события: Поднятие трубки
Способ уведомления: 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 и захотите вернуться к старой схеме.
