Skip to main content

MS Teams

Bitte befolgen Sie nachfolgende Anleitung für die initiale Einbindung von Microsoft Teams in unsere Telefonanlage. Bei Fragen oder Anmerkungen können Sie uns via support@wwcom.ch oder +41 41 541 41 41 kontaktieren.

Voraussetzungen für die Einbindung von Microsoft Teams
    -    Microsoft 365 E5 Lizenz oder
    -    Microsoft 365 E3, mit "Phone System" Lizenz oder
    -    Microsoft 365 Business Standard, mit "Business Voice" Lizenz
    -    Kompatibel ab wwcommunicator Version KVM302

Schritt 1

Zuerst muss man eine Teams-Domain festlegen, üblicherweise als Subdomain der Hauptdomain (z.b. teams.wwcom.ch). Nicht zu vergessen einen A-Record eintrag zu machen auf die Telefonanlage dass diese auch gefunden wird (z.b. teams.wwcom.ch <IP der Telefonanlage>).

Anschliessend muss man die Domain bei Microsoft aktivieren/überprüfen. Dies lässt sich mit nachfolgenden Schritten bewerkstelligen:

  1. Melden Sie sich auf https://admin.microsoft.com/AdminPortal/Home#/Domains an und geben Sie dort den FQDN an. Notieren Sie sich den TXT-Name / TXT-Wert.
  2. TXT-Name" / "TXT-Wert auf dem DNS-Server der entsprechenden Domain eintragen
  3. Melden Sie sich wiederum auf https://admin.microsoft.com/AdminPortal/Home#/Domains an und klicken Sie auf "überprüfen"


Schritt 2

Bitte tragen Sie folgende DNS-Einträge für die entsprechende Domain ein:

dns-records.png


Schritt 3

Skype for Business Onlinedienst aktivieren:

  1. Auf https://admin.microsoft.com/AdminPortal/Home#/Domains "Skype for Business" auswählen und auf "weiter" klicken

  2. Anschliessend auf "DNS-Einstellungen aktualisieren" auf "überprüfen" klicken

  3. Danach sollte in der Übersicht "Healthy" für Ihre entsprechende Subdomain erscheinen

    online-dienst.png


Schritt 4

Bitte weisen Sie bei allen Benutzern die korrekten Microsoft Lizenzen zu.

MS Lizenzen

  • Bei Enterprise Lizenzen braucht es entweder eine E5 Lizenz (keine weitere Zusatzlizenz nötig) oder eine E3 Lizenz mit Phone System add-on (und, falls Konferenzen getätigt werden sollen, Audio Conferencing add-on).
  • Bei Microsoft 365 Business Lizenzen braucht es zusätzlich pro Benutzer die Business Voice Lizenz.

ms-lizenzen.png


Schritt 5

Im wwcommunicator unter "PBX Einstellungen" die Option "Teams-Kompatibilitätsmodus" aktivieren. Ebenso sicherstellen, dass "TLS zulassen" und "SRTP zulassen" aktiviert wurden. Zudem muss die Domain der Teams-Domain gleichgesetzt werden. Der Hostname kann frei gewählt werden (z.B. pbx als Hostname und beispielfirma.ch als Domain, wodurch sich der FQDN pbx.beispielfirma.ch für die PBX ergibt). Danach ist vorzugsweise "Let's Encrypt Zertifikat verwenden" zu aktivieren.

teams-komp.png     tls-strp.png

  1. Einen A-Record auf dem DNS-Server erzeugen, welcher auf die IP der PBX zeigt
  2. Die PBX neu starten
  3. Bis die Telefonzentrale unter dem neuen FQDN erreichbar ist, kann es eine Weile dauern (abhängig von den TTL Einstellungen auf dem DNS)
  4. Alle Benutzer auf der PBX erstellen. Wichtig: der Benutzername muss identisch sein, wie der Microsoft 365 Benutzername (ohne @Domain). Beispiel: wenn der Microsoft 365 Benutzer hans.beispiel@beispielfirma.ch heisst, so muss der Benutzer auf der PBX hans.beispiel heissen.
  5. Bei jedem Teams Benutzer ist nach dem Erstellen die Option "Microsoft Teams Benutzer" zu aktivieren und die Telefonnummer, mit welcher der Benutzer in der Teams Umgebung verknüpft werden wird, unter "MS Teams Telefonnummer" einzutragen.

user-settings.png


Schritt 6

PBX anbinden und Benutzer aktivieren

Voraussetzung ist ein installiertes Teams-Modul in Ihrer Powershell.

Sollten Sie dieses Modul noch nicht installiert haben, kann dies mit folgenden Schritten installiert werden:

Bevor Sie die Teams Anbindung einrichten können, muss das MicrosofTeams Modul installiert werden. Hierzu öffnen Sie die Powershell als Adminisrator und führen Sie den folgenden Befehl aus:

Install-Module MicrosoftTeams

Danach folgen Sie den Anweisungen in der Konsole.

Powershell mit dem Teams Server verbinden, Trunk und Benutzer einrichten

  1. Verbinden mit dem Teams Server
  2. Powershell als Administrator öffnen

    1. führen Sie folgenden Befehl aus:


      Connect-MicrosoftTeams -Credential $credential

PSTN-Gateway erstellen

    1. Gateway erstellen und Direct Routing Service verbinden

      New-CsOnlinePSTNGateway -Fqdn MSTEAMS_URL -MaxConcurrentSessions 100 -Enabled $true -ForwardPai $true -ForwardCallHistory $true

       

      Sie werden nun nach dem SipSignalingPort (PORT_VON_SBC) gefragt. Geben Sie hier 5061 ein.

    2. Mit dem folgenden Befehl kann die Konfiguration überprüft werden:


      Get-CsOnlinePSTNGateway

Voice Routing und entsprechende Policy einrichten

    1. PSTN-Usage erstellen


      Set-CsOnlinePstnUsage -Identity Global -Usage @{Add="VPBXRoute"}
    2. Route erstellen, der Wert MSTEAMS_URL wird Ihnen mitgeteilt


      New-CsOnlineVoiceRoute -Identity "VPBXRoute" -OnlinePstnGatewayList MSTEAMS_URL -Priority 1 -OnlinePstnUsages "VPBXRoute" -NumberPattern ".*"
    3. Überprüfen der Route


      Get-CsOnlineVoiceRoute
    4. User-Routing-Policy erstellen


      New-CsOnlineVoiceRoutingPolicy "VPBXRoute" -OnlinePstnUsages "VPBXRoute"
    5. Überprüfen der User-Routing-Policy


      Get-CsOnlineVoiceRoutingPolicy

Benutzer aktivieren

Damit nun ein Benutzer aktiviert und mit einer Nummer ausgestattet werden kann, muss sich dieser im Microsoft 365-Admin-Portal bereits erstellt worden sein. Bei weiteren Benutzern sind jeweils nur die Aktivierung und das Zuweisen der Voice Routing Policy nötig. Die vorhergehenden Schritte sind nicht mehr notwendig.

    1. Benutzer aktivieren, Telefonnummer und Voicemail Box zuweisen und danach die Routing-Policy zuweisen:


      Set-CsPhoneNumberAssignment -Identity "OFFICE365_USER" -PhoneNumber "RUFNUMMER mit +41" -PhoneNumberType DirectRouting
      Grant-CsOnlineVoiceRoutingPolicy -Identity "OFFICE365_USER" -PolicyName "VPBXRoute"

Schritt 7

MS Teams UUID pro Benutzer auslesen

  1. Geben Sie in der Powershell den folgenden Befehl ein, um die UUID eines Benutzers auszulesen:


    Get-CsOnlineuser -Identity "OFFICE365_USER" | Out-String -stream | Select-String -Pattern "ObjectId"
  2. Die ObjectId in das Feld "MS Teams UUID" auf der PBX eintragen

uuid.png


Schritt 8

Nächster Schritt: Die PBX an Azure anbinden, damit die Graph API angesteuert werden kann:

  1. Die URL https://portal.azure.com/ öffnen, Menü -> Azure Active Directory >App-Registrierungen
  2. Neue Registrierung, Name: wwcomteamsbridge
    1. Nur Konten in diesem Organisationsverzeichnis
    2. Umleitungs-URI: https://pbx.beispielfirma.ch/oauth/
  3. Zertifikate & Geheimnisse: Clientschlüssel erzeugen und den öffentlichen Schlüssel unter "PBX Einstellungen"->"Teams App Key" speichern, sowie die App ID kopieren und unter "Teams App id" speichern
  4. API-Berechtigungen: User.Read, Presence.Read, Presence.ReadAll
  5. Danach die PBX an der Microsoft Umgebung anmelden, damit ein Presence-Abgleich ermöglicht wird:
    1. https://pbx.beispielfirma.ch/oauth/ aufrufen
    2. Zugangsdaten eingeben
    3. Zugriffsrechte bestätigen

teams-api.jpg


Schritt 9

MS Teams Status-Mapping definieren via wwcommunicator:

status-mapping.png

Weitere Einstellungs-Optionen zum wwcommunicator können Sie diesem Wiki in der Rubrik "wwcommunicator" entnehmen.