For each of the PBX systems (Asterisk, Elastix, or Avaya Aura® AES), you need to download the corresponding adapter and integrate it with Zoho Desk. This document gives you information about the following:
- System requirements
- Prerequisites before you start the installation process
- Installation procedure for Asterisk, Elastix, and Avaya Aura® AES
System Requirements
- A Linux Operating System. Both your Operating System and your PBX system must be running on the same local network.
- JDK 1.8.x must be installed in the system in which you will be installing the Zoho PhoneBridge Adapter.
As the Asterisk and the Elastix PBX is a Linux box, you can install our PhoneBridge adapter in the PBX itself and configure the PBX IP address as 127.0.0.1 in the adapter.
Prerequisites
You must have the following to complete the installation process:
- Administrator privileges
- Zoho PhoneBridge adapter for your PBX system
- Authorization key
- PBX details
Downloading Zoho PhoneBridge Adapter You are required to download a Zoho PhoneBridge adapter to use the Zoho PhoneBridge feature.
To download the adapter:
- Click the Setup icon ( ) in the top bar.
- In the Setup Landing page, click Phone under Channels.
- Select a PBX system you want to install on the Telephony page.
- In the PBX system page, click Enable.
Next, you will be taken to the Configuration tab of the PBX system. - Under the Configuration tab, click Download PhoneBridge Adapter.
The installation procedure differs for each type of PBX system. You must download a separate adapter for each of the PBX systems that you own.
PBX Details
This section provides information about the PBX properties file for the Asterix (teleadapters/asterisk/conf/asterisk.properties) and Elastix (teleadapters/elastix/conf/elastix.properties) PBX systems:
- asterisk.manager.server: IP address of the PBX system
- asterisk.manager.username: Asterisk manager's username
- asterisk.manager.password: Asterisk manager's password
Avaya Aura® AES (teleadapters/avaya/conf/avaya.properties) PBX system:
- avaya.server: IP address of the PBX system
- avaya.manager.username: Avaya Aura® AES manager's username
- avaya.manager.password: Avaya Aura® AES manager's password
Installing Zoho PhoneBridge for Asterisk
To install Zoho PhoneBridge for Asterisk PBX systems:
- Download the Zoho PhoneBridge Adapter for Asterisk.
- Extract the .zip file and save it in the machine that you want to run the Asterisk adapter.
This system should be able to communicate easily with your Asterisk PBX system. - Edit the "Zoho/ztiadapter/conf/zti.properties" file and configure the Authorization Key along with your Zoho Desk Portal name.
- Edit the "Zoho/ztiadapter/teleadapters/asterisk/conf/asterisk.properties" file and configure the PBX details.
- Run the nohup sh run.sh & command inside the zoho/ztiadapter/bin directory.
Your Zoho PhoneBridge service for Asterisk will be started.
Installing Zoho PhoneBridge for Elastix
To install Zoho PhoneBridge for Elastix PBX systems:
- Download the Zoho PhoneBridge Adapter for Elastix.
- Extract the .zip file and save it in the machine that you want to run the Elastix adapter.
This system should be able to communicate easily with your Elastix PBX system. - Edit the "Zoho/ztiadapter/conf/zti.properties" file and configure the Authorization Key along with your Zoho Desk Portal name.
- Edit the "Zoho/ztiadapter/teleadapters/elastix/conf/elastix.properties" file and configure the PBX details.
- Run the nohup sh run.sh & command inside the zoho/ztiadapter/bin directory.
Your Zoho PhoneBridge service for Elastix will be started.
Installing Zoho PhoneBridge for Avaya Aura® AES
To install Zoho PhoneBridge for Avaya Aura® AES PBX systems:
- Download the Zoho PhoneBridge Adapter for Avaya Aura® AES.
- Extract the .zip file and save it in the machine that you want to run the Avaya Aura® AES adapter.
This system should be able to communicate easily with your Avaya Aura® AES PBX system. - Edit the "Zoho/ztiadapter/conf/zti.properties" file and configure the Authorization Key along with your Zoho Desk Portal name.
- Edit the "Zoho/ztiadapter/teleadapters/avaya/conf/avaya.properties" file and configure the PBX details.
- Download jtapi-sdk.zip file from the Avaya website here.
Note: You must be logged in to Avaya DevConnect to download the file. - Extract this zip file and copy jtapi-sdk/lib/ecsjtapia.jar file to "Zoho/ztiadapter/teleadapters/avaya/lib/" folder.
- Run the nohup sh run.sh & command inside the zoho/ztiadapter/bin directory.
Your Zoho PhoneBridge service for Avaya Aura® AES will be started.
ResourcesYou can download the required adapter from the following links to integrate your PBX system with Zoho Desk.