Wazo Universal App Connector

Guide d'installation et d'utilisation

Ce guide explique comment mettre en place la détection d'appels Wazo et le déclenchement automatique d'une action sur le poste (ouvrir une fiche client dans le navigateur, lancer un logiciel métier avec le numéro de l'appelant, etc.).

1. Présentation

À chaque appel (entrant ou sortant) détecté dans Wazo, le système déclenche l'action configurée — par exemple :

• ouvrir une URL : la fiche du client correspondant au numéro dans votre CRM ;
• lancer un programme : un logiciel métier en lui passant le numéro de l'appelant (ex. levée de fiche patient).

Le système comprend deux éléments :

┌─ Application Wazo (softphone) ───────────┐      ┌─ Connecteur (sur le poste) ──────────┐
│  Plugin « App Connector »                │      │  • reçoit le numéro                  │
│  • détecte les appels                    │ ───► │  • exécute l'action (URL / programme)│
│  • transmet le numéro au connecteur      │      │  • page de configuration locale      │
└──────────────────────────────────────────┘      └──────────────────────────────────────┘

• Le plugin s'installe une seule fois dans Wazo (côté administrateur), pour tous les postes.
• Le connecteur s'installe sur chaque poste où l'action doit se déclencher.

2. Prérequis

• Un compte Wazo (softphone) fonctionnel sur le poste.
• Accès au Portal Wazo (portal.wazo.io) pour installer le plugin (administrateur).
• Le poste sous Windows pour installer le connecteur.

3. Étape 1 — Installer le plugin dans Wazo (administrateur, une seule fois)

Le plugin est identique pour tous les clients et déjà hébergé. Il suffit d'enregistrer son URL dans le Portal.

1. Connectez-vous au Portal : https://portal.wazo.io
2. Allez dans Plugins › Apps puis cliquez sur Install.
3. Application : choisissez Web & Desktop.
4. URL du manifest :

   https://wazo-universal-app-connector.kissvoice.kissgroup.io/manifest.json

5. Validez l'installation.

Une fois installé, le plugin App Connector apparaît dans les réglages de l'application Wazo de chaque utilisateur concerné.

4. Étape 2 — Installer le connecteur sur le poste (Windows)

1. Téléchargez l'installeur :

   https://wazo-universal-app-connector.kissvoice.kissgroup.io/WazoAppConnector-Setup.exe

2. Lancez le fichier téléchargé.
3. Au premier lancement, Windows peut afficher « Windows a protégé votre PC » : cliquez sur Informations complémentaires puis Exécuter quand même.
4. Laissez l'installation se faire (aucun droit administrateur requis).

À la fin, le connecteur démarre automatiquement (et à chaque ouverture de session ensuite) et ouvre sa page de configuration (http://127.0.0.1:8787). Un raccourci « Configurer Wazo App Connector » est disponible dans le menu Démarrer.

5. Étape 3 — Configurer une action

Ouvrez la page de configuration (raccourci menu Démarrer, ou http://127.0.0.1:8787). Langue Français / English en haut à droite. Dépliez « Avancé (technicien) ».

a) Indicatif pays (recommandé)

Section Numérotation → Indicatif pays par défaut : saisissez 33 (France) → Enregistrer. Le jeton {e164} transforme alors 0631887134 en +33631887134.

b) Ajouter une action

Section Actions → + Ajouter une action :

Champ	Description
Nom	libellé libre
Type	url (ouvrir une URL) ou exec (lancer un programme)
Déclencher quand	☐ ça sonne · ☐ on décroche
Sens de l'appel	☐ entrant · ☐ sortant

Selon le type :

• url → champ URL, ex. https://mon-crm.fr/fiche?tel={e164}
• exec → Chemin du programme (ex. C:\wlogos1\callid.exe), Dossier de travail (optionnel) et Arguments (ex. AppelDe={number})

Jetons disponibles (utilisables dans l'URL et les arguments) :

Jeton	Valeur
{number}	numéro de l'interlocuteur
{name}	nom du contact (ou le numéro si inconnu)
{e164}	numéro au format international (ex. +33631887134)

Cliquez sur Enregistrer.

c) Tester sans appel réel

Section Tester : saisissez un numéro, choisissez sens/état, puis Simuler un appel. L'action se déclenche comme pour un vrai appel.

6. Étape 4 — Vérifier que tout fonctionne

1. Dans l'application Wazo → Réglages → onglet App Connector : vous devez voir « Connecteur détecté ✓ ».
2. Passez un appel de test. L'action configurée se déclenche.

7. Mise à jour et désinstallation

• Connecteur : relancez le nouvel installeur (il remplace l'ancienne version). Pour le retirer : Paramètres Windows › Applications › Wazo App Connector › Désinstaller.
• Plugin Wazo : mis à jour automatiquement (hébergement centralisé). Si un changement ne s'applique pas, désinstallez puis réinstallez le plugin dans le Portal.

8. Dépannage

Symptôme	Cause probable / solution
Réglages plugin : « Connecteur introuvable »	Le connecteur n'est pas lancé. Menu Démarrer → « Configurer Wazo App Connector », ou redémarrez la session Windows.
L'action ne se déclenche pas	Vérifiez les cases Déclencher quand / Sens, et que l'action est Enregistrée. Testez avec Simuler un appel.
{e164} renvoie le numéro national	Indicatif pays par défaut non renseigné. Mettez 33 puis Enregistrer.
Le décroché ne déclenche rien	Vérifiez que l'action a « on décroche » coché.
L'onglet App Connector n'apparaît pas dans Wazo	Plugin non installé/activé pour cet utilisateur (Étape 1). Rechargez l'application Wazo.

Journal du connecteur (support) : %AppData%\wazo-connector\connector.log
Configuration : %AppData%\wazo-connector\config.json

9. Sécurité

• Le connecteur n'écoute qu'en local (127.0.0.1) : inaccessible depuis le réseau.
• Le plugin réutilise la session Wazo déjà connectée — aucun identifiant supplémentaire.
• La configuration (chemins, URLs) reste sur le poste.