Telefonbücher für Agenten und Vermittlungsplatz

Wozu dient das

Die Telefonbücher dieses Bereichs versorgen den Agenten-Arbeitsplatz und die Attendant-Konsole mit Kontakten. Ein Telefonbuch hat eine oder mehrere Quellen. Bei jedem Abgleich liest EasyUC alle aktiven Quellen neu ein und baut die Einträge des Telefonbuchs daraus neu auf.

Stehen dieselben Personen in mehreren Quellen, kann EasyUC sie über ein Schlüsselfeld zu einem Eintrag zusammenführen. Feld für Feld gewinnt dann der erste nicht leere Wert in der Reihenfolge des Rangs der Quellen.

Zu jedem Eintrag zeigt der Arbeitsplatz den Leitungsstatus aus dem CUCM und, falls vorhanden, die Teams-Anwesenheit. Die Seite enthält dafür eine Diagnose.

Voraussetzungen

Lizenzmodul acd.
Berechtigung: ROLE_APP_ACD_WORKSPACE und ROLE_APP_ACD_PHONEBOOK zum Ansehen, zusätzlich ROLE_APP_ACD_PHONEBOOK_EDIT zum Ändern. Administratoren mit ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN oder ROLE_SUPER_ADMIN haben alle Rechte des Bereichs.
Je nach Quelle: eine CSV-Datei, ein LDAP-Lesekonto, ein lesendes Datenbankkonto (MySQL/MariaDB oder PostgreSQL), eine aktive CUCM-Verbindung oder ein Teams-Tenant mit Graph-Zugangsdaten.
Für Teams als Quelle braucht die App-Registrierung des Tenants die Anwendungsberechtigung User.Read.All, für die Anwesenheit Presence.Read.All, jeweils mit Administratorzustimmung.
Für den Leitungsstatus: An jeder CUCM-Verbindung muss die Live-Überwachung für alle Geräte eingeschaltet sein (Kapitel „Aktive Anrufe und Live-Überwachung“).

Schritt für Schritt: Telefonbuch mit Quelle anlegen

Öffnen Sie Calling Features → Anrufe → Telefonbuch.
Klicken Sie auf Neues Telefonbuch, tragen Sie Name und bei Bedarf Beschreibung ein und klicken Sie auf Speichern.
Wählen Sie das Telefonbuch links aus. Rechts öffnet sich der Reiter Quellen.
Klicken Sie hinter Quelle hinzufügen auf den gewünschten Typ: CSV, LDAP, SQL, CUCM oder Microsoft Teams.
Tragen Sie Name und Rang ein und füllen Sie die Felder des Typs aus. Bei CSV wählen Sie die Datei und das Trennzeichen.
Klicken Sie auf Speichern.
Klicken Sie auf Verbindung testen (bei CSV: Gespeicherte Datei lesen). EasyUC zeigt die Zahl der gefundenen Datensätze, die Gefundenen Spalten und eine Vorschau.
Ordnen Sie unter Feldzuordnung jedem Feld des Telefonbuchs eine Spalte der Quelle zu. Vorschlagen belegt die Zuordnung automatisch vor.
Klicken Sie auf Speichern und oben auf Jetzt abgleichen.
Wechseln Sie auf den Reiter Einträge und prüfen Sie das Ergebnis.

Schritt für Schritt: Mehrere Quellen zusammenführen

Fügen Sie dem Telefonbuch die weiteren Quellen hinzu und geben Sie der führenden Quelle den kleinsten Rang.
Wechseln Sie auf den Reiter Einstellungen.
Schalten Sie Datensätze aus mehreren Quellen zusammenführen ein.
Wählen Sie unter Schlüsselfeld (UID) ein Feld, das in allen Quellen denselben Wert trägt, zum Beispiel die E-Mail-Adresse.
Klicken Sie auf Speichern und danach auf Jetzt abgleichen.

Schritt für Schritt: Telefonbuch freigeben und Leitungsstatus prüfen

Öffnen Sie Calling Features → Anrufe → Agenten, Reiter Teams, und klicken Sie im Team unter Telefonbücher das Telefonbuch an. Speichern Sie das Team.
Für die Attendant-Konsole ordnen Sie das Telefonbuch im Reiter Kontakte & Lampenfeld der Konsole zu.
Klappen Sie auf der Telefonbuch-Seite Leitungsstatus prüfen auf.
Tragen Sie unter Eine Telefonnummer testen eine Nummer ein, von der gerade telefoniert wird, und klicken Sie auf Prüfen. Die Prüfung liest den Anrufdienst frisch aus und ändert nichts.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Name / Beschreibung	Name ist Pflicht. Die Beschreibung sehen Agenten am Arbeitsplatz.
Datensätze aus mehreren Quellen zusammenführen	Ein: Zeilen mit demselben Wert im Schlüsselfeld werden ein Eintrag. Zeilen ohne Wert bleiben eigene Einträge. Aus: Jede Zeile jeder Quelle wird ein eigener Eintrag.
Schlüsselfeld (UID)	Pflicht beim Zusammenführen. Feld, über das Datensätze erkannt werden.
Rang	1 bis 9999. Beim Zusammenführen gewinnt die kleinere Zahl.
Aktiv	Nur aktive Quellen werden abgeglichen.
CSV	CSV-Datei, Trennzeichen (Automatisch erkennen, Semikolon, Komma, Tabulator, Pipe), Die erste Zeile enthält die Spaltennamen.
LDAP	Server, Port, Verschlüsselung (keine, LDAPS (SSL), StartTLS), Seitengröße, Bind-DN, Passwort, Such-Basis, Filter.
SQL	Typ (MySQL / MariaDB oder PostgreSQL), Server, Port, Datenbank, Benutzer, Passwort, Abfrage. Nur Lesen. Jede Spalte des Ergebnisses lässt sich zuordnen.
CUCM	CUCM-Verbindung, Welche Endbenutzer (Alle Endbenutzer (lokal und LDAP), Nur im CUCM angelegte Benutzer, Nur aus dem LDAP synchronisierte Benutzer), nur Benutzer mit Rufnummer, nur aktive Benutzer.
Microsoft Teams	Teams-Tenant. Übernimmt jeden Benutzer des Tenants über Microsoft Graph. Tenants ohne Graph-Zugangsdaten sind nicht wählbar.
Feldzuordnung	Welche Spalte der Quelle welches Feld füllt. Nicht zugeordnete Felder bleiben leer. Bei CUCM und Teams belegt der Server beim Speichern eine Zuordnung vor.
Jetzt abgleichen	Oben für das ganze Telefonbuch, in der Quellenliste für eine einzelne Quelle.
Einträge	Suche über Name, Firma, Nummer, E-Mail. Spalten: Name, Firma, Abteilung, E-Mail, Telefon, Mobil, Quelle.

Ergebnis prüfen und Fehler eingrenzen

Die Kachel des Telefonbuchs zeigt die Zahl der Einträge und Quellen, den Zeitpunkt der letzten Synchronisation und die zugeordneten Teams. zusammengeführt kennzeichnet aktives Zusammenführen.
nie synchronisiert: Klicken Sie auf Jetzt abgleichen.
keinem Team zugeordnet: Agenten sehen das Telefonbuch noch nicht.
Die Quelle konnte nicht gelesen werden. oder eine Meldung der Quelle: Zugangsdaten, Server, Filter bzw. Abfrage prüfen. In der Quellenliste steht die letzte Fehlermeldung unter dem Namen.
Speichern Sie zuerst die Quelle, dann lassen sich Verbindung testen und Spalten lesen.
Eine Person erscheint doppelt: Das Zusammenführen ist aus, oder das Schlüsselfeld ist in einer Quelle leer oder anders geschrieben.
Diagnose Keine Adresse des Anrufdienstes hat geantwortet.: Ohne Anrufdienst gibt es keinen Leitungsstatus. Prüfen Sie den JTAPI-Dienst.
Diagnose Nicht jede aktive CUCM-Verbindung meldet ihre Anrufe für alle Geräte.: Schalten Sie die Live-Überwachung mit allen Geräten ein. Bis dahin wird eine Leitung ohne Anruf nicht als frei gemeldet.
Die getestete Nummer erscheint nicht in den laufenden Anrufen: Vergleichen Sie die Schreibweise. Der Telefonbucheintrag passt nur dann zu einem Anruf, wenn die Ziffern übereinstimmen. Die Zeile Verglichen als zeigt die normalisierte Nummer.