Module ClickToDial En

= 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 =

= Configuration =

With Asterisk
This is how to fill the specific setup for Asterisk: http://MYDOLIBARR/asterisk/wrapper.php?caller=__PHONEFROM__&called=__PHONETO__&login=__LOGIN__&password=__PASS__ 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) permit must contains IP viewed by Asterisk where Dolibarr is installed. Change providervoip with SIP provider.
 * First, make sure you have an Asterisk server that works for SIP. This unfortunately is not relevant to module or Dolibarr, so we can only refer you to the Asterisk documentation.
 * Once you are sure, go into Dolibarr, into Setup - Module - ClickToDial setup and add Url
 * Go on page Setup - Other and add constants
 * Create a new console user on your Asterisk server ( File /etc/asterisk/manager.conf )
 * You may also need to edit file /etc/asterisk/extension.conf to define contact from-internal.

Validate change with

ClickToDial Login : dolibarruser (use same entry than added into manager.conf file) ClickToDial Password : dolibarrpass (use same pass than added into manager.conf file) ClickToDial Id caller (phone) : your phone
 * Enter Asterisk informations on your Dolibarr user card, tab ClickToDial

With a SIP softare (Ekiga or LinPhone) + Linux + Firefox or Chrome
sip:__PHONETO__@yoursipdomain For example, when using freephonie, the SIP system of the french ISP Free, URL would be sip:__PHONETO__@freephonie.net
 * First, be sure, a SIP software (like Ekiga or Linphone) is installed and working correctly (you can phone using it) without using Dolibarr.
 * Once this is done, login to Dolibarr, go into ClickToDial module setup page. Into URL field, type
 * Now, we have to setup our browser to launch our sip software when clicking onto a "sip:" URL:

With Firefox

- Launch Firefox

- Type about:config in the address bar and press ‘Enter’

- Accept the warning

- Right click somewhere on the page and select New –> Boolean from the menu

- Set the name to “network.protocol-handler.expose.sip” without the quotes

- Set the value to “false”

- Close the about:config window (or tab)

- Copy launcher script file .sh (provided with dolibarr into scripts/clicktodial/ekiga.sh or scripts/clicktodial/linphone.sh with linphone) into your home directory. For example into /home/yourlogin

- 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 you have copied previously (so /home/yourlogin/ekiga.sh or /home/yourlogin/linphone.sh).

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

With Chrome and Ubuntu

- Copy launcher script file .sh (provided with dolibarr into scripts/clicktodial/ekiga.sh for Ekiga or scripts/clicktodial/linphone.sh for Linphone) into your home directory. For example into /home/yourlogin

- 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=/home/yourlogin/linphone.sh %U Icon=/usr/share/pixmaps/linphone/linphone.png Terminal=false Categories=Network;Telephony; Replace path into line Exec= with the path and name of 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

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

= 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.