Connecting 3CX

Create an OAuth 2.0 Client

In the CX-Engine application, go to the API Clients menu and click Add Client.

Add an OAuth client

Keep note of the Client ID and Client Secret values — you will need to enter them in 3CX.

Import the CRM Template

From the advanced connector configuration page at CRM Connector > Settings, click the Download XML Template button in the top-right corner of the screen, then select your PBX system and submit.

The filename to be uploaded must not contain spaces or special characters. We recommend keeping the original filename: CXEngine.xml.

Once the CRM template file is on your machine, go to your 3CX instance under Admin > Integrations > CRM.

Upload the file using the Add Template button. Once the template is imported and selected, fill in the following values:

  • Client ID: the Client ID previously generated in the CX-Engine interface
  • Client Secret: the Client Secret previously generated in the CX-Engine interface
  • Account ID: the CX-Engine client ID as shown in the interface, under the Clients section

Save the settings, then click Authorize to authorize the connection in the CX-Engine interface:

Authorize the connection in the CX-Engine interface

After clicking Authorize, you will be automatically redirected to 3CX:

Authorize the connection in the 3CX interface

You can close this window and reload the integrations page in 3CX. Make sure to check the Enable call logging checkbox if applicable.

Integration configuration in 3CX

Important: If you run tests from this page using the test button, remember to click Authorize again to refresh the token before leaving the page. Otherwise, subsequent calls will not work (3CX does not save the fresh token after a test from this interface).