Module ClickToDial

= Introduction = Ce module permet de déclencher une numérotation téléphonique par simple clic sur un numéro de téléphone. Ce module fonctionne avec tout système SIP proposant une interface de ClickToCall via une URL. Le paramétrage avec Asterisk est également possible (Asterisk n'accepte pas d'interface de type URL mais un wrapper dans Dolibarr est fourni pour le faire).

= Installation =

= Configuration =

Avec Asterisk
Voici comment alimenter la page de paramétrage spécifique: http://MONDOLIBARR/asterisk/wrapper.php?caller=__PHONEFROM__&called=__PHONETO__&login=__LOGIN__&password=__PASS__ ASTERISK_HOST avec l'ip de votre serveur asterisk (ex 127.0.0.1) ASTERISK_TYPE avec le protocole géré (ex: SIP/) ASTERISK_INDICATIF avec l'indicatif à saisir pour sortir (ex 0) ASTERISK_PORT avec le port du serveur asterisk (ex: 5038)
 * D'abord, assurez-vous que vous avez un serveur Asterisk qui fonctionne pour le protocole SIP. Cette opération hélas ne relève ni du module ni de Dolibarr, aussi nous ne pouvons que vous orienter sur la documentation Asterisk.
 * Une fois sur, aller dans Configuration - Modules - Configuration ClickToDial et saisissez l'adresse
 * Allez sur la page Configuration - Divers et saisissez les constantes


 * Créez un nouvel utilisateur console sur votre serveur Asterisk ( Fichier /etc/asterisk/manager.conf )

ClickToDial Login : dolibarruser ClickToDial Mot de passe : dolibarrpass ClickToDial Id appelant (téléphone) : votre numero de poste
 * Entrez vos informations Asterisk dans votre fiche utilisateur Dolibarr, onglet ClickToDial

Avec un logiciel SIP (Ekiga ou LinPhone) + Linux + Firefox ou chrome
sip:__PHONETO__@yoursipdomain Par exemple, pour utiliser freephonie, le système SIP system du fournisseur français Free, l'URL doit être sip:__PHONETO__@freephonie.net
 * D'abord, assurez vous que votre logiciel SIP (par exemple Ekiga) est installé et fonctionne correctement (vous pouvez lancer le logiciel, depuis le poste utilisateur ou vous comptez utiliser Dolibarr, et téléphoner avec ce logiciel, indépendamment de Dolibarr).
 * Si oui, loguez vous sous Dolibarr, aller dans la page de configuration du module ClickToDial. Saisissez le champ URL suivant
 * Maintenant, nous devons configurer notre navigateur pour lancer votre logiciel SIP lors d'une saisie ou click sur une URL sip:

Avec Firefox:

- Lancer Firefox

- Entrer about:config dans la barre d'adresse et taper ‘Enter’

- Accepter l'avertissement

- Click droit n'importe ou dans la page et choisir Nouveau –> Booléen dans le menu

- Saisir le nom “network.protocol-handler.expose.sip” sans les guillemets

- Saisir la valeur à “false”

- Fermer la fenêtre about:config (ou l'onglet)

- Recopier le fichier script .sh (fourni avec Dolibarr dans scripts/clicktodial/ekiga.sh ou scripts/clicktodial/linphone.sh selon le logiciel utilisé) dans le répertoire de votre compte utilisateur sur votre PC local (par exemple dans la racine /home/yourlogin.

- Aller sur une page de Dolibarr qui affiche un numéro de téléphone (un tiers ou un contact/adresse par exemple). Cliquer sur le lien sur le numéro. Lorsque demandé, saisir le chemin vers le script shell de lancement du programme client SIP que vous avez copié (/home/yourlogin/ekiga.sh ou /home/yourlogin/linphone.sh

Avec Chrome et Ubuntu:

- Recopier le fichier script .sh (fourni avec Dolibarr dans scripts/clicktodial/ekiga.sh ou scripts/clicktodial/linphone.sh selon le logiciel utilisé) dans le répertoire de votre compte utilisateur sur votre PC local (par exemple dans la racine /home/yourlogin.

- Créer un fichier décrivant l'application SIP à lancer /usr/share/applications/dolibarr_clicktodial.desktop [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; Remplacer le chemin au niveau de Exec= par le chemin et nom de script, recopié à l'étape précédente, qui lance votre logiciel SIP.

- Ajouter une ligne dans le fichier /usr/share/applications/defaults.list pour que l'application soit lancé sur le handler sip. x-scheme-handler/sip=dolibarr_clicktodial.desktop

Votre navigateur devrait maintenant lancer votre logiciel SIP avec l'URL Sip en paramètre, ce qui provoquera la numérotation, lors d'un clic sur un numéro de téléphone. C'est tout.

= Utilisation = A l'issu des étapes précédentes, tout numéro de téléphone dans Dolibarr devient clicable et un clic provoque l'appel de la page/url définie, ce qui provoque la numérotation du numéro de téléphone.