Installation procedure consists of following steps:
Install widget from Zoho Marketplace
Install the server part on your Asterisk server
Configure connection settings
Configure your business logic and preferences
If you don’t feel like wasting time on instructions or they didn’t help, contact our support. We will quickly help you set everything up and answer all questions!
Contact us in any convenient way:
Online chat - quick and easy, there are no bots, only live people
E-mail: [email protected]
Working hours: Mon-Fri 08:00 - 17:00 Moscow Time (UTC+3).
To be filled...
Asterisk server is the best place to install connector according to the requirements. If it’s not possible to install connector to the Asterisk server, then you can install it on another server that fits technical requirements.
ssh ipasterisk -l root
ipasterisk is the IP-address of your Asterisk server. Then enter your password.
Enter new login for admin panel: adminEnter new password for admin panel: admin
You can change this later in the config file:
/etc/itgrix_zh/config.json. (‘Webserver’ section)
After installing, you will see a link to your admin panel. Copy the link and paste it into the address bar in a browser for redirecting to Setup wizard (link is like on picture).
We recommend doing further configuration using setup master in Bitrix24 interface:
<ipasterisk> - IP-address of your asterisk server.
*Itgrix has its own web-server, and self-signed SSL certificate. Allow your browser to connect to this web-server.
Input the login and password, which you created during app installation.
1. Database connection. The master will find DB credentials. Also, it will check availability of CEL and CDR tables.
If credentials were not found, you can get it from
You can create new MySQL-user if you want. This user will need read and write permissions for CEL and CDR tables.
2. Asterisk connection. Choose an existing user or create new. The connector will be sending request to AMI using this user.
If the connector was installed on the other server (not Asterisk), then create a user manually:
1. Change file
secret = asterisksecret (create your own)
deny = 0.0.0.0/0.0.0.0
permit = 127.0.0.1/255.255.255.0
read = cdr,reporting,originate
write = reporting,originate
2. Reload asterisk manager:
asterisk -rx 'manager reload’
3. Enter credentials in the admin panel:
3. Zoho connection. Copy your portal ID and paste at first input field.
You can find it in the browser address bar on the main page of your CRM (address will look like
Press the Save button.
Choose your data center. The CRM Administrator has set it earlier when registering the CRM. Most likely it matches your location. Skip this step for now if you're unsure what to choose. Press Get code.
Zoho Authentication page will open. You may need to log innto your Zoho account at this step. Choose the CRM, review the access permissions for the connector and accept the authentication.
You will see the authentication code. Copy it. Mind that it will only be valid for one minute.
If you need to check what's your data center, look in the page URL in the address bar. It will have a part looking like
location=us, this is your data center.
Return to the admin panel (choose data center if you didn't do it earlier), paste the code that you just got in the Auth code field and click Check.
You will see a status check that will show you if authentication succeeded or if there were any problems.
4. Results page will show you the statuses of configured connections.
Click Finish and you will be redirected to business logic settings page.
To save settings press ‘Save’ button on every changed page.
Use our test procedure for testing your connection.
Contact us in case you have questions.