Installing Asterisk or Elastix Telephony System in Zoho Desk

Installing Asterisk or Elastix Telephony System in Zoho Desk

For each of the PBX systems (Asterisk or Elastix), 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 1.4 and Elastix 1.6

System Requirements
  • A Linux Operating System. Both, your Operating System and your PBX system must be running on the same local network.
  • JDK 1.6.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:
  1. Click the Setup icon (  ) in the top bar.
  2. In the Setup Landing page, click Phone under Channels.
  3. Select a PBX system you want to install on the Phone page.
  4. In the PBX System page, 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/asterisk14/conf/asterisk14.properties) and Elastix(teleadapters/elastix16/conf/elastix16.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

Installing Zoho PhoneBridge for Asterisk 1.4
To install Zoho PhoneBridge for Asterisk PBX systems:
  1. Download the Zoho PhoneBridge Adapter for Asterisk 1.4.
  2. Extract the .zip file and save it in the machine that you want to run the PBX adapter.
    This system should be able to communicate easily with your PBX system.
  3. Edit the "Zoho/ztiadapter/conf/zti.properties" file and configure the Authorization Key along with your Zoho Desk Portal name. 
  4. Edit the "Zoho/ztiadapter/teleadapters/asterisk14/conf/asterisk14.properties" file and configure the PBXdetails.
  5. 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 1.6
To install Zoho PhoneBridge for Elastix PBX systems:
  1. Download the Zoho PhoneBridge Adapter for Elastix 1.6.
  2. Extract the .zip file and save it in the machine that you want to run the PBX adapter.
    This system should be able to communicate easily with your PBX system.
  3. Edit the "Zoho/ztiadapter/conf/zti.properties" file and configure the Authorization Key. 
  4. Edit the "Zoho/ztiadapter/teleadapters/elastix16/conf/elastix16.properties" file and configure the PBX details.
  5. Run the nohup sh run.sh & command inside the zoho/ztiadapter/bin directory.
    Your Zoho PhoneBridge service for Elastix will be started.
Resources
You can download the required adapter from the following links to integrate your PBX system with Zoho Desk.