Skripte über Microsoft Teams erreichbar machen

Wozu dient das

Ein Skript kann Anrufe annehmen, die in Microsoft Teams gewählt werden oder aus dem Telefonnetz über Teams ankommen. Der Anruf erreicht EasyUC dann über den integrierten Session Border Controller und läuft durch denselben Anrufablauf wie ein CUCM-Anruf.

Es gibt drei Eingänge. Bei Direct Routing verwaltet EasyUC die Voice Route zum eigenen SBC selbst. Bei Operator Connect über Teams-Weiterleitung trägt ein Teams-Dienstkonto die Operator-Connect-Nummer und leitet sofort auf eine Direct-Routing-Pilotnummer weiter; der SBC ordnet den Anruf über die History-Info dem Skript zu. Bei Operator Connect über öffentliche Zielnummer bleibt die Nummer beim Operator und wird über das Telefonnetz auf eine separate Zielnummer weitergeleitet; EasyUC richtet dafür keinen eigenen Laufzeitweg ein.

Microsoft dokumentiert den Weg über die Teams-Weiterleitung nicht. Die Oberfläche kennzeichnet ihn deshalb mit von Microsoft nicht dokumentiert.

Voraussetzungen

Lizenzmodul teams. Für Skripte mit CUCM-Nummer zusätzlich cucm.
Berechtigung für Skripte: ROLE_APP_ACD_WORKSPACE mit ROLE_APP_ACD_SCRIPTS und ROLE_APP_ACD_SCRIPTS_EDIT, ohne ACD-Modul ROLE_APP_TEAMS_WORKSPACE mit ROLE_APP_TEAMS_SCRIPTS und ROLE_APP_TEAMS_SCRIPTS_EDIT. Administratoren mit ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN oder ROLE_SUPER_ADMIN haben alle Rechte des Bereichs.
Ein angebundener, aktiver Teams-Tenant mit eingerichtetem SBC und Trunk (Kapitel „Teams-SBC einrichten“ und „Teams-Tenant und Graph-Anbindung“). Ohne Tenant zeigt das Formular: Es ist noch kein Teams-Tenant angebunden. Bitte zuerst unter „Session Border Controller“ einen anlegen.
Für das automatische Setzen der Voice Route: eine App-Registrierung am Tenant. Ohne sie wird die Route nur gesetzt, solange auf der Tenant-Seite ein Teams-Admin angemeldet ist.
Für Operator Connect über Teams-Weiterleitung: je Eingangsnummer ein eigenes Teams-Dienstkonto mit Teams-Phone-Lizenz und Enterprise Voice, dem die Operator-Connect-Nummer zugewiesen ist, sowie eine freie Direct-Routing-Nummer als Pilot. Am EasyUC-Gateway in Teams muss ForwardCallHistory eingeschaltet sein.

Schritt für Schritt: Direct Routing

Öffnen Sie Calling Features → Anrufe → Calling Features und klicken Sie beim Skript auf Bearbeiten.
Schalten Sie Über MS Teams erreichbar ein. Für ein Skript ohne CUCM-Nummer wählen Sie stattdessen oben bei Erreichbar über die Auswahl Nur Microsoft Teams.
Wählen Sie unter Teams-Tenant den Tenant.
Wählen Sie unter Anrufeingang die Kachel Direct Routing.
Tragen Sie unter In Teams gewählte Nummer die Rufnummer im internationalen Format ein, zum Beispiel +49 40 1234567.
Klicken Sie auf Speichern. EasyUC setzt die Voice Route für diese Nummer in Teams.
Warten Sie die Meldung Route in Teams gesetzt ab. Währenddessen steht dort Route in Teams wird aktualisiert …; das kann bis zu zwei Minuten dauern. Sie können die Seite verlassen, das Ergebnis erscheint auch in der Skriptliste.

Schritt für Schritt: Operator Connect über Teams-Weiterleitung

Öffnen Sie das Skript über Bearbeiten, schalten Sie Über MS Teams erreichbar ein und wählen Sie den Teams-Tenant.
Wählen Sie unter Anrufeingang die Kachel Operator Connect über Teams-Weiterleitung.
Fügen Sie unter Operator-Connect-Nummern die Eingangsnummern hinzu: über Nummer aus dem Inventar hinzufügen oder Nummer von Hand hinzufügen. Je Skript sind höchstens 10 Nummern möglich.
Tragen Sie je Zeile die OC-Nummer und das Teams-Dienstkonto (UPN) ein, dem die Nummer zugewiesen ist.
Tragen Sie unter Pilotnummer (Direct Routing) eine Direct-Routing-Nummer ein, die keinem Benutzer und keiner Ressource zugewiesen ist. Unter Vorschläge bietet EasyUC freie und bereits gemeinsam genutzte Pilotnummern an.
Klicken Sie auf Speichern. Geprüft und eingerichtet wird immer der gespeicherte Stand.
Klicken Sie auf Jetzt prüfen. EasyUC liest über den PowerShell-Dienst, ob Benutzer, Nummer, Richtlinie, Weiterleitung und Pilot passen. Dabei wird nichts geändert.
Klicken Sie in einer Zeile mit Fehler oder Hinweis auf Weiterleitung einrichten.
Lassen Sie Richtlinie zuweisen (EasyUC-Voice-Routing-Richtlinie) und Weiterleitung setzen (sofort auf die Pilotnummer) angehakt. Leitet der Benutzer bereits anders weiter, setzen Sie zusätzlich Bestehende Weiterleitung ersetzen.
Klicken Sie auf Vorschau, prüfen Sie die Geplanten Schritte und klicken Sie auf Ausführen. Bestätigen Sie die Rückfrage.
Klicken Sie erneut auf Jetzt prüfen und rufen Sie die Operator-Connect-Nummer von außen an.

Schritt für Schritt: Operator Connect über öffentliche Zielnummer

Öffnen Sie das Skript über Bearbeiten, schalten Sie Über MS Teams erreichbar ein und wählen Sie den Teams-Tenant.
Wählen Sie unter Anrufeingang die Kachel Operator Connect über öffentliche Zielnummer.
Wählen Sie unter Operator-Connect-Nummer die öffentliche Anrufnummer. Über Suche grenzen Sie die Liste ein.
Tragen Sie unter Öffentliches EasyUC-Ziel eine separate öffentliche Nummer ein, die diesen EasyUC-Server bereits über CUCM, einen SIP-Provider oder eine andere PSTN-Verbindung erreicht.
Klicken Sie auf Speichern.
Richten Sie die Weiterleitung von der Operator-Connect-Nummer zum EasyUC-Ziel beim Operator oder an Ihrem PBX-/SIP-Eingang ein. EasyUC speichert nur die Zuordnung zum Skript und legt für die Operator-Connect-Nummer keine Direct-Routing-Route an.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Über MS Teams erreichbar	Schalter. Gesperrt, wenn kein Tenant angebunden ist; bei reinen Teams-Skripten immer an.
Teams-Tenant	Pflicht. Ein abgeschalteter Tenant zeigt den Hinweis Dieser Tenant ist abgeschaltet. Anrufe kommen erst an, wenn er wieder aktiv ist.
In Teams gewählte Nummer	Nur Direct Routing. `+` gefolgt von Landesvorwahl und Rufnummer, insgesamt 7 bis 16 Ziffern, Eingabe höchstens 40 Zeichen. Leerzeichen, Bindestriche und Klammern werden entfernt. Je Tenant führt eine Nummer zu genau einem Skript.
Operator-Connect-Nummern	Nur Teams-Weiterleitung. Je Zeile OC-Nummer und Teams-Dienstkonto (UPN), dazu der Status der letzten Prüfung: in Ordnung, Hinweis, Fehler, nicht geprüft, unbekannt.
Pilotnummer (Direct Routing)	Nur Teams-Weiterleitung. EasyUC nimmt sie in die Voice Route auf, die Operator-Connect-Nummer nie. Eine gemeinsame Pilotnummer mehrerer Skripte ist möglich; die Skripte werden dann nur über die History-Info unterschieden, ein direkter Anruf auf den Piloten wird abgewiesen.
Jetzt prüfen	Liest den Stand in Teams. Prüfpunkte je Nummer: Teams-Benutzer vorhanden, OC-Nummer zugewiesen, Enterprise Voice aktiv, Teams-Phone-Lizenz vorhanden, Voice-Routing-Richtlinie enthält die EasyUC-Usage, Weiterleitung aktiv (sofort), Weiterleitungsziel ist die Pilotnummer, kein Teams-Gerät eines Vermittlungsplatzes. Für Pilot und Trunk: Pilot steht in der EasyUC-Voice-Route, Pilot ist keinem Objekt zugewiesen, Gateway sendet History-Info, Global-Richtlinie ohne EasyUC-Usage, SBC nimmt den Piloten an.
Weiterleitung einrichten	Ändert über den PowerShell-Dienst nur den gewählten Benutzer. Die Global-Richtlinie bleibt unverändert. Das Ergebnis zeigt unter Stand vorher die frühere Richtlinie und Weiterleitung für den Rückweg.
Anleitung für die manuelle Einrichtung	Sieben Schritte zum Nachvollziehen im Teams Admin Center, falls der PowerShell-Dienst nicht genutzt werden soll.
Operator-Connect-Nummer	Nur öffentliche Zielnummer. Auswahl aus den Nummern, die Microsoft für den Tenant meldet.
Öffentliches EasyUC-Ziel	Nur öffentliche Zielnummer. Internationales Format. Muss sich von der Operator-Connect-Nummer unterscheiden.

Ergebnis prüfen und Fehler eingrenzen

In der Skriptliste steht unter der Nummer die Teams-Nummer mit dem Eingang. Bei der Teams-Weiterleitung zusätzlich über Pilot mit der Pilotnummer und der Prüfstatus.
Die Route in Teams wurde nicht aktualisiert oder Die Route in Teams konnte nicht aktualisiert werden, jeweils mit Begründung: Öffnen Sie über Zur Tenant-Seite den Tenant und prüfen Sie App-Registrierung bzw. Teams-Admin-Anmeldung.
Die Teams-Nummer muss im internationalen Format mit führendem + angegeben werden, zum Beispiel +49 40 1234567.
Bitte den Teams-Tenant auswählen, über den das Script erreichbar sein soll.
Operator-Connect-Nummer und Pilotnummer dürfen nicht identisch sein, damit keine Rufschleife entsteht.
Die Nummer … ist Teams-Gerät eines Vermittlungsplatzes. Eine Übergabe dorthin liefe über die Weiterleitung zurück in EasyUC (Rufschleife). Bitte ein eigenes Dienstkonto verwenden.
Die Nummer … ist in diesem Tenant bereits vergeben (Script „…“). Je Tenant führt eine Nummer zu genau einem Skript.
Das EasyUC-Gateway in Teams sendet keine History-Info (ForwardCallHistory ist aus). Ohne sie kann der SBC eine weitergeleitete Operator-Connect-Nummer nicht zuordnen. Schalten Sie ForwardCallHistory am Gateway ein.
Der PowerShell-Dienst für Microsoft Teams ist nicht erreichbar. Prüfung und Einrichtung sind dann nicht möglich; verwenden Sie die Anleitung für die manuelle Einrichtung.
Grenzen der Teams-Weiterleitung laut Oberfläche: Jede Eingangsnummer braucht ein Dienstkonto mit Teams-Phone-Lizenz. Wie viele Anrufe gleichzeitig über eine Benutzernummer laufen, ist nicht geprüft. Der Benutzer kann die Weiterleitung selbst ändern, prüfen Sie den Stand deshalb regelmäßig.