Wazo Contacts Exporter

Guide d'installation et d'utilisation

1. Présentation

Le plugin ajoute un onglet « Export contacts » dans les réglages de l'application Wazo. D'un clic, chaque utilisateur télécharge son carnet de contacts personnels en CSV (au format d'import Wazo, ré-importable tel quel).

Le plugin réutilise la session Wazo déjà connectée : chaque utilisateur exporte ses propres contacts. Rien à installer sur le poste.

Pourquoi chacun n'exporte que les siens ? Les contacts personnels sont privés : l'API Wazo les rattache au compte connecté. Même un administrateur ne peut pas exporter le carnet personnel d'un autre utilisateur — l'export se fait donc côté utilisateur.

2. Prérequis

Un compte Wazo fonctionnel (application Web ou Desktop).
Accès au Portal Wazo (portal.wazo.io) pour installer le plugin (administrateur, une seule fois).

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 : collez

https://wazo-contacts-exporter.kissvoice.kissgroup.io/manifest.json

5 Validez l'installation.

Variante : activer seulement pour certains utilisateurs. Settings › Debugging Tools › Auth. Users → sélectionnez l'utilisateur → Application Configuration → section Plugins → collez la même URL.

Une fois installé, l'onglet Export contacts apparaît dans les réglages de l'application Wazo de chaque utilisateur concerné.

4. Étape 2 — Exporter ses contacts (utilisateur)

1 Dans l'application Wazo, ouvrez les Réglages → onglet Export contacts.
2 Le plugin affiche le nombre de contacts personnels.
3 Cliquez sur Télécharger CSV (fichier contacts-perso-AAAAMMJJ-HHMM.csv).

Le bouton Rafraîchir recompte si vous venez de modifier vos contacts.

5. Format du fichier CSV

Le CSV suit le gabarit d'import Wazo, dans cet ordre exact de colonnes :

firstname,lastname,number,mobile,extension,number_other,email,address,enterprise,birthday,note

Un contact sans l'un de ces champs laisse la colonne vide.
Le fichier inclut un BOM UTF-8 : les accents s'affichent correctement dans Excel.
Ce fichier est ré-importable dans un carnet Wazo sans retouche.

Les éventuels champs personnalisés hors gabarit ne figurent pas dans le CSV.

6. Dépannage

Symptôme	Cause probable / solution
L'onglet Export contacts n'apparaît pas	Le plugin n'est pas installé/activé pour cet utilisateur (voir Étape 1). Rechargez l'application Wazo.
« Session Wazo indisponible »	Ouvrez le plugin depuis l'application Wazo (il a besoin de la session en cours).
« Session expirée ou token invalide » (401)	Déconnectez-vous puis reconnectez-vous à Wazo, et réessayez.
« Stack introuvable »	Dépliez Options avancées, saisissez l'hôte du stack (ex. `monstack.wazo.io`) puis Appliquer.
Le CSV est vide (juste l'en-tête)	Le compte n'a aucun contact personnel. Les contacts d'annuaire partagé ne sont pas concernés.

7. Confidentialité

Chaque utilisateur n'exporte que ses propres contacts personnels.
Le plugin réutilise la session Wazo déjà connectée — aucun identifiant supplémentaire.
Les contacts sont récupérés puis transformés dans le navigateur ; le fichier est téléchargé directement sur le poste. Rien n'est envoyé à un tiers.

Wazo Contacts Exporter — Kissgroup. Plugin hébergé : https://wazo-contacts-exporter.kissvoice.kissgroup.io