Interactivité PBX ComTrafic sur Wazo

dimanche 3 avril 2022 | infos & blog

Depuis la version 3.6.4 Comtrafic permet l’interactivité avec le PBX Wazo (version 20.0 mini).

Interactivité : utilités et principes

L’interactivité PBX permet à Comtrafic d’avoir des actions sur le PBX, typiquement de couper les accès vers l’extérieur pour un client qui n’a plus les droits suffisants, d’affecter une SDA…, notamment avec l’option « résidents » ou dans la gestion des « crédit de taxe ».

L’exploitation peut être, par exemple, dans une clinique:

Lors de l’arrivée patient, le menu ‘Arrivée permet de lui affecter lit, Comtrafic ouvre alors les droits de son téléphone (accès à l’extérieur) et lui affecte une SDA pour que les proches puissent le joindre (un reçu avec ses informations peut être édité).

Lors du séjour, il peut y avoir des transferts, si le patient change de lit, l’ensemble de ses droits le suivent ainsi que sa SDA (on parle de SDA ‘tournante’).

Lors du départ du patient, l’ensemble de ses communications lui sont facturées, sa SDA est libérée, et les droit de son téléphone sont restreints.

Utilisation avec le PBX Wazo

Techniquement le dialogue Comtrafic-Wazo s’appuie sur les mêmes principes que notre logiciel PBXInterface  :

L’interface avec Wazo se fait via les API REST : https://wazo-platform.org/uc-doc/api_sdk/rest_api/

Pour utiliser ces API il faut accéder à l’interface Web de programmation du PBX avec les droits suffisants pour créer des utilisateurs.

Une connaissance basique de la programmation du PBX Wazo est impérative (création de user, permissions, SDA…).

Wazo doit être au moins en version 20.0 et ComTrafic au moins en version 3.6.4

Paramétrage PBX pour l’API

Créer via l’interface Web un utilisateur api avec les droits d’utilisation des api dont l’accès à l’API :

Pour créer un utilisateur API, il faut aller dans Settings>Credentials>Users puis CREATE. Il faut renseigner un username (par exemple comtraficapi) et un password et en purpose sélectionner External API., en multi-tenant, sélectionner le tenant concerné dans Tenant.

Créer une Policy via le menu Policies que l’on associe à l’utilisateur.

On peut mettre une ou plusieurs ACL.

Pour l’interactivité ajouter confd.#

Pour la gestion des tickets de communication ajouter : call-logd.cdr.read

Paramétrage PBX : données utilisateurs

Suivant l’exploitation il faut gérer un certain nombre de données dans le PBX qui doivent être en cohérence avec ComTrafic.

Configuration de base

Dans Wazo on va créer les users (utilisateurs en Français) et leur affecter une extension via le menu Users management/Users.

Remarque : ComTrafic ne gère qu’une extension par user en créer plus dans Wazo peut poser problème.

SDA (DID, incoming calls).

  • Si la SDA est fixe (toujours affectée au même poste) : affecter la SDA sur l’utilisateur via le menu Call Management/Incoming Calls et on ne déclare pas ‘gestion SDA’ dans les paramètres ComTrafic.

  • Si la SDA est ‘tournante’, créer la liste des SDA utilisables à cet usage, ne pas les affecter, noter la liste.

Droits d’appels (permissions)

Par défaut on crée une permission qui autorise les appels sortants et une qui les interdit (ou qui les restreint).

On choisit les noms, par exemple :

  • OutcallOK : pour les appels sortants autorisés

  • OutcallDeny : pour les appels sortants restreints.

Ensuite on crée ces 2 permissions, avec leurs droits, dans Call Management/Call Permissions

  • Dans Comtrafic allez dans le menu Paramétrage/
  • PBX   : WAZO
      • API Url : base de l’url de l’API exemple : https://wazodemo.wazo.io
      • Login/Password : les login et password du user api créé.

Paramétrage ComTrafic

Il est conseillé, avant de mettre en place Comtrafic, de vérifier la bonne prise en compte des paramètres Wazo avec le logiciel PBXInterface : https://comtrafic.com/gestion-simplifiee-pour-ipbx-pbxinterface/

Dans le menu Parametrage/Paramétrages :

blank

Dans Gestion d’interface PBX

  1. Cochez Interface PBX, puis validez.
  2. Ordres pour Interface.. choisissez 3 (Wazo)
  3. Paramétrage PBX saisissez L’URL, login et mot de passe API sous la forme : <https://><login>:<mot de passe>@<adresse> exemple https://comtraficapi:passwcom@wazodemo.wazo.io
  4. Autorisation appel ext : saisissez le nom (sensible à la casse) de la permission qui ouvre les droits d’appel ex.: OutcallOK
  5. Refus appel ext : saisissez le nom (sensible à la casse) de la permission qui ferme les droits d’appel, ex.: OutcallDeny
  6. Dans Gestion résidents (si utilisé)
    • Cochez Mode Résidents, puis validez.

Puis suivant l’exploitation :

    • Cochez Gestion SDA si besoin de la SDA tournante.

    • Cochez Gestion Codes secret si besoin des codes secrets.

Validez puis faites un arrêt – marche du logiciel.