VtigerCRM 5.1.0 Asterisk Integration PDF
VtigerCRM 5.1.0 Asterisk Integration PDF
VtigerCRM 5.1.0 Asterisk Integration PDF
www.vtiger.com
Confidential
Features
The following features are provided:
1. Make calls by clicking on phone numbers (links) within vtiger.
2. Provides notification within vtiger giving details of the caller when a call
comes to the user. Notification appears on the bottom right-corner of the
screen.
3. View all past calls under PBX Manager module (Tools > PBX Manager)
4. Associates the call with the Contact/Account/Lead record in Activity History
section (in the More Information tab).
5. Setup user extension through My Preferences.
Requirements
Configuring Asterisk
You need to have at least one user listed in the manager.conf file present on the
asterisk server (generally found in /etc/asterisk/ folder). The extension would be
added in the following format:
[<EXTENSION>]
secret=<PASSWORD>
deny=0.0.0.0/0.0.0.0
permit=<IP's TO PERMIT>/255.255.255.0
read=system,call,log,verbose,command,agent,user
write=system,call,log,verbose,command,agent,user
where
www.vtiger.com
Confidential
<IP's TO PERMIT> are the list of IP's that you want to be able to access the
extension separated by / (for e.g. 192.168.0.57/192.168.0.58)
Note: Usually the administrator user is already added to this file (manager.conf)
and you may not need to add it.
Configuring vtigerCRM
To configure vtiger with asterisk you will need to do the following:
Login viger as admin user
Go to the Settings page
There you will find the Module Manager link as shown below (in the Studio
section) Click on the link.
Click on the Settings icon next to the PBXManager module (as shown in
image).
www.vtiger.com
Confidential
After this is done all users will have set up their respective Asterisk extensions in
the User Preferences. To do this:
Login as any user and click on the User Preferences link on the top right
of the page (beside the Help link on Top). On the User Preferences page
you will find a block labeled Asterisk Configuration.
You will find two fields here asterisk extension and use asterisk. The
asterisk extension is the extension of the user and the use asterisk field is a
way to enable and disable.
Fill up the asterisk extension for your user here and check the use
asterisk checkbox and save the page.
Now that all user are set and the asterisk configuration
script which will connect to the asterisk server.
cron/modules/PBXManager folder in vtiger installation
and run the script AsteriskClient.php. It is very simple
AsteriskClient.php to execute the file.
www.vtiger.com
Confidential
Note: This script must be kept running to enable the integration as this provides
vTiger with the events from the asterisk server.
After running the script login to vtiger as any user whose extension has
been configured (in user preferences). All the phone numbers in the
vTigerCRM will show up as links in listview and detailview. Clicking on any
of these links will initiate a call as shown below.
A popup notifying the outgoing call is displayed and the call is made. First
the extension saved in User Preferences will start getting a call. Once this
call is picked up, the number clicked in vtiger will be connected to the users'
extension.
In case of incoming call the user gets a popup notifying the caller name (if
the number is present in vTiger) and his link. If the number is not present
in vTiger, then a Unknown Caller message is displayed in the popup and
options are provided to create records (as shown in image below). Clicking
on any of the create links takes to the create view of that module with the
phone fields automatically filled up with the incoming call number.
www.vtiger.com
Confidential
It is possible to save the number (in vTiger) in any format (with or without
extensions like SIP, PSTN etc.) and create the call. vTiger should recognize the
caller in case of incoming call as long as there is a separator : between the
prefix and the number i.e. like SIP:211.
It is recommended not to use any special chars or spaces in the phone number
field.
www.vtiger.com
Confidential