Trunk und Rufregeln in Teams einrichten

Wozu dient das

Damit Teams Anrufe an den EasyUC-SBC schickt, braucht der Teams-Tenant vier Objekte: ein PSTN-Gateway mit dem Hostnamen und Port des SBC, eine PSTN-Nutzung, eine Voice Route mit einem Rufnummernmuster und eine Voice-Routing-Richtlinie. EasyUC legt diese Objekte über Teams PowerShell selbst an und hält sie aktuell.

Das Rufnummernmuster der Voice Route baut EasyUC aus den Nummern der Scripts, bei denen Über MS Teams erreichbar mit diesem Tenant eingeschaltet ist. Teams schickt also nur Anrufe auf diese Script-Nummern über den Trunk. Der SBC weist jede andere Nummer ab. Ohne Script-Nummer legt EasyUC keine Voice Route an.

EasyUC ändert nur seine eigenen Objekte. Sie heißen in der Vorgabe EasyUC- gefolgt vom ersten Namensteil des SBC-Hostnamens. Das Gateway wird ausdrücklich aktiviert, mit SIP-OPTIONS, ohne Media Bypass und mit Weitergabe von History-Info und P-Asserted-Identity angelegt. Die Zuweisung der Richtlinie an einzelne Benutzer nimmt EasyUC hier nicht vor.

Voraussetzungen

Lizenzmodul teams. Ohne dieses Modul erscheint der Workspace EasyUC Teams nicht.
Rolle EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) mit den Unterrechten TENANTS (ROLE_APP_TEAMS_TENANTS) zum Lesen und TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) zum Ändern.
Zertifikat des Tenants ist ausgestellt, der SBC-Dienst läuft, die Firewall ist offen.
Die Domain des SBC-Hostnamens ist im Microsoft-365-Tenant verifiziert.
EasyUC ist an Teams PowerShell angemeldet oder eine App-Registrierung ist hinterlegt (Kapitel „Graph-Zugang und Teams-Admin-Anmeldung“).
Mindestens ein Script ist über diesen Tenant erreichbar und hat eine Nummer (Kapitel „Script über Microsoft Teams erreichbar machen“). Sonst entsteht nur das Gateway ohne Rufregel.
Die Teams-Benutzer, die die Script-Nummern anrufen sollen, haben eine Teams-Phone-Lizenz und Enterprise Voice.

Schritt für Schritt: Trunk zum ersten Mal einrichten

Öffnen Sie Teams-Tenants, klicken Sie auf den Tenant und gehen Sie im Abschnitt Einstellungen zum Kasten Trunk in Teams einrichten.
Prüfen Sie, dass PowerShell-Dienst erreichbar und Angemeldet oder Meldet sich selbst an angezeigt wird.
Prüfen Sie unter Scripts über diesen Trunk, dass Ihre Scripts mit Status Erreichbar aufgeführt sind.
Entscheiden Sie über Für alle Benutzer freischalten (globale Richtlinie). Ohne Haken nutzen nur Benutzer die Rufregeln, denen Sie die EasyUC-Richtlinie zuweisen. Lassen Sie den Haken im Zweifel weg.
Klicken Sie Was passieren würde. Die Vorschau liest nur und verändert im Tenant nichts.
Lesen Sie Die Vorschau deckt diese Nummern ab und Diese Schritte würden laufen. Jeder Schritt trägt ein Etikett: wird angelegt, wird geändert, wird entfernt oder steht bereits so.
Klicken Sie Trunk jetzt einrichten.
Lesen Sie die Rückfrage. Sie nennt Hostname, Port und die Anzahl der Script-Nummern. Bestätigen Sie mit OK.
Warten Sie auf Schritte und ihr Ergebnis. Jeder Schritt zeigt ausgeführt, steht bereits so, fehlgeschlagen oder nicht ausgeführt (abgebrochen).
Prüfen Sie die Zeile In Microsoft eingerichtet. Dort steht ja mit Hostname, Port, aktiviert und sendet SIP-OPTIONS.
Warten Sie einige Minuten und klicken Sie oben rechts auf das Aktualisieren-Symbol. Unter Von Microsoft erreicht steht dann „Microsoft beantwortet unsere OPTIONS“, und OPTIONS von Microsoft zeigt eine aktuelle Uhrzeit.

Schritt für Schritt: Rufregel-Richtlinie Benutzern zuweisen

Ohne globale Freischaltung müssen Sie die EasyUC-Richtlinie den Benutzern selbst zuweisen. EasyUC tut das bei der Trunk-Einrichtung nicht.
Öffnen Sie das Teams Admin Center des Kunden und dort die Voice-Routing-Richtlinien.
Wählen Sie die Richtlinie, deren Name mit EasyUC- beginnt. Den genauen Namen zeigt die Vorschau in EasyUC.
Weisen Sie die Richtlinie den Benutzern zu, die Script-Nummern über Teams anrufen sollen.
Rechnen Sie damit, dass Teams die Zuweisung erst nach einiger Zeit übernimmt.

Schritt für Schritt: Rufregeln nach einer Änderung abgleichen

Wenn Sie ein Script speichern, gleicht EasyUC die Route in Teams selbst ab. Im Script-Formular erscheint „Route in Teams wird aktualisiert …“ und danach „Route in Teams gesetzt“ mit den Nummern.
Ohne App-Registrierung läuft dieser Abgleich nur, solange auf der Tenant-Seite ein Teams-Administrator angemeldet ist.
Für einen Abgleich von Hand öffnen Sie den Kasten Rufregeln für die Script-Nummern und klicken Jetzt abgleichen. Das kann bis zu zwei Minuten dauern.
Lesen Sie das Ergebnis: „Route in Teams gesetzt: …“ oder „Teams abgeglichen: Über diesen Tenant ist keine Script-Nummer mehr erreichbar, deshalb gibt es dort keine EasyUC-Route mehr.“
Soll auch das Gateway oder die globale Richtlinie angepasst werden, klicken Sie stattdessen Routen aktualisieren und bestätigen die Rückfrage. Jetzt abgleichen ändert das PSTN-Gateway und die globale Richtlinie nie.

Schritt für Schritt: Trunk von Hand einrichten oder wieder entfernen

Ohne PowerShell-Dienst klicken Sie Stattdessen von Hand einrichten. EasyUC zeigt, was im Teams-Tenant anzulegen ist, samt dem fertigen Befehl New-CsOnlinePSTNGateway mit Hostname und Port dieses Tenants.
Legen Sie danach in Teams eine Voice Route für die Script-Nummern an und weisen Sie den Benutzern eine Voice-Routing-Richtlinie zu.
Zum Entfernen klicken Sie Trunk entfernen und bestätigen die Rückfrage. EasyUC räumt seine Objekte in umgekehrter Reihenfolge ab. Über den Trunk laufen danach keine Gespräche mehr.
Hängt die PSTN-Nutzung an der globalen Richtlinie, nimmt EasyUC nur seinen eigenen Eintrag wieder heraus. Die Rückfrage weist darauf hin.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
In Microsoft eingerichtet	Konfigurationsstand in Microsoft: noch nicht abgefragt, noch nicht, ja oder vorhanden, weicht aber von diesen Einstellungen ab. Dahinter Hostname, Port, aktiviert/deaktiviert und sendet SIP-OPTIONS/ohne SIP-OPTIONS.
Von Microsoft erreicht	Am eigenen SBC gemessen: ob Microsoft die OPTIONS des SBC beantwortet und wann zuletzt OPTIONS von Microsoft eingingen. Microsoft gibt diesen Zustand über keine Schnittstelle heraus.
Routen in Teams	Stand des letzten Abgleichs: Aktuell, Veraltet oder Noch nie abgeglichen, mit Zeitpunkt.
Jetzt abgleichen	Baut die Rufregeln aus den aktuellen Script-Nummern neu. Ändert nur Voice Route, PSTN-Nutzung und Richtlinie von EasyUC.
Für alle Benutzer freischalten (globale Richtlinie)	Hängt die PSTN-Nutzung dieses Trunks an die Richtlinie Global. Das ändert die Standardrichtlinie aller Benutzer mit Enterprise Voice in diesem Tenant. Gilt nur für Routen aktualisieren. Bei Scripts mit Operator Connect über Teams-Weiterleitung nicht empfohlen.
Was passieren würde	Lesende Vorschau mit abgedeckten Nummern, Schritten und Hinweisen. Meldet „Nichts zu tun: Der Trunk in Microsoft entspricht bereits diesen Einstellungen.“, wenn alles stimmt.
Trunk jetzt einrichten / Routen aktualisieren	Führt die Schritte der Vorschau aus. Die Beschriftung wechselt, sobald das Gateway in Microsoft existiert.
Trunk entfernen	Entfernt Gateway, Voice Route, PSTN-Nutzung und Richtlinie von EasyUC aus dem Teams-Tenant.
Stattdessen von Hand einrichten	Klappt die Anleitung für die Einrichtung ohne PowerShell-Dienst auf.
Diese Befehle sind gelaufen	Liste der ausgeführten Befehle als lesbare Zeilen, zur Dokumentation.

Ergebnis prüfen und Fehler eingrenzen

Erfolg: In Microsoft eingerichtet zeigt ja, Von Microsoft erreicht zeigt „Microsoft beantwortet unsere OPTIONS“, Routen in Teams zeigt Aktuell, und die Tenant-Liste führt den Trunk als aktiv.
Microsoft schickt erst OPTIONS, nachdem die OPTIONS des SBC angekommen sind. Steht der Trunk nach einigen Minuten noch auf gestört oder unbekannt, prüfen Sie Zertifikat, Hostname, TLS-Port und Firewall.
„Microsoft kennt die Domain dieses SBC-Namens in diesem Tenant nicht. …“ Fügen Sie die Domain im Microsoft-365-Administrationsbereich unter Einstellungen → Domänen hinzu und verifizieren Sie sie per TXT-Eintrag. Für einen Namen mit zwei Unterdomänen muss genau die Domain hinter dem ersten Namensteil eingetragen sein.
„Die Anmeldung steht, aber dem Konto fehlen die Rechte. Der App-Registrierung muss die Verzeichnisrolle „Teams-Administrator“ zugewiesen sein.“ Rolle in Microsoft Entra zuweisen.
„Dem Tenant fehlt eine Voraussetzung an Lizenzen. Für Direct Routing brauchen die Benutzer eine Teams-Phone-Lizenz und Enterprise Voice.“ Lizenzen im Tenant prüfen.
„Erst mit einem Teams-Administrator anmelden oder unter Microsoft Graph eine App-Registrierung hinterlegen, dann meldet sich EasyUC selbst an.“ Die Schaltflächen sind gesperrt, bis eine Anmeldung besteht.
„Die Antwort des Abgleichs kam nicht rechtzeitig zurück. Er kann dennoch durchgelaufen sein; der Stand oben wird gleich nachgezogen.“ Warten Sie und laden Sie die Seite neu, bevor Sie erneut abgleichen.
„Das Gateway sendet keine History-Info (ForwardCallHistory aus). Operator Connect über Teams-Weiterleitung braucht sie.“ Betrifft nur Scripts mit Teams-Weiterleitung. Klicken Sie Routen aktualisieren, damit EasyUC das Gateway korrigiert.
Anruf auf die Script-Nummer scheitert, obwohl alles grün ist: Prüfen Sie, ob dem anrufenden Benutzer die EasyUC-Richtlinie zugewiesen ist, und warten Sie die Übernahme durch Teams ab.