Module Calling en
Informations
| Module name | |
| Editor / Editeur | Oscim - oscim.fr |
| Download or buy page / Page achat ou téléchargement | |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | module_clicktodial
Dolibarr min version: 3.3.x Dolibarr max version: {{{maxversion}}} |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2013-04-2 |
| Note / Nota |
Vocation
Provides support for monitoring phone calls (incoming and outgoing). An alert when an incoming call contains links to customer information and / or information known collaborator. Logging calls in sheets and in the third calendar
Install
From the application
- Download the archive file of module (.zip file)
- Go on menu Home -> Setup -> Modules -> Deploy external module and submit the file.
- Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.
Manually
- Download the archive file of module (.zip file)
- Put the file into the root directory of Dolibarr.
- Uncompress the archive file, for example with command
unzip modulefile.zip
- Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.
Configuration
To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".
Choose the tab where the module is listed. Then click on "Activate".
The module is now activated.
If a cog icon appears 
on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.
This module enables and configures the module clicktodial dolibarr already present during the installation. Once installed and configured the module, you will need to combine dolibarr your service provider voip telephony.
Config clicktocall
This module natively in st dolibarr on the record of each user's internal dolibarr you have a tab clicktocall.Il is necessary to fill the login information (login / pass / tel), and the phone number used. url trigger click to call is not defined module calling, so do not change the configuration items clicktocall
Configuration link by SIP provider
Your choice of provider may limit the use of the module according to the API of the latter. This module comes with submodule to adjust it to your supplier. List of supplier supported to date:
- Keyyo : Voir keyyo.fr -The API supports incoming and outgoing calls - OVH : Voir Ovh.fr - The API supports outgoing calls - OVH + @Asterisk : ovh extension module adds support outgoing calls through a PBX private. Requires to install and configure a server asterisk - The API supports incoming and outgoing calls
Link in Agenda and action
Add an action in the dictionary "Action List" table llx_c_actioncomm to list the specific action to telephony;
- code : AC_TEL - Libellé : Phone call - type : system
This addition allows you to use the phone main menu button, which should limit the display to only telephony events.
Options module
Alert mode
This option allows you to manage the behavior when incoming calls;
- No popup notification and no notification, you can choose in this case the module sub NoRun notification module - Only users are notified of the called station, only informs the user whose number is called. This selection takes into account the extension configured on the user profile, and the line number specified in the tab clicktocall - All user configured for clicktodial are notified - All users are notified
behavior on the number of employees and the company
This option sets the behavior when an incoming call to an employee (including mobile number with are), internal call, call an external site.
- Ignore incoming calls numbers business users (pro / personal / mobile), no notification or record in shares - Accept and notify unless the corresponding user
Information collaborator called
Display additional information about the employee actually called by a third party (based on the number of phone contact).
Creating sheet
In the case of incoming call, the number is not found in the database, a listing can be created, with the name of the phone number.
- No creation of plug - Create the third number of the caller - Create a contact number of the caller
Anonymous Calls
Can create a form for anonymous calls.
Trace calls
Trace calls in actions / agenda dolibarr; You can disable this option.
Utilisation
La manipulation et l'utilisation de ce module reste simple, compte tenu qu'il ne généré pas d'action particulières. le clicktocall sur les numéro de téléphone vous assure la possibilité de lancer des appels en 1 clic. Attention toutefois les numéro de fax ce retrouvent aussi avec un liens de click to call.
Lors d'un appel entrant, en fonction de la configuration du mode d'alerte, vous aurez une boite affichant le liens vers la fiche du contact et/ou de la société qui cherche à vous joindre. De plus les appels sont tracés dans l'agenda.
Information Développement
Généralités
Le fonctionnement du module s’appuie sur un fichier "calling.php" à la racine public de dolibarr. Celui ci est donc accessible via http. Tous les appels de ce module transite par ce fichier, tant les appels entrant que les sortant. Le module utilise une table de donnée supplémentaire (llx_calling ) afin de tracer les appels entrant, et l'utilisateur appelé. Un dossier calling est crée dans la dossier Documents afin de stocker des fichier javascript spécifique par utilisateur.
Sous Module de liaison vers api de voip
Il est possible d'ajouter et modifier les modules d'interaction avec les api de VOIP. les modules fournis assure une liaison vers des services precis, si vous utiliser une autre api, il sera necessaire de créer votre propre module de liaison.
Le fichier d'un module de gestion d'api doit être nommé api_xxxx.php , ou xxxx représente le nom du fournisseur du service
Émission d'un appel
Cette liaison exploite le module ClicktoCall. Il assure l’émission d'un appel , qui une fois lancé fera sonner votre téléphone, et celui de l'interlocuteur que vous appelez. L'utilisation du clicktodial complétera automatiquement la fiche action du tiers/contact.
Pour la conservation des données, et l'affichage du popup, un fichier est créer dans Documents/calling de dolibarr. Ce fichier assure le stockage des données temporaire.
Réception d'un appel
Cette section un peu plus complexe sera très dépendante des service offert par l'offre de VOIP à laquelle vous avez souscrit.
L'interception des appels, ne vous permettra pas de décrocher votre téléphone, mais vous proposera un popup de dialogue, vous fournissant le liens vers la fiche Tiers/contact correspondante, si celle ci existe dans la base de donnée.Dans le cas contraire, il sera possible de créer une fiche de tiers/contact basé sur le numéro de téléphone.
Tous appel entrant viendra compléter la fiche action du tiers. En cas d'appel non répondu, la tache restera ouverte. Dans le cas d'un appel décroché, la tache sera clôturé.
Configuration de l'api tiers
Il sera nécessaire pour rendre opérationnel la notification des appels entrant de préciser une URL de notification pour l'api tiers, qui doit initier cette notification. Utiliser l' URL entrant , afficher dans votre page de configuration . Celle ci étant générer par le module d'une api précise, les variables GET a remplacer, sont spécifique à ce fournisseur.
Note
- Stockage des numéro de téléphone en base de donnée. Pour pouvoir être extrait et reconnu, il est souhaitable d'utiliser la nomenclature international / national des numéros. 02 35 98 63 65 ou 33 6 98 65 87 54 ou 002 65 98 32 78
Configuration element asterisk
Configuring Asterisk server is full and complex, the possibilities are huge, so I encourage you to read the tutorial specialist. Remember however that the PBX are highly contested and those that can generate significant cost if your server does this hack or is misconfigured, given that it is a gateway to the telephone network, and these rates vary (mobile, call overtaxed, international, etc. ..). For my own part, I use asterisk in the management of incoming calls, outgoing calls exploiting API ovh via click to call. Dolibarr calling module is designed to asterisk in this direction.
Fichier extensions.conf
following configuration elements start from the premise that you have installed an asterisk functional and configured your connection with your provider. It merely bring the basics to intercept incoming call and notification to Dolibarr. He must return at the same time to sip your line.
Context incoming call
; appel entrant via numero provider
[process_entrant]
exten => _X.,1,NoOp()
exten => _X.,n,Set(__DOLI_CALLER=${CUT(CUT(SIP_HEADER(From),@,1),:, 2)})
exten => _X.,n,Set(__DOLI_CALLE=${CUT(CUT(SIP_HEADER(To),@,1),:, 2)})
; REDIRECTION
exten => _X.,n,Goto(dolibarr_notification,s,1)
Context macro-notification
; Doli
; macro pour event CONNECT
[macro-dolinotif]
exten => s,1,SET(${CURL(http://votreserveur/calling/calling.php?account=${EXTEN}&caller=${DOLI_CALLER}&callee=${DOLI_CALLE}&type=CONNECT&callref=${DOLI_CALLER}&version=1)})
Context notification
; Doli
; Process
[dolibarr_notification]
; put notif SETUP
exten => s,1,SET(CALLERID(name)=${CURL(http://votreserveur/calling/calling.php?account=${USERNAME}&caller=${DOLI_CALLER}&callee=${DOLI_CALLE}&type=SETUP&callref=${DOLI_CALLER}&version=1)})
exten => s,n,Answer()
; option : r pour sonnerie d'attente
; option : e Execute "h" as the peer when this call ends
; option : t T transphert appelant / appelé
; option : M() Macro
; option S() raccorche apres x seconde
exten => s,n,Dial(SIP/votreposte, 60,etTrM(dolinotif))
; put notif RELEASE
exten => h,1,SET(CALLERID(name)=${CURL(http://votreserveur/calling/calling.php?account=${USERNAME}&caller=${DOLI_CALLER}&callee=${DOLI_CALLE}&type=RELEASE&callref=${DOLI_CALLER}&version=1)})
exten => h,2,Hangup(16)
Sous Module des notifications d'appel entrant
Les modules d'alerte, sont les modules qui travaille en temps réel afin de vous informer des appels entrant. Il créer un affichage proposant les liens vers la fiche client/contact, et éventuellement celle du collaborateur initialement appelé. Plusieurs modules sont disponible en fonction des contextes d'utilisation.
- Mod NoRun : Module d'exemple, permettant de désactiver tout éléments JavaScript de notification des appels - Mod Simplejs : Module original de notification via un popup (modale box jquery) en pleine page. Destiné à l'usage d'un utilisateur unique de dolibarr. Basé sur un appel récurent en ajax. - Mod Advancedjs : Module de notification avancé, assurant un affichage non intrusif (lien menu haut droit, et détail appel entrant au click sur le lien). Exploité en contexte mutli-utilisateurs. Basé sur un appel récurent en ajax. - Mode Nodejs : Module de notification avancé, il est identique en terme d'affichage au module Advancedjs, mais exploite un serveur @nodejs complementaire afin de pousser les informations vers les client dolibarr. Il n'y a aucun appel récurent en ajax. Il nécessite un serveur dedié, nodejs installé. le servelet et fourni dans le paquet.
Sous module Nodejs pre-requis
Ce sous module exploite la technologie node.js. Il est donc nécessaire que votre serveur qui héberge dolibarr, soit installé nodejs. Sans quoi, le sous module client de dolibarr ne fonctionnera pas.
Servelet Nodejs
les possibilité de configuration étant nombreuses, nous allons détailler rapidement une installation de base avec ces pre-requis pour ce servelet. extraire le zip nodejsd dans votre dossier /var/nodejs
le script d’exécution s'appel index.js
Il vous suffit de lancer
node /var/nodejs/index.js
pour que le script démarre. Si vous vous connecter à votre dolibarr (ayant activé le module client Nodejs), vous verrez alors le serveur vous informer le la connexion de l'id de votre utilisateur.
Pour lancer en production votre servelet, utilisé le fameux "&", afin que votre servelet ne ce coupe pas lorsque vous vous déconnecterez du ssh.
node /var/nodejs/index.js &
Une fois installé et configuré votre servelet (voir fichier config.js), aller dans le panneau de configuration du module calling de dolibarr, activer le module nodejs, puis preciser l'url et le port de votre servelet
Note
Il est possible de moduler ce comportement avec des module nommé alert_xxx.php