Annuaires pour les agents et la console d'opérateur

À quoi sert cette page

Les annuaires de ce domaine fournissent des contacts au poste de travail d'agent et à la console d'opérateur. Un annuaire a une ou plusieurs sources. À chaque synchronisation, EasyUC relit toutes les sources actives et reconstruit à partir d'elles les entrées de l'annuaire.

Si les mêmes personnes figurent dans plusieurs sources, EasyUC peut les fusionner en une seule entrée à l'aide d'un champ clé. Champ par champ, la première valeur non vide dans l'ordre du rang des sources l'emporte alors.

Pour chaque entrée, le poste de travail affiche l'état de la ligne issu du CUCM et, s'il est disponible, la présence Teams. La page contient un diagnostic à cet effet.

Prérequis

Module de licence acd.
Droit : ROLE_APP_ACD_WORKSPACE et ROLE_APP_ACD_PHONEBOOK pour consulter, en plus ROLE_APP_ACD_PHONEBOOK_EDIT pour modifier. Les administrateurs disposant de ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN ou ROLE_SUPER_ADMIN ont tous les droits du domaine.
Selon la source : un fichier CSV, un compte de lecture LDAP, un compte de base de données en lecture seule (MySQL/MariaDB ou PostgreSQL), une connexion CUCM active ou un tenant Teams avec des identifiants Graph.
Pour Teams comme source, l'enregistrement d'application (app registration) du tenant a besoin de la permission d'application User.Read.All, pour la présence de Presence.Read.All, chacune avec consentement de l'administrateur.
Pour l'état de la ligne : la surveillance en direct pour tous les périphériques doit être activée sur chaque connexion CUCM (chapitre « Appels actifs et surveillance en direct »).

Pas à pas : créer un annuaire avec une source

Ouvrez Calling Features → Calls → Phonebook.
Cliquez sur New phonebook, saisissez Name et, si nécessaire, Description, puis cliquez sur Save.
Sélectionnez l'annuaire à gauche. L'onglet Sources s'ouvre à droite.
Derrière Add source, cliquez sur le type souhaité : CSV, LDAP, SQL, CUCM ou Microsoft Teams.
Saisissez Name et Rank et renseignez les champs du type. Pour CSV, sélectionnez le fichier et le Separator.
Cliquez sur Save.
Cliquez sur Test connection (pour CSV : Read stored file). EasyUC affiche le nombre d'enregistrements trouvés, les Columns found et un aperçu.
Sous Field mapping, associez une colonne de la source à chaque champ de l'annuaire. Suggest préremplit automatiquement l'association.
Cliquez sur Save, puis sur Synchronise now en haut.
Passez à l'onglet Entries et vérifiez le résultat.

Pas à pas : fusionner plusieurs sources

Ajoutez les autres sources à l'annuaire et donnez à la source principale le plus petit Rank.
Passez à l'onglet Settings.
Activez Merge records coming from several sources.
Sous Key field (UID), sélectionnez un champ qui porte la même valeur dans toutes les sources, par exemple l'adresse e-mail.
Cliquez sur Save, puis sur Synchronise now.

Pas à pas : publier un annuaire et vérifier l'état de la ligne

Ouvrez Calling Features → Calls → Agents, onglet Teams, et cliquez sur l'annuaire sous Phonebooks dans l'équipe. Enregistrez l'équipe.
Pour la console d'opérateur, attribuez l'annuaire à la console dans l'onglet Contacts & lamp field.
Sur la page de l'annuaire, déroulez Check line status.
Sous Test a phone number, saisissez un numéro actuellement en communication et cliquez sur Check. La vérification relit le service d'appel à neuf et ne modifie rien.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Name / Description	Name est obligatoire. Les agents voient la description au poste de travail.
Merge records coming from several sources	Activé : les lignes ayant la même valeur dans le champ clé forment une seule entrée. Les lignes sans valeur restent des entrées distinctes. Désactivé : chaque ligne de chaque source devient une entrée distincte.
Key field (UID)	Obligatoire en cas de fusion. Champ permettant de reconnaître les enregistrements.
Rank	1 à 9999. En cas de fusion, le plus petit nombre l'emporte.
Active	Seules les sources actives sont synchronisées.
CSV	CSV file, Separator (Detect automatically, Semicolon, Comma, Tab, Pipe), First row holds the column names.
LDAP	Server, Port, Encryption (none, LDAPS (SSL), StartTLS), Page size, Bind DN, Password, Search base, Filter.
SQL	Type (MySQL / MariaDB ou PostgreSQL), Server, Port, Database, User, Password, Query. Lecture seule. Chaque colonne du résultat peut être associée.
CUCM	CUCM connection, Which end users (All end users (local and LDAP), Only users created in the CUCM, Only users synchronised from LDAP), only users with an extension, only active users.
Microsoft Teams	Teams tenant. Reprend chaque utilisateur du tenant via Microsoft Graph. Les tenants sans identifiants Graph ne peuvent pas être sélectionnés.
Field mapping	Quelle colonne de la source remplit quel champ. Les champs non associés restent vides. Pour CUCM et Teams, le serveur préremplit une association lors de l'enregistrement.
Synchronise now	En haut pour l'ensemble de l'annuaire, dans la liste des sources pour une source individuelle.
Entries	Recherche sur le nom, la société, le numéro, l'e-mail. Colonnes : Name, Company, Department, E-mail, Phone, Mobile, Source.

Vérifier le résultat et circonscrire les erreurs

La vignette de l'annuaire affiche le nombre d'entrées et de sources, l'heure de la dernière synchronisation et les équipes attribuées. merged signale une fusion active.
never synchronised : cliquez sur Synchronise now.
not assigned to a team : les agents ne voient pas encore l'annuaire.
The source could not be read. ou un message de la source : vérifiez les identifiants, le serveur, le filtre ou la requête. Dans la liste des sources, le dernier message d'erreur est affiché sous le nom.
Save the source first, then the connection can be tested and the columns read.
Une personne apparaît deux fois : la fusion est désactivée, ou le champ clé est vide ou orthographié différemment dans une source.
Diagnostic Keine Adresse des Anrufdienstes hat geantwortet. (aucune adresse du service d'appel n'a répondu) : sans le service d'appel, il n'y a pas d'état de ligne. Vérifiez le service JTAPI.
Diagnostic Not every active CUCM connection reports its calls for all devices. : activez la surveillance en direct avec tous les périphériques. D'ici là, une ligne sans appel n'est pas signalée comme libre.
Le numéro testé does not appear in the running calls : comparez la notation. L'entrée de l'annuaire ne correspond à un appel que si les chiffres sont identiques. La ligne Compared as affiche le numéro normalisé.