After going through Official configuration guide then I realise that there should be one step by step guide with snapshots for newcomers or who are not familiar with Asterisk PBX and Linux.
I tried to make this step by step very simple and more understandable for all, so please give me any suggestion from your side to make this documentation better.
I have separated configuration parts in different steps.
1) Scenario with Network Diagram.
2) Required Software’s.
3) Vtiger Side Configuration.
4) Asterisk Side Configuration.
5) Troubleshooting.
Vtiger Server:
Windows 7 32 bit , Dual Core CPU , 4 GB RAM , 40 GB HDD.
Vtiger 6.1
Zoiper SIP Soft Client with 2009 Extension Configured.
Asterisk Server:
Dual Core CPU , 4 GB RAM , 40 GB HDD
AsteriskNOW 5.211.65 (User Any Asterisk Based PBX like FreePBX , Elastix etc..)
Java Jetty Installed.
Note : this scenario has been developed in Virtual Environment ( Vmware Workstation 10 ) in my case.
Configure your Asterisk credentials in Vtiger
After installing Vtiger Asterisk Connector, please follow few simple steps to configure your Asterisk Server information in Vtiger CRM :
1. Login to your CRM instance and click on
icon on the top right corner of the CRM.
2. Click CRM Settings.
3. Click PBX Manager under Integration in Settings sidebar.
4. Edit Asterisk Server Details.
Vtiger Asterisk App URL - configure server name where Vtiger Asterisk Connector is installed as shown:
Syntax : Protocol://Asterisk_Server_IP:Port
Protocol
|
http/https
|
Asterisk_Server_IP
|
Your Asterisk Server IP
|
Port
|
Server Port configured in Vtiger Asterisk Connector config file.
|
Outbound Context - Vtiger specific context configured in your Asterisk Server
Outbound Trunk - Trunk configured in your Asterisk server for Outgoing Calls.
Vtiger Secret Key - Unique key generated for authentication, which has to be configured in Vtiger Asterisk Connector.
5. Click Save button.
Note : in my case I am not using any trunk for Outgoing Calls, I just want to test internal Calls only in my LAB. So please Add your Outbound trunk Name which is configured inAsterisk GUI -> Connectivity -> Trunks. ( Name is Case Sensitive so be careful ).
Configure the extension number for each user
For each user who is allowed to handle incoming and outgoing calls from the CRM, the extension number should be configured in the User preferences page.
1. Open My Preferences.
2. Configure user number in CRM Phone Extension field under “More Information” block.
Number format:
Extension: [Extension_number]
e.g., 2001
Once configuration is completed on both sides i.e., Vtiger and Asterisk, you are now ready to make and receive calls in the CRM.
Vtiger Asterisk Connector Installation on Asterisk Server
Introduction
Vtiger Asterisk application acts a gateway to connect to Vtiger CRM from the Asterisk Server. It makes it easy for Vtiger and Asterisk interaction over HTTP when incoming or outgoing calls need to be handled.
Features
Vtiger Asterisk Connector provides following features:
1. Connect to Vtiger and notify the incoming call.
2. Accept commands from Vtiger and forward it to Asterisk (Click-to-Call).
3. Call recording file management.
Installation.
1.
Download Asterisk Connector ( PBXMagager )Add-on from Official Website.
2.
Download
WinSCP and connect to Asterisk server .
3. Transfer VtigerAsteriskConnector-1.2.zip to root folder ( / ).
4.
Login to Asterisk Server by using
putty.exe or
ssh terminal and unzip VtigerAsteriskConnector with “
unzip VtigerAsteriskConnector-x.y.zip” Command.
5. Open /VtigerAsteriskConnector/conf/ VtigerAsteriskConnector.properties and update information as below.
6. Copy and Paste the Vtiger Secret Key that is generated in your Vtiger Instance.
You can find this under Vtiger CRM > Settings > Integration > PBXManager > Asterisk Server Details.
7. Copy Vtiger URL exact the same because it is case sensitive so better to copy and paste from web browser.
8. Cd /VtigerAsteriskConnector/Bin
9. ./Start.sh
11. If you find above result then you are ready with VtigerAsteriskConnector Configuration.
Asterisk Configuration File Changes
1) Change In extensions.conf ( /etc/Asterisk/extensions_custom.conf )
Create Vtiger SIP Extension
1) Open Asterisk GUI -> Applications -> Extensions.
2) Create SIP Extensions.
Configure Asterisk Manager User
1) Open Asterisk GUI -> Settings -> Asterisk Manager Users
2) Create “vtiger” User with ALL Permission.
3) Make 0.0.0.0 / 0.0.0.0 in Deny Entry.
4) Permit127.0.0.1/255.255.255.0&192.168.1.0/255.255.255.0&192.168.1.94/255.255.255.255
5) Click on Submit.
Check /etc/Asterisk/manager_additional.conf
Add VtigerAsteriskConnector Script in to startup.
1) Open Asterisk server terminal and give below command.
2) Echo sh /VtigerAsteriskConnector/bin/start.sh >> /etc/rc.local
Troubleshooting
1) Monitor Logs in /VtigerAsteriskConnector/Logs
a. nohup.webapp.<date>.out
b. nohup.agi.<date>.out
2) Start or restart VtigerAsteriskConnector Scripts /VtigerAsteriskConnector/bin/
a. Start.sh
b. Stop.sh
c. Agi.sh
d. Webapp.sh
