Recherche


imprimer pdf
Comment mettre en place l'appel en un clic le Click2Call?

Principe de fonctionnement


Le Click2Call? est un système permettant via un bouton (habituellement au sein d'un site internet) de mettre en relation le visiteur de votre site et l'un de vos collaborateurs.
Avec les offres OVH, vous avez la possibilité via le Soapi de mettre en place un système de Click2Call?.


Mise en place


La mise en place s'effectue en deux étapes : la création de compte, puis la mise en place du Click2Call?.

OVH fournit une API pour permettre de passer des appels sans toucher au téléphone ! Dans un premier temps, vous devrez vous créer des identifiants afin d'autoriser une application ou une personne d'effectuer des appels sur votre compte de téléphonie.

Création d'identifiant

Vous pouvez au choix créer un identifiant via la commande SOAPI telephonyClick2CallUserAdd ou via votre manager :

Vous devez dans un premier temps accéder à votre Manager OVH. Vous retrouvez le bouton suivant sur la page d'accueil du site ovh.com



Cliquez sur l'icône Téléphonie



Sélectionnez la ligne à partir de laquelle vous souhaitez mettre en place le click2call puis l'onglet Appeler en un clic



Cliquez sur Modifier



Entrez un login et un mot de passe



L'identifiant que vous venez de créer est maintenant affiché. Vous pouvez maintenant saisir votre numéro et cliquer sur Appel pour tester le service.

Note :
Si rien ne se passe, assurez-vous que votre ligne Sip peut recevoir et faire des appels classiquement. Si vous utilisez un Siemens et que le click2call ne donne rien, nous vous invitons à faire vos tests en configurant votre ligne Sip sur un SoftPhone? (exemple : via Zoiper). Pendant ce test, il ne faudra pas que votre Siemens soit connecté. Si le test est concluant via le SoftPhone? mais pas via le Siemens, c'est que le Firmware de votre téléphone pose souci, nous allons voir plus bas une astuce pour contourner ce problème.



Intégrer l'API SOAPI OVH

Dans l'interface click2call, vous cliquez sur le lien API SOAPI OVH qui vous renvoi vers http://www.ovh.com/soapi/fr/?method=telephonyClick2CallDo.
Vous entrez l'identifiant que vous vous êtes crée précédemment, ainsi que le mot de passe et le numéro de téléphone depuis lequel vous allez rappeler les clients puis cliquez sur lancer le générateur de script.

Exemple pratique d'un click to call

Dans notre exemple nous allons mettre en place un fichier en html pour le formulaire demandant le numéro et un fichier nommé dans cet exemple click.php en php 5 pour le Click2Call?. Ces fichiers devront être déposés sur un hébergement compatible PHP5 et SOAPI (Les hébergement mutualisés OVH sont compatibles sauf l'offre 20gp, et start1m)

La page html :




Entrer le numero a faire appeler :

<form action="click.php" method="post">

<input type="text" name="num" /> <input type="submit" value="Appeler" />

</form>


La page en PHP qui a été générée via la page de la documentation soapi telephonyClick2CallDo:

click.php :


<?php

$identifiant=""; //identifiant créé via le Manager
$mot_de_passe=""; //mot de passe de l'identifiant créé via le Manager
$votre_ligne_qui_appel=""; //normalement, c'est le numéro de votre ligne click2call
$ligne_a_appeler=$_POST["num"]; //on récupère la valeur (numéro) renseigné dans le formulaire de la page html
$votre_ligne=""; //votre numéro de ligne sur lequel vous avez mis en place votre click2call dans le Manager

try {
$soap = new SoapClient("https://www.ovh.com/soapi/soapi-re-1.16.wsdl");

//telephonyClick2CallDo
$soap->telephonyClick2CallDo("$identifiant", "$mot_de_passe", "$votre_ligne_qui_appel", "$ligne_a_appeler", "$votre_ligne");
echo "telephonyClick2CallDo successfull\n";
} catch(SoapFault $fault) {
echo $fault;
}

?>


Il faudra remplir les variables en début du script click.php pour que cela fonction avec votre compte : indiquez donc dans les "" vos identifiants, mot de passe, numéro de lignes.

Note :
Pour les personnes ayant des soucis sur leur Siemens ou un téléphone en DECT de manière générale :
        - Vérifiez que le outbound proxy est bien configuré à sipp.ovh.net et sélectionner pour être utilisé tout le temps.
        - Sinon vous pouvez inverser les variables $votre_ligne_qui_appel et $ligne_a_appeler pour corriger votre problème. Le premier téléphone à sonner ne sera dans ce cas plus le vôtre mais celui de la personne à appeler. Assurez-vous dans ce cas, de donner accès à votre formulaire lorsque vous vous trouvez prêt de votre téléphone.

Dans notre exemple, nous ne faisons aucun traitement sur les informations entrées dans le formulaire, afin d'être sur que l'utilisateur ne fera pas d'erreur, réaliser un script qui vérifiera votre variable pour que le numéro entrer soit bien au bon format.

Pour les serveurs dédiés :
Si vos hébergez votre script sur votre propre serveur dédié (les clients mutualisés ne sont pas concernés par cette partie), vérifier les points suivants :
- ouvrir le port de sortie (tcp) 443 sur votre Firewall pour les liens en https,
- ouvrir le port de sortie (tcp) 1664 sur votre Firewall pour le serveur SOAPI,
- activer le ssl sur votre serveur,
- vérifier que la classe SOAP est présente sur votre machine,
- vérifier que vous acceptez au minimum php5.