Как настроить интеграцию с телефонией Infinity
Функциональность интеграции с телефонией Infinity лицензируется как отдельное решение. Необходимо сформировать запрос на получение лицензий, отправить его в службу поддержки, загрузить полученный файл лицензий в систему и распределить лицензии между пользователями. В системе поддерживается настройка интеграции с Infinity X.
На заметку
Данные процедуры детальнее рассмотрены в статьях “Лицензирование программного обеспечения” и “Распределение лицензий между пользователями”.
Процедура интеграции выполняется при условии, что все предварительные настройки телефонии Infinity ранее выполнены администратором телефонии.
Если вы настраиваете телефонию для приложения на продуктовой среде, то необходимо разместить TMS на отдельном узле, а не на сервере приложения Creatio. Чтобы обеспечить отказоустойчивость телефонии, рекомендуем настроить не менее двух узлов с TMS и балансировщик, который будет перенаправлять пользователей в случае потери связи с одним из узлов.
Подготовка Infinity X
На стороне Infinity X создайте учетную запись пользователя с ролью “Интеграционное подключение Third-Party”. Учетная запись будет использоваться на уровне службы интеграции. Не рекомендуется использовать данного пользователя для других целей, а также выполнять вход от его имени, так как это может привести к ошибкам в ходе интеграции.
Установка сервиса сообщений Creatio Messaging Service
Сервис сообщений позволяет соединить Creatio c телефонией, подключаясь по интеграционному протоколу к Infinity и распределяя события о звонках между пользователями Creatio.
1.Обратитесь в службу поддержки Creatio для получения файлов установки сервиса обмена сообщениями. Запустите предоставленный вам файл Creatio Messaging Service Install.msi на том компьютере, который будет использоваться в качестве сервера обмена сообщениями, и выполните установку.
Важно
На сервере, где устанавливается сервис сообщений Creatio Messaging Service, должен быть установлен .NET Framework версии 4.7.2 или выше.
2.Скопируйте папку “Client”, созданную при настройке телефонии Infinity X, в отдельную директорию, например, в папку со службой TMS.
3.Выполните разблокировку файлов в папке “Client”:
a.Запустите PowerShell с правами администратора.
b.Выполните вход в папку cd “C:\Program Files (x86)\BPMonline Messaging Service”.
c.Выполните unlock всех файлов Get-ChildItem *.* -Recurse | Unblock-File.
Или скачайте и выполните UnlockClient.ps1.
4.В файле Terrasoft.Messaging.Service.exe.config укажите в блоке Infinity значения следующих параметров:
•infinityXClientPath — укажите путь к папке “Client”. Если папка “Client” находится в папке службы TMS, то значение параметра будет таким: infinityXClientPath="\Client";
•thirdPartyIntegrationLogin — укажите логин пользователя с ролью “Интеграционное подключение Third-Party”;
•thirdPartyIntegrationPassword — укажите пароль пользователя с ролью “Интеграционное подключение Third-Party”.
5.Скопируйте с заменой следующие файлы из папки “Client” в папку “Infinity” (BPMonline Messaging Service\Connectors\Infinity):
•Cx.Integration.BaseConnector.dll;
•Cx.Integration.AgatInfinityConnectorInterfaces.dll;
•Cx.Integration.AgatInfinityConnectorFactory.dll
6.Перезапустите службу TMS.
Настройка библиотеки обмена сервисными сообщениями
Выбор и настройка библиотеки обмена сообщениями осуществляется один раз администратором системы.
1.Откройте дизайнер системы, например, нажав кнопку в правом верхнем углу приложения.
2.В группе [Настройка системы] кликните по ссылке [Системные настройки] (Рис. 1).
3.Укажите библиотеку обмена сообщениями. Для этого откройте системную настройку “Библиотека обмена сообщениями по умолчанию”. На странице системной настройки:
a.В поле [Значение по умолчанию] выберите “Библиотека интеграции с телефонией по протоколу Infinity”.
b.Нажмите [Сохранить].
4.Укажите параметры подключения к сервису сообщений. Для этого откройте системную настройку “Сервер обмена сообщениями”. На странице системной настройки:
a.В поле [Значение по умолчанию] укажите сетевой адрес сервера обмена сообщениями в виде: “ws://0.0.0.0:2013”, если ваш сайт доступен по протоколу http или “wss://0.0.0.0:2013”, если сайт доступен по протоколу https, где:
•“0.0.0.0” — IP-адрес, по которому с компьютеров пользователей, работающих в Creatio, доступен ваш сервер обмена сообщениями.
•“2013” — порт, используемый по умолчанию для подключения к сервису сообщений. Номер порта можно изменить в конфигурационном файле “Terrasoft.Messaging.Service.exe.config”.
На заметку
Если ваш сайт доступен по протоколу https и вы используете защищенное подключение (wss) для веб-сокетов, то на сервере обмена сообщениями необходимо установить сертификат безопасности и указать его в конфигурационных файлах сервиса сообщений. Для получения подробной информации о такой настройке обратитесь в службу поддержки Creatio.
b.Нажмите [Сохранить].
Настройка параметров Infinity
Данные настройки необходимо выполнить для каждого пользователя Creatio, которому была выделена лицензия на интеграцию с телефонией Infinity. Используйте персональные учетные записи этих пользователей для входа в систему.
1.Откройте страницу профиля пользователя, например, кликнув по ссылке [Профиль] на главной странице приложения.
2.Нажмите кнопку [Настройки параметров Call Centre].
3.На открывшейся странице заполните необходимые поля:
a.[Отключить интеграцию с Contact Centre] — установленный признак позволяет отключить интеграцию Creatio с телефонией. Кнопка выполнения звонка перестанет отображаться на коммуникационной панели приложения.
b.[Адрес сервера Infinity] — укажите IP-адрес и порт подключения. Порты, необходимые для полноценной работы Infinity X, можно узнать в документации Infinity.
c.[Линия] — укажите номер телефонной линии, по которой пользователь будет осуществлять звонки.
Важно
Для каждого пользователя используется отдельная линия. Не рекомендуется указывать одну линию для нескольких пользователей, поскольку это может привести к ошибкам интеграции.
d.[Включить режим отладки] — установленный признак позволяет отображать диагностическую информацию в консоли браузера. Может использоваться при возникновении проблем в телефонии и обращении клиента в службу поддержки.
4.Нажмите [Сохранить].
5.Обновите страницу вашего браузера, чтобы внесенные изменения вступили в силу.
Смотрите также
•Как настроить защищенное соединение WSS для сервиса телефонии