Module OVH (SMS, ClickToDial, ...) FR

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Informations

Module name OVH
Editor / Editeur NLTechno - www.nltechno.com
Download or buy page / Page achat ou téléchargement www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis
  • Un compte OVH.
  • Pour l'utilisation de Click2Dial, il faut aussi un abonnement SIP et les identifiants fournis par OVH.
  • Dolibarr 3.8+
Last update date / Date mise à jour fiche / Fecha última actualización 2020-02-24
Note / Nota

Fonctionnalités

Ajoute des fonctionnalités d'interface avec les services de l'hébergeur OVH. La version actuelle permet de:

  • Envoyer un SMS à un tiers, contacts ou adhérent (unitairement)
  • Utiliser le système ClickToCall d'OVH
  • Importer les factures OVH.

Installation

  • Télécharger le fichier archive du module (.zip) depuis le site web www.dolistore.com ou le récupérer par tout autre manière.
  • Placer le répertoire du module dans le répertoire custom de Dolibarr:
    • Pour cela, aller dans Accueil - Configuration - Modules - Déployer/installer une app/module externe
    • Téléverser le fichier. Note: Si cela échoue, vous pouvez manuellement dézipper le fichier dans le répertoire custom via la ligne de commande: aller dans le répertoire *custom* et décompressez le zip avec la commande: unzip fichiermodule.zip
  • Le module est opérationnel et peut être activé.

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".

Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".

Le module est alors activé.

Si un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Configuration commune

Toutes les fonctionnalités de ce module requiert un compte OVH que vous pouvez créer depuis le site OVH (www.ovh.fr)

Sur la page de configuration du module, onglet Authentification, renseigner les informations:

  • Application name
  • Application key
  • Application secret

Pour obtenir ces 3 valeurs, il faut aller sur la page https://eu.api.ovh.com/createApp/

Cliquer sur Sauvegarder une fois ces 3 caleurs renseignées. Une 4eme zone à renseigner apparaît. Pour obtenir la valeur cliquer sur le lien Click here to login and get a new consumer key (You must choose UNLIMITED validity) qui est également apparu. Cela ouvre une fenêtre d'authentification OVH. Renseigner votre NICHandle et mot de passe, ainsi que la durée "ILLIMITE". En retour de cette page, la 4eme zone sera renseignée.

Configuration SMS

L'envoi de SMS requiert l'acquisition par avance d'un lot de SMS prépayés. Il vous faut donc vous créer un compte chez OVH et acheter un pack de SMS (https://www.ovh.com).

Une fois que vous avez achetez votre lot de SMS, sur le manager, il vous faut saisir les libellés des expéditeurs (noms ou numéro de téléphone) qui doivent apparaître comme émetteur.

Warning.png Attention: Cette étape nécessite un délai de la part d'OVH pour être validé. Tant que l'expéditeur ne sera pas validé par OVH, l'envoi de SMS ne sera pas possible.

Ensuite, dans Dolibarr, dans la configuration du module OVH, sur l'onglet SMS, ajouter le nom du compte SMS à utiliser (créé à l'étape précédente).

Screen shot sms setup.png

Configuration ClickToDial OVH

Pour l'utilisation de ClickToDial, sur l'onglet ClickToDial,

  • Prendre note de l'URL qui est indiquée
  • Aller dans la configuration globale du module ClickToDial qu'il vous faut activer et copier l'URL notée dans le champ "Lien par défaut".

Soit vous copiez l'URL telle qu'elle et il vous faut ensuite aller sur le fiche utilisateur pour renseigner le login SIP fourni par OVH (et éventuellement le mot de passe) sur l'onglet Clicktodial de la fiche utilisateur, soit vous remplacer les champs __LOGIN__ (et __PASS__) dans l'URL avec ces valeurs directement (mais dans ce cas, ce login/mot de passe sera le même pour tout le monde).

Remarque: Pour obtenir ce couple login/mot de passe, voir la documentation fournie par OVH disponible ici: http://guides.ovh.com/TelFaqClick2Call

Screen shot click2dial.png

Warning.png Vérifiez aussi que votre service de téléphonie OVH est bien configuré en SIP et non en Analogique.

Configuration Import factures OVH

Choisissez sur cet onglet, le tiers sur lequel sera créé les factures importées d'OVH.

Utilisation

SMS

  • Aller dans la fiche Tiers, Contact ou adhérent. Un onglet est apparu pour permettre l'envoi des SMS.

Screen shot sms.png

ClickToDial

  • Si vous avez bien activer le module ClickToDial et recopié l'URL comme indiqué dans le chapitre ci-dessus, un picto doit être présent à côté de chaque numéro de téléphones. En cliquant dessus, la numérotation est déclenché et votre système de téléphonie OVH s'exécute.

Récupération factures

Aller dans le menu "Modules tools - OVH invoices import". Si ce menu n'existe pas sur votre version, appeler l'URL http://votreurldolibarr/ovh/importovhinvoice.php

Vous pouvez alors choisir les factures à importer.

Screen shot invoiceimport.png

Développement

Le développement de ce module n'est pas inclus dans le repository GIT standard de Dolibarr mais dans un repository dédié de modules gérés par NLTechno sur la plateforme Git de Framasoft:

Notons que c'est un repository privé, aussi il vous faut créer un compte et postuler au projet depuis le site https://git.framasoft.org pour pouvoir cloner les sources par GIT.


Résolution de problèmes

Si vous etes sous Debian ou Ubuntu et avez cette erreur

Error creating resource: [message] fopen(): SSL operation failed with code 1. OpenSSL Error messages: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed [file]
.../htdocs/ovh/includes/guzzlehttp/ringphp/src/Client/StreamHandler.php [line] 406 [message] fopen(): Failed to enable crypto [file] 
.../ovh/includes/guzzlehttp/ringphp/src/Client/StreamHandler.php [line] 406 [message] fopen(https://api.ovh.com/1.0/auth/credential): failed to open stream: operation failed [file]
.../ovh/includes/guzzlehttp/ringphp/src/Client/StreamHandler.php [line] 406 [message] Undefined variable: http_response_header [file] 
.../ovh/includes/guzzlehttp/ringphp/src/Client/StreamHandler.php [line] 407

Vérifier que le package "ca-certificates" est installé.