Teams Direct Routing von Anfang bis Ende

Wozu dient das

Dieses Kapitel führt in einer festen Reihenfolge durch die gesamte Einrichtung von Microsoft Teams Direct Routing mit dem integrierten SBC von EasyUC. Am Ende ruft ein Teams-Benutzer eine Nummer an und landet in einem EasyUC-Script. Jede Stufe verweist auf das Kapitel mit den Einzelheiten.

Zum Verständnis: Der Teams-Tenant schickt Anrufe auf bestimmte Nummern über einen verschlüsselten SIP-Trunk an den SBC auf dem EasyUC-Server. Der SBC übergibt sie an das Script, das zu der Nummer gehört. Dort laufen Ansagen, Menüs, Warteschlangen, Agenten oder der Vermittlungsplatz. In der Gegenrichtung stellt EasyUC Anrufe über denselben Trunk an Teams-Benutzer zu, zum Beispiel an Vermittlungskräfte mit Teams-Gerät.

Der SBC nimmt aus Teams nur Anrufe auf Script-Nummern an. Die Reihenfolge ist deshalb: Netz, SBC, Tenant, Zertifikat, Anmeldung, Script mit Nummer, Trunk und Rufregeln, Richtlinie für die Benutzer, Testanruf.

Voraussetzungen

• EasyUC ist installiert, das Lizenzmodul teams ist vorhanden und im EasyUC Manager eingeschaltet.
• Ein EasyUC-Benutzer mit der Rolle EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) und den Unterrechten SBC bearbeiten, TENANTS bearbeiten und SCRIPTS bearbeiten.
• Eine feste öffentliche IPv4-Adresse und Zugriff auf Firewall und NAT.
• Zugriff auf die öffentliche DNS-Zone der Kundendomain.
• Ein Administrator des Microsoft-365-Tenants: für die Domain, für eine App-Registrierung mit Administratorzustimmung und mit der Rolle Teams-Administrator.
• Teams-Benutzer mit Teams-Phone-Lizenz und Enterprise Voice für den Test.

Schritt für Schritt, Stufe 1: Netz und DNS vorbereiten

1. Legen Sie den Hostnamen fest, zum Beispiel sbc.kunde.de, und einen DNS-A-Record auf die öffentliche IP.
2. Prüfen Sie, dass die Domain des Hostnamens im Microsoft-365-Tenant verifiziert ist.
3. Geben Sie eingehend TCP 5061 und UDP 20000 bis 20999 aus den Netzen 52.112.0.0/14 und 52.120.0.0/14 frei, ausgehend TCP 5061 zu Microsoft.
4. Einzelheiten: Kapitel „DNS, öffentliche IP und Firewall für den SBC“.

Schritt für Schritt, Stufe 2: SBC einschalten

1. Öffnen Sie EasyUC Teams → Teams → SBC-Einrichtung und klicken Sie Integrierten SBC einschalten.
2. Tragen Sie Öffentliche IP, Media-IP und Kontakt-E-Mail ein. Lassen Sie Umgebung auf Produktion und Prüfverfahren auf DNS-01.
3. Klicken Sie Integrierten SBC einschalten und prüfen Sie, dass SBC-Dienst mit zuletzt gesehen erscheint.
4. Einzelheiten: Kapitel „Teams-SBC einschalten und Netzangaben festlegen“.

Schritt für Schritt, Stufe 3: Tenant anlegen und Zertifikat holen

1. Öffnen Sie Teams-Tenants und klicken Sie Tenant hinzufügen.
2. Tragen Sie Kundenname, SBC-Hostname für diesen Tenant und Verzeichnis-ID (Tenant-ID) ein und klicken Sie Erstellen.
3. Öffnen Sie den Tenant und klicken Sie im Kasten Zertifikat für diesen Hostnamen auf Zertifikat anfordern.
4. Legen Sie den angezeigten TXT-Eintrag im DNS an und klicken Sie Jetzt prüfen und ausstellen, bis ausgestellt, gültig bis erscheint.
5. Einzelheiten: Kapitel „Teams-Tenant anlegen und verwalten“ und „SBC-Zertifikat je Tenant“.

Schritt für Schritt, Stufe 4: Microsoft-Zugang hinterlegen

1. Registrieren Sie im Tenant des Kunden eine Anwendung mit den Graph-Berechtigungen User.Read.All, Presence.Read.All, TeamworkDevice.Read.All und Organization.Read.All, erteilen Sie die Administratorzustimmung und weisen Sie ihr die Verzeichnisrolle Teams-Administrator zu.
2. Tragen Sie auf der Tenant-Seite unter Microsoft Graph die Anwendungs-ID (Client-ID) und den Geheimen Clientschlüssel ein und klicken Sie Speichern.
3. Klicken Sie Zugangsdaten prüfen, bis Geprüft erscheint.
4. Prüfen Sie im Kasten Trunk in Teams einrichten, dass PowerShell-Dienst erreichbar und Meldet sich selbst an angezeigt wird. Ohne App-Registrierung klicken Sie Mit Teams-Admin anmelden.
5. Einzelheiten: Kapitel „Graph-Zugang und Teams-Admin-Anmeldung“.

Schritt für Schritt, Stufe 5: Script mit Teams-Nummer anlegen

1. Öffnen Sie die Script-Liste und klicken Sie IVR anlegen.
2. Vergeben Sie einen Name, setzen Sie Über MS Teams erreichbar, wählen Sie den Teams-Tenant und die Karte Direct Routing.
3. Tragen Sie die In Teams gewählte Nummer ein, zum Beispiel +49 40 1234567, und klicken Sie Speichern.
4. Einzelheiten: Kapitel „Script über Microsoft Teams erreichbar machen“.

Schritt für Schritt, Stufe 6: Trunk und Rufregeln in Teams einrichten

1. Öffnen Sie die Tenant-Seite und prüfen Sie unter Scripts über diesen Trunk den Status Erreichbar.
2. Klicken Sie Was passieren würde und lesen Sie die Vorschau.
3. Klicken Sie Trunk jetzt einrichten und bestätigen Sie die Rückfrage.
4. Prüfen Sie In Microsoft eingerichtet: ja. Nach einigen Minuten zeigt Von Microsoft erreicht „Microsoft beantwortet unsere OPTIONS“.
5. Weisen Sie im Teams Admin Center die Voice-Routing-Richtlinie mit dem Namen EasyUC-… den Benutzern zu, die die Script-Nummer anrufen sollen. Alternativ setzen Sie vor der Einrichtung den Haken Für alle Benutzer freischalten (globale Richtlinie).
6. Einzelheiten: Kapitel „Trunk und Rufregeln in Teams einrichten“.

Schritt für Schritt, Stufe 7: Rufnummern zuweisen und Testanruf

1. Sollen Benutzer eigene Rufnummern bekommen, weisen Sie sie im Abschnitt Nummernplan über Aktionen → Zuweisen … zu (Kapitel „Teams-Nummernplan und Rufnummernzuweisung“).
2. Warten Sie einige Minuten, bis Teams Route und Richtlinie übernommen hat.
3. Wählen Sie in der Tenant-Leiste Anrufe anzeigen.
4. Rufen Sie die Script-Nummer aus dem Teams-Client eines Benutzers mit der EasyUC-Richtlinie an.
5. Der Anruf erscheint in Anrufe anzeigen, und Sie hören die Begrüßung des Scripts.
6. Öffnen Sie danach Anrufverlauf, klicken Sie auf den Anruf und prüfen Sie das SIP-Leiterdiagramm.
7. Bei Fehlern: Kapitel „Teams-Anrufe, SIP-Verlauf und Mitschnitte“.

Felder und Optionen

Ergebnis prüfen und Fehler eingrenzen

• Erfolg: Zertifikat gültig, Trunk aktiv, Letztes OPTIONS aktuell, Script Erreichbar, Routen in Teams Aktuell, und der Testanruf erreicht die Begrüßung.
• SBC-Dienst meldet sich nicht: Stufe 2 prüfen, Dienst im EasyUC Manager kontrollieren.
• Zertifikat bleibt auf DNS-Eintrag nötig: TXT-Eintrag ist öffentlich noch nicht sichtbar oder hat einen alten Wert.
• „Microsoft kennt die Domain dieses SBC-Namens in diesem Tenant nicht.“ Domain im Microsoft-365-Tenant verifizieren (Stufe 1).
• Trunk bleibt gestört: Firewall für TLS-Port eingehend und TCP 5061 ausgehend prüfen, Umgebung Produktion statt Staging, Hostname exakt wie im Zertifikat.
• Teams meldet beim Wählen sofort einen Fehler und der Anruf fehlt im Anrufverlauf: Dem Benutzer fehlt die EasyUC-Richtlinie, oder Teams hat sie noch nicht übernommen.
• Anruf steht im Verlauf, wird aber abgewiesen: Die Nummer gehört zu keinem aktiven Script dieses Tenants. Tenant-Seite, Scripts über diesen Trunk prüfen.
• Anruf wird angenommen, kein Ton: Öffentliche IP, Media-IP und UDP-Freigabe prüfen.
• Für Nummern aus Operator Connect gilt ein eigener Weg: Kapitel „Operator Connect über Teams-Weiterleitung“.