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
General
Operation of the module is based on file "calling.php" at the root of public Dolibarr. That it is accessible via http. All calls to this module passes through the file, so that incoming calls outgoing. The module uses a table of additional data (llx_calling) to trace incoming calls, and the called user. Calling a folder is created in the Documents folder to store user specified javascript file.
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)
Under Module incoming call notifications
The alert modules are modules that works in real time to inform you of incoming calls. He created a display featuring links to the customer record / contact, and possibly the employee initially called. Several modules are available in different contexts of use.
- Mod NoRun : Module example, to disable all JavaScript elements call notification - Mod Simplejs : Module original notification via a popup (modal box jquery) in full screen. Intended for use by a single user of Dolibarr. Based on a recurring ajax call - Mod Advancedjs : Module advanced reporting, providing a non-intrusive display (top right menu link, and incoming call details click on the link). Operated mutli-user context. Based on a recurring ajax call. - Mode Nodejs : Module advanced notification, it is identical in terms of display module Advancedjs, but operates a complementary nodejs @ server to push information to the customer Dolibarr. There is no recurring ajax call. It requires a dedicated server, nodejs installed. and the servelet provided in the package
Submodule nodejs pre-requisite
This module exploits in technology node.js. It is therefore necessary that the server that hosts dolibarr, nodejs be installed. Otherwise, the client submodule dolibarr not work.
Servelet Nodejs
the configuration possibilities are numerous, we will present a basic installation quickly with these pre-requisite for this servelet. extract the zip nodejsd in your / var / nodejs script execution call index.js
Simply launch
node /var/nodejs/index.js
for the script starts. If you connect to your dolibarr (with nodejs client module enabled), you will see the server will inform the connection of your user id. To start your production servelet used the famous "&" so that your servelet does not cut it when you log out of ssh.
node /var/nodejs/index.js &
Once installed and configured your servelet (see config.js file), go to the Control Panel module calling dolibarr, enable the module nodejs, then specify the url and port of your servelet
Note
It is possible to modify this behavior with module named alert_xxx.php