Utiliser Dolibarr et le Click2Call d’OVH

Dolibarr est un ERP/CRM très pratique, assez complet et surtout gratuit & open source. Si vous utilisez la VoIP (voix sur IP) d’OVH et – par exemple dans mon cas – un téléphone comme le Thomson ST2030 .. vous avez peut être envie de rendre les numéros de téléphone cliquables directement depuis Dolibarr. Cela utilise la fonction Click2Call et c’est pas trop dur à mettre en place…

Si vous avez un Dolibarr installé quelque part, sachez qu’il contient un module dédié au Click to call donc une partie du travail est mâchée.

Allez on commence!

Alors dans l’ordre on va activer ce module. pour cela … Accueil > Configuration -> Modules -> Modules interfaces

Vous allez lire une ligne : ClickToDial -Intégration d’un système de ClickToDial (Asterisk,…) .. donc là zou on clique sur le petit bouton ON tout à droite et il devient vert. Ensuite on clique sur le petit ordinateur à sa droite qui veut dire configurer (oui je sais … ça n’a pas de sens mais bon).

Là Dolibarr vous explique ceci :

Ce module permet d’ajouter un petit picto à côté des numéros de téléphones. Un clic sur ce picto provoque l’appel de l’URL définie dans ce paramétrage. Ceci permet de provoquer des appels à un serveur de téléphonie depuis Dolibarr qui peut alors composer le numéro sur un system SIP par exemple.

Il vous propose en dessous de configurer la chose. Je vais faire la méthode flemmard / scénario « je suis le seul utilisateur ».

Créer un petit script PHP puis battre les oeufs

Mettons que mon installation Dolibarr est hébergée sur http://dolibarr.mondomaine.com . On va créer un fichier PHP qui va contenir les informations nécessaires à la fonction Click2Call d’OVH.

Appelons le .. appel.php

Dans ce fichier on va mettre un petit peu de code (pour plus de détails c’est expliqué dans la doc SoAPI d’OVH ici).

Je vous mets le code PHP ci-dessous puis après on l’étudie rapidement :

<?php
$telephone = $_GET["telephone"];
echo 'Number ' .$telephone. '<br>';
try {
 $soap = new SoapClient("https://www.ovh.com/soapi/soapi-re-1.14.wsdl");

 //telephonyClick2CallDo
 $soap->telephonyClick2CallDo("login", "password", "montel",$telephone, "montel");
 echo "telephonyClick2CallDo successfull\n";
echo "<script type='text/javascript'>history.back();</script>"; // l'appel passe donc je te renvoie vers Dolibarr
} catch(SoapFault $fault) {
 echo $fault;
}
?>

Ci-dessus je n’ai fait que reproduire le code donné par OVH comme exemple en y intégrant le paramètre « telephone » .. c’est via ce dernier que je vais spécifier à mon script qu’il doit lancer l’appel en ouvrant par exemple appel.php?telephone=+3312345678

Dans le script vous allez avoir trois choses à préciser : votre numéro de téléphone à la place de « montel » et le login et mot de passe permettant l’accès à l’API. Pour obtenir ces deux derniers, rendez vous sur votre Manager OVH , puis cliquez sur Téléphonie. Une fois la ligne de votre choix sélectionnée, choisissez dans le menu ceci :

Cliquez sur l’image elle va grandir

Là vous sélectionnez « Modifier » dans la partie Click2Call et créez un identifiant / mot de passe de votre choix. Notez le quand même sinon ça marche moins bien …

Une fois que c’est créé vous mettez ça dans votre script et vous enregistrez ça à la racine de votre Dolibarr par exemple .. Il sera donc là http://dolibarr.mondomaine.com/appel.php et si je veux appeler quelqu’un .. je dois ouvrir http://dolibarr.mondomaine.com/appel.php?telephone=+3312030405

On retourne sur Dolibarr

Maintenant retournez sur Dolibarr, dans la configuration de votre module Click to Dial.

On va enfin pouvoir entrer l’url comme paramètre. Si vous avez bien suivi il faut mettre ceci :
http://dolibarr.mondomaine.com/appel.php?telephone=%1$s

Adaptez à votre domaine et zou à vous la belle vie. Cela ressemble à .. :

Illustré .. la façon dont ça marche en vidéo :

A noter que pour adapter ce mini script tout bête à un Dolibarr multi utilisateur, il suffit de lui rajouter la gestion des paramètres (via URL) du login clicktodial ainsi que du mot de passe et du numéro appelant. C’est décrit dans la page du module :

Url appelée lors dun clic sur le picto téléphone. Dans l’url, vous pouvez utiliser les balises
%1$s qui sera remplacé par le téléphone de l’appelé
%2$s qui sera remplacé par le téléphone de l’appelant (le votre, défini sur votre fiche utilisateur)
%3$s qui sera remplacé par votre login clicktodial (défini sur votre fiche utilisateur)
%4$s qui sera remplacé par votre mot de passe clicktodial (défini sur votre fiche utilisateur).
Exemple: http://myphoneserver/mypage?login=%3$s&password=%4$s&caller=%2$s&called=%1$

Si quelqu’un se dévoue pour faire la version multi utilisateurs (j’ai la flemme) pas de soucis pour la republier ici avec les crédits qui vont bien !

Have fun et merci OVH ! Prochaine étape ça serait le CTI (couplage téléphonie-informatique) qui fait que quand on m’appelle , mon ordinateur m’affiche la fiche contact de l’appelant mais je ne sais pas du tout si dans l’état actuel des choses.. c’est envisageable ou non?

Aussi une idée pour quiconque sait bien développer : améliorer ce module pour qu’un appel soit automatiquement enregistré en tant qu’action dans Dolibarr .. comme ça j’ai un historique de mes appels.