3CX Relay Agent User Guide

1.Introduction #

3CX Relay Agent is a FREE utility that is used exclusively by VoIPTools products to communicate with 3CX either locally or in the cloud.
3CX permits one 3rd party application to communicate with the 3CX server at a time. To overcome this limitation, VoIPTools created the 3CX Relay Service. The Relay is a lightweight application that is installed directly on the 3CX server. The Relay exposes the 3CX Call Control API (and other VoIPTools services) to all our applications, and manages requests and events between by VoIPTools products and 3CX. The Relay also makes it possible to install our VoIPTools products on a remote server (including over the internet).

1.1. What are the Benefits?

1. Offers a streamlined approach to calling the 3CX Call Control APIs.

2. Creates an abstraction layer to insulate VoIPTools products from changes made by 3CX.

3. Allows VoIPTools products to run on a remote server separate from the 3CX server.

4. Enforces a consistent approach to integrating with 3CX.

5. Reduces the time required to develop custom 3CX integrations through code reuse.

6. Encrypts authentication between VoIPTools and 3CX.

1.2. What’s New?
Supports 3CX V14 Multi-Tenant.

1.3. How does it work?

3CX Relay Agent is used in combination with other VoIPTools products. The agent accepts multiple connections from VoIPToys products while making a single connection to 3CX.

1.4. How often should you install it?
If you have already installed the Relay, you need not install it again unless a newer version is required.

2.Prerequisites #

Before installing 3CX Relay Agent, you need to ensure that your computer meets the minimum requirements mentioned below:

1. .Net 4.7.1 or above

2. 3CX Version 12-15.5

3. Windows 7-10 Pro, Windows Server 2008 R2 – 2012 R2

4. Latest version of VoIPToys product

3.Installation #


Download software

You can visit on-line at http://www.voiptools.com and download the free utility from the Download sample link. Most of the VoIPTools products offer you the facility to download the Relay Installer by clicking on the Download Relay button and install directly on 3CX Server by clicking the Install/ Upgrade Relay button.


Install Prerequisites

There are a number of prerequisites that must be installed prior to installing 3CX Relay Agent.

 


Install 3CX Relay Agent

This User Guide contains step-by-step instructions to successfully install 3CX Relay Agent.  Begin by extracting the installer from the downloaded zip file (Step 1 above), then run the setup program named RelaySerivcesInstaller.exe

3.1.Step by step Installation Procedure #

The following section guides you through a detailed walk-through of the installation process.

Step 1: Download 3CX Relay Agent
You can visit on-line at http://www.voiptools.com and download the free utility from the Download sample link. Most of the VoIPTools products offer you the facility to download the Relay Installer by clicking on the Download Relay button and install directly on 3CX Server by clicking the Install/ Upgrade Relay button.

Step 2: Login to 3CX Server
VoIPTools applications interact with 3CX through the VoIPTools 3CX Relay Service. The Relay must be installed on the server where 3CX is installed.

Step 3: Extract the installer from the downloaded .zip file
The file you downloaded in the above step is a compressed .zip file.

1. Position the mouse on the zip file and right-click.

2. From the popup menu, select Extract All to extract the software.

Step 4: Start the installation process

1. From the extracted folder, find the file RelayServicesInstaller.exe

2. Double-click the file to start the VoIPTools Installer.

3. In the Username field, enter VoIPTools Cloud Account username.

4. In the Password field, enter VoIPTools Cloud Account password.

5. If you do not have ‘VoIPTools Cloud Account’ then:

a. Check I don’t have a VoIPTools Cloud Account check box.

b. In the Email field, enter your new VoIPTools Cloud Account.

c. In the First Name field, enter your first name.

d. In the Last Name field, enter your last name.

e. From the Country dropdown, select your country.

f. In the Organization Name field, enter the name of your organization.

g. In the Password field, enter your new password.

h. In the Confirm Password field, confirm your password.

i. Click Register New Account button.


Figure 1: Register New Organization

j. Once the registration of account is successful, confirmation message box appears. Click OK.


Figure 2: VoIPTools Cloud Account – Registration Complete

6. Click Validate Credentials button.


Figure 3: System Validating VoIPTools Cloud Account

7. Once the validation is successful, success message box appears. Click OK.


Figure 4: Success message box

8. Click Next to continue.


Figure 5: Installation in progress

9. When the software installation is complete, click Close.


Figure 6: Installation Complete

4.Support #

If you need support, would like to request an enhancement to 3CX Add-Ons, or are interested in discussing a custom solution, you can contact as at the following:

Address:   2306 Shimmering Bay Lane, Cincinnati, OH 45244-2760

Hours:       Monday – Friday (8:00 A.M. – 6:00 P.M. Central Standard Time)

Phone:      USA: +1 801-642-4655

Skype:       VoIPToys

Email:        info@VoIPTools.com

Web:          http://www.VoIPTools.com

Suggest Edit

Get the Best Solution for your Business

Whether through one of our commercial products, or a custom solution built to meet your specific needs, we can help you get the most out of your 3CX investment. Call us today!

Contact Us