РосКвартал - АДС на 100% - современная диспетчерская для УК

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

• уведомление о входящем звонке и открытие карточки клиента:

• история в журнале звонков:

• сохранение и прослушивание записи звонка в «АДС на 100%» 

• уведомления о потерянных звонках (звонки, пропущенные во время того, как сотрудник не был авторизован в CRM, будут показаны при авторизации)

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

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

И подключите API Оптимальный:

Чтобы UIS и «АДС на 100%» могли обмениваться данными, необходимо внести IP-адреса 0.0.0.0/0  в белый список UIS и создать авторизационный ключ API.

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

Чтобы получить авторизационный ключ API, войдите в Управление пользователями:

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

Перейдите в Настройки сервиса «АДС на 100%» в раздел Телефония и СМС, затем выберите вкладку Телефонии и кликните на +

Выберите из списка UIS и кликните Добавить:

Вставьте сгенерированный ранее Ключ API из Личного кабинета UIS в строку ApiKey и сохраните изменения:

Если ключ был введен верно, то поле Appid заполнится автоматически. В случае ошибки сгенерируйте новый ключ в личном кабинете UIS.

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

Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в личном кабинете UIS, и в сервисе «АДС на 100%».

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

Присвойте сотрудникам внутренние номера, если этого не было сделано ранее. Внутренние номера понадобятся для синхронизации с пользователями «АДС на 100%»:

В сервисе «АДС на 100%» перейдите на вкладку Добавочные номера, выберите пользователя, соответствующего сотруднику в Личном кабинете UIS, и кликните на +

В списке выберите UIS и укажите добавочный номер сотрудника из Личного кабинета UIS, сохраните изменения:

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

Чтобы данные из UIS передавались в «АДС на 100%», необходимо настроить три типа HTTP-уведомлений о событиях.

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

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

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

Название уведомления: Ожидание ответа (АДС на 100%)

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

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

Метод: POST

URL: https://dispatch.roskvartal.ru/api/telephony/uis/call

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

{
"appId":{{app_id}},
"action":"wait",
"isTransferred":{{is_transferred}},
"callSessionId":{{call_session_id}},
"legId":{{leg_id}},
"extensionPhoneNumber":{{extension_phone_number}},
"contactPhoneNumber":{{contact_phone_number}},
"direction":{{direction}},
"startTime":{{start_time}}
}

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

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

Название уведомления: Начало разговора (АДС на 100%)

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

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

Метод: POST

URL: https://dispatch.roskvartal.ru/api/telephony/uis/call

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

{"appId":{{app_id}},
"action":"connect",
"isTransferred":{{is_transferred}},
"callSessionId":{{call_session_id}},
"legIds":{{leg_ids}},
"extensionPhoneNumber":{{extension_phone_number}},
"contactPhoneNumber":{{contact_phone_number}},
"direction":{{direction}},
"startTime":{{start_time}},
"notificationTime":{{notification_time}},
"answerTime":{{answer_time}}
}

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

• для третьего типа:

Название уведомления: Завершение звонка (АДС на 100%)

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

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

Метод: POST

URL: https://dispatch.roskvartal.ru/api/telephony/uis/call

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

{"appId":{{app_id}},
"action":"disconnect",
"isTransferred":{{is_transferred}},
"callSessionId":{{call_session_id}},
"extensionPhoneNumber":{{extension_phone_number}},
"contactPhoneNumber":{{contact_phone_number}},
"direction":{{direction}},
"startTime":{{start_time}},
"endTime":{{finish_time}},
"isLost":{{is_lost}},
"lostReason":{{lost_reason}},
"fullRecordLink":{{full_record_file_link}}
}

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

Настройка завершена.