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 :

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.

Option « Gestion Résidents »

vendredi 18 mars 2022 | infos & blog

Principes

L’option ‘Résidents’ permet une refacturation des communications (et abonnements..) dans un environnement dit ‘hôtelier’ où certains abonnés sont extérieurs à l’établissement. C’est le cas de maisons de retraite, EHPAD, établissements hospitaliers, hôtels, résidences hôtelières, locations de bureaux…

Alors que de base Comtrafic permet de facturer des postes ou des services, l’option ‘Résidents’ permet de facturer des clients (ou résidents) avec un principe d’arrivée ou check-in, de transfert si le client change de poste, et de départ ou check-out. La facture est alors associée au client quel qu’ait été son poste lors du séjour.

L’option ‘résident’ propose une interface indépendante de la partie ‘administrative’ de ComTrafic, l’utilisateur final ne voit donc que la gestion des résidents.

Utilisation du menu principal Gestion Clients

A partir de ce menu vous pouvez :

1 : Faire une arrivée (si une chambre libre est sélectionnée elle est choisie pour l’arrivée)

Après avoir sélectionné un résident dans la liste :

2 : Modifier les caractéristiques de ce résident (transfert, correction du nom…)

3 : Obtenir la liste de ses communications.

4 : Redemander une édition de sa fiche.

5 : Faire le départ.

6 : Dans la partie haute du menu vous pouvez choisir des critères et cliquer sur ‘recherche’ pour filtrer sur les chambres ou résidents.

La liste obtenue peut être triée en cliquant sur le titre de la colonne.

Une facture du client est éditée : 

• Lors du départ client.
• Sur demande
• Lors de la facturation mensuelle, avec l’ensemble des factures résidents, pour les établissements de long séjour : EHPAD…

Envoi de mail par Comtrafic (rapport, statistiques, facture..) avec un compte SMTP Gmail

vendredi 24 septembre 2021 | infos & blog

Envoi de mail avec un compte Gmail

Depuis la version 3.6 de ComTrafic il est possible d’utiliser les services SMTP avec SSL, ceci servant à envoyer des états, manuellement ou de manière automatique .

Prérequis au niveau du compte Gmail :

• Il faut bien sûr le nom d’utilisateur/le mot de passe (pour l’exemple : TestsComtrafic@gmail.com / telecomstest80 )

• Autoriser une application ‘externe’ à utiliser le compte : connectez vous sur votre compte Gmail puis allez sur https://myaccount.google.com/lesssecureapp et validez Paramètre « Autoriser les applications moins sécurisées »

Pour configurer et tester, allez dans Paramétrages/configuration mails et

1. Saisissez le ‘Adresse du serveur SMTP‘ smtp.gmail.com et le ‘Port‘ utilisé 587

2. Saisissez le ‘nom d’utilisateur‘ : TestsComtrafic@gmail.com le ‘mot de passe‘ : telecomstest80

3. Saisissez l’expéditeur dans ‘de’ et le destinataire dans ‘A’ :

• • Attention pour certains services SMTP l’expéditeur doit être connu, par défaut l’adresse du propriétaire du compte est une bonne idée.

  • Pour plusieurs destinataires, séparez les adresses par une virgule.

4. Dans ‘Type d’authentification‘ choisissez login, dans ‘SSL’ choisissez Explicit

5. Cliquez sur le bouton ‘Envoi‘, vérifiez la bonne réception après quelques secondes.

6. Le détail des échanges est décrit dans ‘Infos‘.

En cas de problèmes :

1. Faites déjà un test avec ‘Envoi serveur de test’, qui valide si votre serveur a accès à des serveurs SMTP externes.

2. Si c’est OK vérifiez la trace et essayez d’interpréter les erreurs.

Remarques :

Attention : Les informations (utilisateur, mot de passe…) sont stockées en clair sur le serveur.

Comtrafic version 3.6 : API Web, gestion résidents, facturation …

mardi 27 juillet 2021 | infos & blog

La version 3.6.0 est disponible.

Les principaux axes sont :

• La publication des API Web.
• Diverses améliorations de la fonction Résidents, de meilleures performances pour le ‘mode Client‘ , la possibilité d’utiliser le logiciel lien.exe en mode ‘service Windows’.
• La préparation au passage en 64 bits & la préparation à la version Web.
• Amélioration des fonctions de facturation et de gestion des mails.

Cette version, toujours en 32 bits, prépare la version 64 bits et supprime la compatibilité avec d’anciennes versions de Windows, les compatibilités sont désormais : Microsoft Windows 7, 8, 10 Windows Server toutes versions à partir de 2008R2. 

Les principales évolutions sont les suivantes :

• Nouvelles fonctionnalités dans la version Résidents  :
  • Gestion des paiements.
  • Améliorations des menus Fiche Client et Liste des communications.
  • Amélioration des éditions : paramétrage des éditions par action (arrivée, mouvement, départ)
  • Codes secrets
• Gestion des seuils de dépense dans le menu Supervision.
• Amélioration du fonctionnement PC Client plus rapide et non bloquant pour les opérations de maintenance du serveur.
• Disponibilité des API REST Web par défaut.
• Amélioration diverses dans les rapports par défaut.
• Pour le logiciel lien.exe : la possibilité de l’utiliser en mode ‘service Windows’.
• Possibilité d’utiliser, pour l’envoi des rapports par mails, les services SMTP avec STARTTLS comme Gmail.
• Facturation : gestion des tarifs améliorée, nouveaux rapports pour la synthèse, nouveaux menus de facturation.

Contraintes et limitations

• La mise à jour ‘classique’ (mise à jour des exe) est possible mais certains rapports poseront des pb de compatibilité, le mieux est de nous consulter pour une mise à jour.
• Les nouvelles fonctions ne sont pas toutes documentées. Chacune fera l’objet d’un article et la documentation sera mise à jour à cette occasion. N’hésitez pas à nous consulter si vous désirez utiliser une des fonctions concernée.