Aspro.Cloud

Дата публикации:

Что это такое и зачем нужно

Решение для совершения и приема звонков в системе Аспро.Cloud, с сохранением данных по звонкам и записей разговоров.

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

уведомления о входящих звонках в CRM;
открытие карточки клиента при приеме входящего звонка;
соединение звонящего с персональным менеджером, закрепленным в CRM;
уведомления о пропущенных звонках;
звонок по клику из карточки клиента;
история звонков;
записи разговоров.

Как подключить

Важно

Для работы интеграции необходима дополнительная опция: актуальное название и стоимость уточняйте у вашего персонального менеджера.

Как настроить

Чтобы UIS и Aspro.Cloud обменивались данными, нужно создать авторизационный ключ API, а так же добавить IP 195.211.122.131 в белый список.

Как создать ключ API указано тут: Создание ключа API у пользователя.

Как добавить IP в белый список указано тут: Добавление IP в белый список.

Далее перейдите по ссылке https://custom.uiscom.ru/aspro.cloud/ и в открывшейся форме введите ключ API, полученный на предыдущем шаге, выберите в меню UIS и кликните «Войти»:

После успешной авторизации откроются настройки:

В новой вкладке откройте ваш аккаунт Aspro.Cloud для настройки модуля телефонии. В основном меню перейдите в «Настройки» → «Приложения» → «Коммуникации и связь», найдите «IP-телефония» и нажмите на «Установить»:

После установки приложения нажмите на «Перейти в приложение» → «Настроить приложение» и выберите «UIS». В настройках скопируйте URL аккаунта для настройки уведомлений:

Вернитесь на предыдущую вкладку с настройками интеграции, вставьте скопированный адрес в поле URL для настройки уведомлений и сохраните:

Включите интеграцию, скопируйте и сохраните «Ключ API — UIS»:

Вернитесь на вкладку с настройками телефонии Aspro.Cloud и в поле «Ключ API — UIS» вставьте скопированный ключ. Настройте обработку звонка и кликните «Подключить»:

Синхронизация сотрудников

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

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

Присвойте сотрудникам внутренние номера — они понадобятся в настройках сервиса Aspro.Cloud:

В аккаунте Aspro.Cloud настройте сопоставление внутреннего номеров: слева отображаются добавочные номера пользователей в UIS, а справа — пользователи Aspro.Cloud:

Не забудьте сохранить изменения.

Настройка прав доступа в Aspro.Cloud

Для модуля IP-телефонии доступны следующие права доступа:

Администратор — позволяет подключать телефонию, редактировать сценарии обработки звонков и информацию о пользователях, а также просматривать полный список звонков. Удаление звонков или записей разговоров не доступно даже Администратору.

Сотрудник — может звонить и принимать вызовы, просматривать только собственные звонки.

Доступ запрещен — модуль телефонии будет скрыт из аккаунта, пользователь не сможет совершать или принимать звонки, не увидит информацию о звонках и их историю в карточках сделки или контакта.

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

Чтобы данные из UIS передавались в Aspro.Cloud, нужно будет настроить пять типов HTTP-уведомлений о событиях. Для этого в левом меню кликните на пункт «Интеграции» → «HTTP-уведомления» → «Добавить HTTP-уведомление»:

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

1. Название уведомления: Потерянный звонок (Aspro.Cloud)

Тип события: Потерянный звонок

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

Метод: POST

URL: https://custom.uiscom.ru/aspro.cloud/api/webhook/

2. Название уведомления: Ожидание ответа (Aspro.Cloud)

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

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

Метод: POST

URL: https://custom.uiscorn.ru/aspro.cloud/api/webhook/

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

Копировать

{
  "app_id": {{app_id}},
  "notification_mnemonic":{{notification_mnemonic}},
  "notification_name":{{notification_name}},
  "start_time":{{start_time}},
  "calling_phone_number":{{calling_phone_number}},
  "called_phone_number":{{called_phone_number}},
  "contact_phone_number":{{contact_phone_number}},
  "virtual_phone_number":{{virtual_phone_number}},
  "employee_full_names":{{employee_full_names}},
  "employee_ids":{{employee_ids}},
  "call_session_id":{{call_session_id}},
  "direction": {{direction}}
}

2. Название уведомления: Ожидание ответа (Aspro.Cloud)

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

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

Метод: POST

URL: https://custom.uiscorn.ru/aspro.cloud/api/webhook/

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

Копировать

{
  "app_id": {{app_id}},
  "notification_mnemonic":{{notification_mnemonic}},
  "notification_name":{{notification_name}},
  "start_time":{{start_time}},
  "calling_phone_number":{{calling_phone_number}},
  "called_phone_number":{{called_phone_number}},
  "contact_phone_number":{{contact_phone_number}},
  "virtual_phone_number":{{virtual_phone_number}},
  "employee_full_name":{{employee_full_name}},
  "extension_phone_number":{{extension_phone_number}},
  "employee_phone_number":{{employee_phone_number}},
  "employee_id": {{employee_id}},
  "call_session_id":{{call_session_id}},
  "direction": {{direction}}
}

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

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

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

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

Метод: POST

URL: https://custom.uiscorn.ru/aspro.cloud/api/webhook/

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

Копировать

{
  "app_id":{{app_id}},
  "notification_mnemonic":{{notification_mnemonic}},
  "notification_name":{{notification_name}},
  "start_time":{{start_time}},
  "calling_phone_number":{{calling_phone_number}},
  "called_phone_number":{{called_phone_number}},
  "contact_phone_number":{{contact_phone_number}},
  "virtual_phone_number":{{virtual_phone_number}},
  "employee_full_name":{{employee_full_name}},
  "extension_phone_number":{{extension_phone_number}},
  "employee_phone_number":{{employee_phone_number}},
  "employee_id": {{employee_id}},
  "call_session_id":{{call_session_id}},
  "direction": {{direction}}
}

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

4. Название уведомления: Начало разговора (Aspro.Cloud)

Тип события: Начало разговора

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

Метод: POST

URL: https://custom.uiscorn.ru/aspro.cloud/api/webhook/

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

Копировать

{
  "app_id":{{app_id}},
  "notification_mnemonic":{{notification_mnemonic}},
  "notification_name":{{notification_name}},
  "start_time":{{start_time}},
  "calling_phone_number":{{calling_phone_number}},
  "called_phone_number":{{called_phone_number}},
  "contact_phone_number":{{contact_phone_number}},
  "virtual_phone_number":{{virtual_phone_number}},
  "employee_full_name":{{employee_full_name}},
  "extension_phone_number":{{extension_phone_number}},
  "employee_phone_number":{{employee_phone_number}},
  "employee_id": {{employee_id}},
  "call_session_id":{{call_session_id}},
  "direction": {{direction}}
}

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

5. Название уведомления: Записанный разговор (Aspro.Cloud)

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

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

Метод: POST

URL: https://custom.uiscorn.ru/aspro.cloud/api/webhook/

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

Копировать

{
  "app_id":{{app_id}},
  "notification_mnemonic":{{notification_mnemonic}},
  "notification_name": {{notification_name}},
  "virtual_phone_number": {{virtual_phone_number}},
  "notification_time": {{notification_time}},
  "scenario_name": {{scenario_name}},
  "contact_info": {
    "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_info": {
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}}
  },
  "call_record_file_info": {
    "file_link": {{file_link}},
    "call_record_duration": {{file_duration}}
  },
  "tag_ids": {{tag_ids}},
  "tag_names": {{tag_names}}
}

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

Настройка соединения с персональным менеджером

При подключении опции BATC PRO можно настроить автоматическое соединение звонящего с его персональным менеджером. Если он не ответит, звонок будет обработан по любому другому алгоритму, заданному в настройках UIS.

Для этого перейдите в раздел «Настройки» → «Обработка обращений» → «Обработка обращений» и нажмите на «Добавить сценарий»:

Задайте название сценария, кликните + и в настройках «Распределения вызовов» выберите операцию «Интерактивная обработка вызова»:

Скопируйте URL-адрес для обработки уведомлений от телефонии в панели настроек телефонии в Aspro.Cloud:

Вставьте скопированный адрес в поле URL для авторизации, выберите метод POST и отметьте все пункты ниже:

Если звонок поступит с номера, который еще не заведен в системе, Aspro.Cloud может обработать его в соответствии с дополнительным сценарием: в пункте Связанные операции настройте алгоритм обработки в поле Код возврата 1. Также рекомендуем настроить сценарий обработки звонков на случай ошибок в пункте Ошибка HTTP-запроса.

Как пользоваться

Работа со звонками

Совершать исходящие вызовы можно из карточки контакта или из списка клиентов, а также с помощью виджета трубки в правом верхнем углу рабочего пространства. Если сотрудник связан с учетными записями сразу нескольких провайдеров телефонии, ему будет доступен выбор, с какой телефонии совершить исходящий вызов.

Из виджета также доступен список последних вызовов с возможностью повторного набора и перехода в карточку контакта.

Важно

Обратите внимание, что вызов будет производиться с той телефонии, которая выбрана по умолчанию.

При поступлении входящего звонка в левом нижнем углу откроется окно с информацией о звонящем. Карточку клиента можно открыть после принятия вызова.

После окончания звонка в зависимости от заданного сценария обработки звонков, будет создана карточка клиента, сделка или задача. Информация о звонке запишется в карточку клиента. Если во Aspro.Cloud сохранено несколько клиентов с одним и тем же номером телефона, то будет выбран последний сохраненный клиент.

Если сотрудник пропустил звонок, при входе в аккаунт он получит уведомление и сможет сразу же перезвонить клиенту. В настройках уведомлений можно активировать получение уведомлений о пропущенных в браузере, на почту или на мобильный телефон, если установлено приложение Aspro.Cloud.

История звонков

В разделе «Еще» → «IP-телефония» отображаются вкладки для каждой активной телефонии со списком звонков. В списках доступны поиск, фильтры, а также настраиваемое отображение колонок с информацией по типу звонка, длительности разговора, его записи и ответственному менеджеру.

Записи звонков можно прослушать прямо из списка. При воспроизведении разговора вы можете скачать его на рабочий стол, ускорить или замедлить прослушивание: