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.

Tags: , ,

  • L’idée est sympa mais ça passe nécessairement par une api, c’est certain. Cela serait plutôt pas mal si des groupes comme Free, Neuf/SFR et autres permettaient ce service…. même si en bidouillant on doit bien finir par trouver quelque chose puisque ça reste de la voip.

  • Il faudrait un truc très simple pour faire ça .. une façon de passer le paramètre du numéro à appeler à la box .

    Le souci c’est que ça ouvre la voie à une sorte de spam par lien .. :D imagine tu cliques par erreur sur un tél surtaxé :p

  • On peut toujours imaginer une confirmation avant d’appeler ;-) Ça ma un peu étonné d’ailleurs que ça ne soit pas le cas avec toi ici, juste une petite fenêtre qui demande « vous êtes sûr? ». ^_^

    Après pour les box c’est pas indispensable, mais l’avantage serait d’utiliser le Carnet d’Adresse du mac par exemple, avec lequel on trouvera plus rapidement un numéro. (sans compter le problème des écrans de téléphone pas toujours rétro-éclairés =P)

    Il doit y avoir un moyen de le faire mais forcément, ça ne passe pas par la conduite officielle des opérateur (rien dans leur condition = interdit?).

  • Régis – Compad.fr

    Hello :) je me prends la tête depuis quelques semaines pour implémenter ça et j’ai réussi hier soir. grâce entre autres à un script trouvé sur le forum ovh. Pour la gestion multi utilisateurs, il suffit de récupérer les variables (login etc) passées par Dolibarr.
    Regarde là :
    http://forums.ovh.net/showthread.php?t=54519
    le même script que toi, mais avec les gestion des utilisateurs !
    Je vais pouvoir enfin proposer une solution d’ERP/CRM complète à mes clients.

  • Bonjour,

    intéressant ton petit script,
    on va regarder pour l’intégrer en standard avec le multi-user et la sécurité qui va avec

    merci :-)

    Régis Houssin

  • Hey Régis, en effet je vois, c’est plus ou moins la même chose que ce que j’utilise. Bon perso je suis single user sur mon installation Dolibarr mais c’est vrai que pour un groupe c’est le top.

    Je crois avoir compris que tu cherchais à développer la suite de ce « CTI » pour que quand un appel « entre » sur la ligne OVH , la fiche de l’appelant apparaisse sur l’ordi… Tu as une piste pour ça ? J’aimerai tellement faire pareil. Un beau système bien huilé qui reconnaît un contact existant ou te permet d’en saisir un nouveau

  • en standard? Tu veux dire direct dans les prochaines versions de Dolibarr ? ça serait top !

  • bah en fait sur mon propre système c’est entièrement fermé par login password + captcha donc il n’y a pas de risque d’appel passé par un autre

    Quand je passe un appel depuis mon mac ( http://www.youtube.com/watch?v=ZMn_goFj1Y0 ) et non pas depuis Dolibarr , il me demande confirmation ;)

  • Eddddd

    tous les outils doivent être là:
    http://www.ovh.com/soapi/fr/?group=telephony

    le problème c’est que je ne suis pas très bricoleur ;-)

  • chazawa

    Bonjour j’ai besoin de votre aide, je viens d’acheter un Thomson ST2030 et je l’ai connecté au réseau pour la configuration, et j’ai manipuler l’appareil à partir de touche afin de voir l’adresse IP. Tout passe tres bien, en voulant faire la mise à jour de firmware manuellement, j’ai du téléchargé ST2030_SG_v2[1].67_Release_package , puis je upload le 1er fichier v2030SG.R11.1.090305.2.67.2 dans
    Firmware Update, l’appereil a redemarré normalement et le 2nd fichier je me suis trompé et je l’upload dans toujours
    Firmware Update, puis le 3e fichier, au 3eme demarrage du téléphone, l’ecran reste bloqué et affiche Thomson. et le voyant à droit clignote depuis. j’ai cliqué restauration par defaut » Restor Defaut » toujours sa donne rien, j’ai besoin de votre aide. SI jamais quelqu’un a eu le meme probleme svp!