Introduction
This module allows you to trigger a phone call with a simple mouse click on a phone number in Werpos. This module is designed to work with:
Any SIP server with an URL interface for the ClickToCall
or with Asterisk (Asterisk is a server that does not provide such URL but a wrapper is included in Werpos to provide such service)
or with local software able to manage “tel:” urls from web browsers clicks
or with a locally installed softphone (like LinPhone).
Installation
This module is included with the Werpos 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 an icon appears at end of the line for the module, click on it to access the setup page specific to the module.
Solutions with no need to install client components
With Asterisk
This is how to fill the specific setup for Asterisk:
- First, make sure you have an Asterisk server that works for SIP. This unfortunately is not relevant to module or Werpos, so we can only refer you to the Asterisk documentation.
- Once you are sure, go into Werpos, into Setup – Module – ClickToDial setup and add Url
http://MYWERPOS/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)
ASTERISK_CONTEXT with context of call (ex: from-internal)
CLICKTODIAL_FORCENEWTARGET with value 0 or 1. If this value is set to 0 or not defined, then calling will open a new window/tab in the browser.
- Create a new console user on your Asterisk server ( File /etc/asterisk/manager.conf )
[Werposuser]
secret = Werpospass
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
#read = system,call,log,verbose,command,agent,user,config,dtmf,reporting,cdr,dialplan
write = system,call,log,verbose,command,agent,user,originate
#write = system,call,log,verbose,command,agent,user,originate,reporting
permit must contains IP viewed by Asterisk where Werpos is installed.
- You may also need to edit file /etc/asterisk/extension.conf to define contact from-internal.
[from-internal]
exten => _00XX.,1,NoOp(Call Werpos)
same => n,Dial(SIP/providervoip/${EXTEN},30)
same => n,hangup
Change providervoip with SIP provider.
Validate change with
asterisk -rvvvvvvvvvvvvvvvvvv
CLI> manager reload
CLI> dialplan reload
- Enter Asterisk informations on your Werpos user card, tab ClickToDial
ClickToDial Login : Werposuser (use same entry than added into manager.conf file)
ClickToDial Password : Werpospass (use same pass than added into manager.conf file)
ClickToDial Id caller (phone) : your phone
Using the phoning service of OVH
See page of Module OVH (SMS, ClickToDial, …) required for that.
Solutions with client component installation
With with local software able to manage “tel:” url
If you have installe software able to manage link with syntax “tel:” from a web browser click (for example, the *Xivo client*), from Werpos 3.9, just go on the clicktodial setup page and set option *Use just a link “tel:” on phone numbers* to Yes. That’s all.
With SIP phone software (Ekiga or LinPhone) + Linux + Firefox or Chrome
- First, be sure, a SIP software (like Ekiga or Linphone) is installed and working correctly (you can phone using it) without using Werpos.
- Once this is done, login to Werpos, 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
– 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 Werpos 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 Werpos 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/Werpos_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=Werpos_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 Werpos screens are now links you can click. If you do so, Werpos will call the defined page/URL, that should make the calling