Для того, чтобы подключить и настроить интеграцию UIScom с Neaktor, у вас уже должны быть выполнены первичные настройки самой АТС. Вы можете прочитать про настройки АТС на страницах справки UIScom.
После того как первичная настройка UIScom будет выполнена, вам будет необходимо проделать следующие шаги:
1. Для подключения виртуальной АТС в Neaktor, войдите в систему под пользователем с доступом к интеграции с IP- телефонией. К примеру, администратор является таким пользователем.
2. Параллельно, в новой вкладке браузера, войдите в личный кабинет UIScom. В дальнейшем это понадобится для выполнения всех шагов настройки.
3. Вернитесь к Neaktor и в главном меню нажмите на зеленую кнопку с плюсом «+» и выберете Добавить / интеграцию.
4. На открывшейся странице Список доступных направлений интеграций нажмите IP- телефония
5. Далее нажмите Добавить сервис и в открывшемся окне со списком доступных сервисов IP-телефонии выберете «UIS»
6. Перед Вами откроется окно Добавление телефонии от UIS. Здесь будут выполнены основные действия для подключения интеграции в Neaktor.
7. Пока необходимо оставить окно настройки Neaktor открытым и переключится на вкладку с кабинетом UIS для выполнения ряда обязательных настроек. В правом верхнем углу нажмите Администратор и в выпадающем списке выберите Аккаунт.
8. Далее на боковой панели управления необходимо открыть пункт меню Тариф и опции
На экране отобразится список различных компонентов и опции сервиса, которые пользователь может подключить на свое усмотрение. Для работы интеграции нам обязательно необходимо подключить минимальный набор следующие компонентов:
— в разделе Виртуальная АТС – компонент Интерактивная обработка вызова. Этот компонент позволит настроить перевод входящего звонка на ответственного менеджера из Neaktor
— в разделе Запись разговоров – Уведомления, Call API Базовый набор и Call API управление вызовами. Такой набор компонентов позволит отображать карточку контакта во время входящего/ исходящего звонка, сохранять историю звонков и получать записи разговоров.
9. Далее необходимо открыть доступ к API сервиса телефонии и сгенерировать специальный ключ доступа. Ключ позволит виртуальной АТС определить, что именно вы и никто другой пытаетесь установить с ней связь. Для этого в правом верхнем углу кабинета UIS нажмите Администратор и в выпадающем списке выберете Управление пользователями.
10. Откроется страница Управление пользователями. В списке нужно найти Администратора и кликнуть на него.
11. На открывшейся странице, перейдите к разделу Доступ к функциональности API. Выставьте галочку в опции Использовать ключ API. Установите переключатель в положение Вкл, время жизни Вечно. Нажмите на кнопку Сгенерировать новый.
Отобразится уникальный ключ (код), который нужно скопировать и подставить в окно настройки Neaktor.
12. Далее мы настроим уведомления (webhook), которые виртуальная АТС будет отсылать в Neaktor каждый раз в момент совершения входящих / исходящих звонков. Уведомления являются основой, на которой строится работа всей интеграции.
Сначала, скопируйте из окна настройки интеграции Neaktor ссылку для принимающей стороны
13. Вернитесь в личный кабинет UIS и на боковой панели управления кликните на пункт меню Уведомления.
14. Перед Вами отобразится пока еще пустой список уведомлений. Приступим к созданию первого. Кликните Добавить уведомление
15. Откроется окно настройки уведомлений. Заполним все необходимые поля по порядку.
— Для начала укажите название уведомления, оно может быть произвольным, тем не менее, стоит давать логичное и понятное название.
— Из выпадающего списка Тип события выберете вариант Начало разговора
Ниже, в разделе Способ уведомления:
— включите HTTP
— из списка методов выберете POST
— в пустую строку URL вставьте, скопированную ранее ссылку из Neaktor.
— в теле запроса удалите текст по умолчанию и вставьте шаблон предназначенный специально для Neaktor
Ниже список шаблонов для каждого типа уведомления АТС:
Начало разговора | { "notification_mnemonic":{{notification_mnemonic}}, "notification_name":{{notification_name}}, "notification_time":{{notification_time}}, "external_id": {{external_id}}, "contact_phone_number":{{contact_phone_number}}, "calling_phone_number":{{calling_phone_number}}, "contact_id": {{contact_id}}, "called_phone_number":{{called_phone_number}}, "employee_phone_number":{{employee_phone_number}}, "virtual_phone_number":{{virtual_phone_number}}, "employee_full_name": {{employee_full_name}}, "employee_id": {{employee_id}}, "call_source": {{call_source}}, "call_session_id":{{call_session_id}}, "direction": {{direction}}, "leg_id": {{leg_id}}, "internal":{{extension_phone_number}}} |
Завершение звонка | {"notification_name":{{notification_name}}, "virtual_phone_number":{{virtual_phone_number}}, "notification_time":{{notification_time}}, "external_id": {{external_id}}, "contact_phone_number":{{contact_phone_number}}, "communication_number":{{communication_number}}, "employee_full_name": {{employee_full_name}}, "employee_id": {{employee_id}}, "call_source": {{call_source}}, "direction": {{direction}}, "call_session_id":{{call_session_id}}, "scenario_name": {{scenario_name}}, "talk_time_duration": {{talk_time_duration}}, "total_time_duration": {{total_time_duration}}, "wait_time_duration": {{wait_time_duration}}, "tag_names": {{tag_names}}, "notification_mnemonic":{{notification_mnemonic}}, "finish_reason":{{finish_reason}}, "start_time":{{start_time}}} |
Ожидание ответа | {"notification_mnemonic":{{notification_mnemonic}}, "notification_name":{{notification_name}}, "notification_time":{{notification_time}}, "external_id": {{external_id}}, "contact_phone_number":{{contact_phone_number}}, "calling_phone_number":{{calling_phone_number}}, "contact_id": {{contact_id}}, "called_phone_number":{{called_phone_number}}, "employee_phone_number":{{employee_phone_number}}, "virtual_phone_number":{{virtual_phone_number}}, "employee_full_name": {{employee_full_name}}, "employee_id": {{employee_id}}, "call_source": {{call_source}}, "call_session_id":{{call_session_id}}, "direction": {{direction}}, "leg_id": {{leg_id}}, "internal":{{extension_phone_number}}} |
Исходящий звонок | { "notification_mnemonic":{{notification_mnemonic}}, "notification_name":{{notification_name}}, "notification_time":{{notification_time}}, "contact_phone_number":{{contact_phone_number}}, "calling_phone_number":{{calling_phone_number}}, "contact_id": {{contact_id}}, "called_phone_number":{{called_phone_number}}, "employee_phone_number":{{employee_phone_number}}, "virtual_phone_number":{{virtual_phone_number}}, "employee_full_name": {{employee_full_name}}, "employee_id": {{employee_id}}, "call_source": {{call_source}}, "call_session_id":{{call_session_id}}, "direction": {{direction}}, "internal":{{extension_phone_number}}} |
Записанный разговор | {"notification_mnemonic":{{notification_mnemonic}}, "notification_name": {{notification_name}}, "virtual_phone_number": {{virtual_phone_number}}, "notification_time": {{notification_time}}, "scenario_name": {{scenario_name}}, "contact_phone_number": {{contact_phone_number}}, "communication_number": {{communication_number}}, "contact_id": {{contact_id}}, "contact_full_name": {{contact_full_name}} , "call_session_id": {{call_session_id}}, "employee_full_name": {{employee_full_name}}, "employee_id": {{employee_id}} , "file_link": {{file_link}}, "call_record_duration": {{file_duration}}} |
Входящий звонок на виртуальный номер | { "notification_mnemonic":{{notification_mnemonic}}, "notification_name":{{notification_name}}, "notification_time":{{notification_time}}, "external_id": {{external_id}}, "contact_phone_number":{{contact_phone_number}}, "calling_phone_number":{{calling_phone_number}}, "contact_id": {{contact_id}}, "called_phone_number":{{called_phone_number}}, "virtual_phone_number":{{virtual_phone_number}}, "call_source": {{call_source}}, "call_session_id":{{call_session_id}}, "direction": {{direction}}} |
Уведомление настроено, осталось только Сохранить.
16. Аналогичным образом необходимо создать еще шесть уведомлений. Это будут следующие типы событий (именно такие события нужно выбирать в поле настройки «Тип События»):
— Завершение звонка
— Ожидание ответа
— Исходящий звонок
— Записанный разговор
— Входящий звонок на виртуальный номер
Весь процесс создания идентичен тому что был описан в пункте 15, повторите те же шаги настройки для каждого уведомления. Для каждого уведомления в теле запроса используйте уже подготовленный шаблон. По завершению настройки, список уведомлений в кабинете UIS будет выглядеть следующем образом.
17. Настройка интеграции на стороне АТС практически завершена, мы подключили необходимые компоненты виртуальной АТС, открыли к ней доступ и настроили уведомления. Последим шагом будет настройка сценария, согласно которого должны обрабатываться входящие звонки.
На боковой панели кабинета UIS кликните Виртуальная АТС и в открывшемся списке кликните Сценарии.
18. На открывшейся странице нажмите Добавить сценарий.
19. Перед Вами отобразится страница настройки сценария. Процесс настройки работает как конструктор, а весь процесс обработки входящего звонка отображается в виде блок-схемы. Приступим к настройке.
Выберете из списка Интерактивная обработка вызова. Именно этот блок будет первым обрабатывать входящий звонок и переводить вызов на ответственного менеджера из Neaktor. Ответственным в Neaktor является пользователь, выбранный в поле Исполнитель для контакта.
20. На схеме появится первый блок. В правой части страницы панель его настройки. Здесь Вы можете переименовать блок и выбрать звуковой файл, который будет проигрываться пока абонент ждет ответа.
21. Ниже, на панели настройки блока необходимо настроить следующие поля:
— выбрать метод запроса POST, в строку URL вставьте ссылку из Neaktor
— в поле Показывать при звонке выберете Номер звонящего
— проставьте все галочки в списке
22. Далее, на этой же панели следует раздел настройки Связанные операции. Здесь добавляются действия, которые выполняет АТС в случае неудачной переадресации, или какой-либо ошибки из внешней системы.
Найдите в списке Переадресация не удалась и кликните на «+». В открывшемся списке нажмите на Переадресация.
Такие же действия выполните для Ошибка http-запроса.
Сейчас ваша схема выглядит следующим образом:
Поясним, как работает такая схема. Сначала входящий звонок будет перенаправлен на менеджера из Neaktor, если менеджер не ответит, или произойдет какой-либо сбой (ошибка), то входящий звонок в обоих случаях пойдет по сценариям переадресации, то есть на других сотрудников. Как именно вызов будет следовать мы сейчас настроим.
23. Процесс настройки переадресаций одинаковый, поэтому рассмотрим настройку переадресации для ветки схемы Переадресация не удалась
Необходимо добавить группу сотрудников, на которых будет переводится звонок. Нажмите Добавить группу. Вам будет предложено создать группу прямо сейчас, или выбрать уже настроенную. Рассмотрим вариант Создать новую группу.
24. Откроется окно настройки группы. Введите название группы и затем выберете из общего списка ваших сотрудников, кто именно будет входить в новую группу.
25. Когда все сотрудники будут добавлены, опуститесь ниже в окне настройки. Там вы увидите сформированный список. В нем с помощью перетягивания можно менять положение (приоритет) сотрудника, выставлять процент загруженности, время дозвона и график активности (если он настроен). Здесь же для группы Вы можете задать отдельный внутренний номер. После завершения всех настроек нажмите Создать.
26. После сохранения, список вашей группы отобразится на панели настройки модуля переадресации. Сразу под списком, необходимо выбрать логику дозвона Как дозваниваться. Возле каждого из вариантов Вы найдете справку с описанием логики маршрутизации входящего звонка. В примере был выбран вариант По приоритету, выберете подходящую для Вас.
27. Для логического завершения схемы АТС вы можете добавить информационноe сообщение. Аудио файл будет воспроизводится в том случае, если никто из группы ваших сотрудников не ответит на входящий звонок.
Для этого необходимо в настройке блока переадресации перейти к разделу Связанные операции и кликнув на иконку «+» выбрать из списка Информационное сообщение
28. После сохранения схемы необходимо указать АТС какой сценарий использовать для обработки вызовов. В боковой панели найдите Виртуальную АТС и ниже кликните на Виртуальные номера и правила.
29. На открывшейся странице нужно создать новое правило для номера. Откройте выпадающий список Создать правило и выберите пункт Обработка звонка.
30. В графе Выполнять сценарий, найдите свой сценарий, выберете его и сохраните изменения.
31. Настройка АТС завершена, добавлены и настроены основные блоки схемы. UIS позволяет настраивать достаточно сложную логику обработки звонков. В данном примере мы настроили простую схему необходимую для работы интеграции. За подробностями обратитесь к документацией виртуальной АТС
32. Вернемся к настройке интеграции на стороне Neaktor. Сейчас окно настройки интеграции должно выглядеть так:
Нажмите Подключить
Если все заполнено правильно, то интеграция автоматически будет установлена, и вы сразу окажитесь внутри настройки, на вкладке Распределение номеров
Здесь, из списка пользователей Neaktor, нужно добавить тех же сотрудников, которых вы уже добавили в настройках АТС. Для сотрудников в Neaktor нужно указать внешние номера, а затем sip-линии, такие же как в настройках виртуальной АТС. Это необходимо для того, чтобы карточка при звонке показывалась именно тем сотрудникам, кому действительно поступает звонок, согласно настроек в кабинете провайдера телефонии.
Если Вы включите опцию Звонить из Neaktor, то сможете осуществлять звонки прямо из приложения (браузера).
В таком случае можно отказаться от использования специальных программ (софтфон).
Если оставить опцию выключенной — для звонков потребуется софтфон. В остальном оба варианта использования интеграции ничем не отличаются: попап звонка, история, записи разговоров, маршрутизация звонков, все работает одинаково.
Данные sip-линий можно найти в кабинете UIS. На боковой панели кабинета найдите раздел Виртуальная АТС > Sip-линии
Теперь кликните на нужную линию.
в открывшемся окне, Вы увидите все необходимы данные.
33. Далее подключим модель бизнес-процесса по которой в компании будут создаваться контакты. Для этого внутри настройки интеграции с onlinePBX перейдите на вкладку Настройка базы контактов, и на открывшейся странице нажмите Добавить бизнес-процесс.В окне настройки базы контактов нужно указать путь к модели бизнес-процесса, которая будет использоваться для создания самих контактов.
Для этого поочередно выберите значения в полях Модуль > Проект > Модель бизнес-процесса
Важно чтобы на форме, выбранной модели бизнес-процесса, было, как минимум одно поле с типом Телефон. Именно по этому полю система будет искать контакт, в момент осуществления входящих, или исходящих звонков.
Если полей с типом Телефон на форме несколько, то важно, в каком порядке вы их добавите в список Поле с типом телефон. В то, которое стоит первым, будет автоматически сохраняться номер телефона при первом звонке, входящем или исходящем.
В этом же окне Вы можете выбрать поля, которые должны показываться в всплывающем окне при поступлении звонка. Порядок полей тоже имеет значение — отсортируйте, в каком порядке будут показаны поля в окне входящего / исходящего звонка.
34. Готово, теперь интеграция с телефонией подключена и полностью готова к работе. В дополнительных настройках интеграции по умолчанию включено сохранение записей разговоров и перенаправление на ответственного.
Если настройки UIS в будущем изменяться, например, сгенерируются новые ключи доступа к сервису, Вы можете внести эти изменения на вкладке Настройки интеграции.