Module ClickToDial En

Return to user
documentation index

Return to
list of modules index

Asterisk
Numero/ID of module	58
User doc. of module	This page
Developer doc. of module	Module ClickTodial (developer)

Introduction

This module allows you to trigger a phone call with a simple mouse click on a phone number in Dolibarr. Any SIP server with an URL interface for the ClickToCall can be used. There is also information for setup with Asterisk.

Installation

This module is included with the Dolibarr distribution, so there is no need to install it.

Configuration

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

With Asterisk

This is how to fill the specific setup for Asterisk:

• Add Url

http://MYDOLIBARR/asterisk/wrapper.php?caller=__PHONEFROM__&called=__PHONETO__&login=__LOGIN__&password=__PASS__

• Go on page Setup - Other and add constants

ASTERISK_HOST with IP of your asterisk server (ie: 127.0.0.1)
ASTERISK_TYPE with managed protocol (ie: SIP/)
ASTERISK_INDICATIF with prefix to add in phone number (ie: 0 or NONE)
ASTERISK_PORT with port of Asterisk sever (ie: 5038)

• Create a new console user on your Asterisk server ( File /etc/asterisk/manager.conf )

[dolibarruser]
secret = dolibarrpass
deny=0.0.0.0/0.0.0.0
permit=127.0.0.1/255.255.255.0
read = system,call,log,verbose,command,agent,user
write = system,call,log,verbose,command,agent,user,originate

• Enter Asterisk informations on your Dolibarr user card, tab ClickToDial

ClickToDial Login : dolibarruser
ClickToDial Password : dolibarrpass
ClickToDial Id caller (phone) : your phone

With a SIP softare (Ekiga), Linux and Firefox

• First, be sure, a SIP software (like Ekiga) is installed and working correctly (you can phone using it).
• Then, login to Dolibarr, go into ClickToDial module setup page. Into URL field, type

sip:__PHONETO__@yoursipdomain

For example, when using freephonie, the SIP system of the french ISP Free, URL would be

sip:__PHONETO__@freephonie.net

• Now, we have to setup our browser to launch our sip software when clicking onto a "sip:" URL:

With Firefox

1. Launch Firefox
2. Type about:config in the address bar and press ‘Enter’
3. Accept the warning
4. Right click somewhere on the page and select New –> Boolean from the menu
5. Set the name to “network.protocol-handler.expose.sip” without the quotes
6. Set the value to “false”
7. Close the about:config window (or tab)
8. Go on a card with a phone number (a third party or contact page for example). Click on phone link. When prompted, select the path to the launch script to run your SIP software (With Ekiga, you can set here path of script provided with Dolibarr 3.3+: yourdolibarrpath/scripts/clicktodial/ekiga.sh).

Your browser should launch your SIP software and dial the number provided into URI each tie you click on a phone number. That’s it!

With Chrome and Ubuntu

Create a file /usr/share/applications/dolibarr_clicktodial.desktop to describe the SIP software to launch

[Desktop Entry]
Name=SIP phone
Comment=SIP phone
Type=Application
Exec=/pathtodolibarr/scripts/clicktodial/linphone.sh %U
Icon=/usr/share/pixmaps/linphone/linphone.png
Terminal=false
Categories=Network;Telephony;

Replace path into line Exec= with your script or your SIP software.

Add a ligne into file /usr/share/applications/defaults.list to tell to use this descriptor when we need to handle SIP urls.

x-scheme-handler/sip=dolibarr_clicktodial.desktop

Usage

Once setup is finished, all phone number in Dolibarr screens are now links you can click. If you do so, Dolibarr will call the defined page/URL, that should make the calling.