Studio Creatio
PDF
This documentation is valid for Creatio version 7.16.0. We recommend using the newest version of Creatio documentation.

How to integrate with Infinity

In Creatio, the Infinity integration functionality requires a separate license. You need to generate a license request, send it to our service team, upload the received license file into the system and finally, distribute the licenses between the users. Creatio supports integration with Infinity X.

Note

See more details about licensing in the “Software licensing” and “License distribution” articles.

The integration is only possible if complete preliminary Infinity setup was performed by the phone integration administrator.

If you set up the telephony for a development environment application, locate TMS on a separate node instead of the Creatio application server. To ensure the fault tolerance of your phone integration, we recommend setting up at least two nodes with TMS, as well as a balancer that would redirect users in case of lost connection with one of the nodes.

Preparing Infinity X

Create an account in Infinity X with the role “Third-Party integration connection”. This account will be used on the integration service level. It is not recommended to use this user account for other purposes, or log in under this user account, as this may cause integration errors.

Setting Creatio messaging service

The messaging service connects to Infinity and distributes call events between Creatio users.

1.Contact Creatio support to receive the installation files. Run the received .MSI file on the message exchange server and proceed with the installation.

Attention

.NET Framework of version 4.7.2 or higher should be installed on the server where you configure the Creatio Messaging Service.

2.Copy the “Client” folder (created during the Infinity X setup) to a separate folder, e.g., the folder with the TMS service.

3.Unlock the files in the “Client” folder:

a.Run PowerShell as an administrator.

b.Open the messaging service folder: cd “C:\Program Files (x86)\BPMonline Messaging Service”.

c.Unlock all files: Get-ChildItem *.* -Recurse | Unblock-File.

Alternatively, download and execute UnlockClient.ps1.

4.Specify the following parameters in the Infinity block of the Terrasoft.Messaging.Service.exe.config file:

infinityXClientPath – the path to the “Client” folder. If the “Client” folder is located in the TMS service folder, the parameter value will be as follows: infinityXClientPath="\Client"

thirdPartyIntegrationLogin – the login of the user with the “Third-Party integration connection” role

thirdPartyIntegrationLogin – the password of the user with the “Third-Party integration connection” role.

5.Copy and replace the following files from the “Client” folder to the “Infinity” (Messaging Service\Connectors\Infinity):

Cx.Integration.BaseConnector.dll;

Cx.Integration.AgatInfinityConnectorInterfaces.dll;

Cx.Integration.AgatInfinityConnectorFactory.dll

6.Restart the TMS service.

Setting up message exchange library

Message exchange library selection and setup is performed once by the system administrator.

1.Open the system designer by clicking btn_system_designer00011.png in the top right corner of the application window.

2.Click the [System settings] link in the [System setup] block (Fig. 1).

Fig. 1 Opening the [System settings] section

scr_chapter_telephony_setup_link_system_settings00012.png 

3.Specify the message exchange library. To do this, open the “Default messages exchange library” system setting. On the system setting page:

a.Populate the [Value by default] field by selecting the "Phone integration library based on Infinity protocol” value.

b.Click [Save].

4.Specify the message service connection parameters. To do this, open the “Message exchange server” system setting. On the system setting page:

a.In the [Default value] field, specify the message exchange network address in the following format: “ws://0.0.0.0:2013”, if your website is available by the http protocol, or “wss://0.0.0.0:2013”, if your website is available by the https protocol, where:

“0.0.0.0” – IP address that your Creatio users use to access your message exchange server.

“2013” – the port used by default for connecting to the messaging service. You can change the port number in the “Terrasoft.Messaging.Service.exe.config” file.

Note

If your website is available by HTTPS and secure (WWS) connection is used for WebSockets, you will need to install a security certificate on the message exchange server and specify it in the configuration files of the message service. For more information about the setup process, contact Creatio technical support at support@creatio.com.

b.Click [Save].

Setting Infinity parameters

These settings should be applied for each Creatio user who received Infinity integration license. Use the user login credentials to access the system.

1.Open the user profile page by clicking the [Profile] image button on the main page of the application.

2.Click the [Call Center parameters setup] button.

3.On the opened page, populate the required values:

a.[Disable Contact Centre integration] – the checkbox allows you to disable Creatio integration with the telephony. The call button will not be displayed on the communication panel of the application.

b.[Infinity server address] – specify application IP address and port. The ports required for implementing the full functionality of Infinity X are available in a separate article.

c.[Line] – specify the telephone number of the line which will be used for the call.

Attention

A separate line is used for each user. It is not recommended to specify the same line for several users, as it may cause errors.

d.[Enable debugging] – this checkbox allows you to display troubleshooting information within the browser console. This troubleshooting information can be used when the phone integration runs into problems and the customer addresses the service team.

4.Click [Save].

5.Refresh the browser page to apply the changes.

See also

Configure WSS connection for the phone service

Software licensing

License distribution

Did you find this information useful?

How can we improve it?