Zuletzt bearbeitet vor 2 Monaten
von Tim Hagedorn

VoIP Telefonie/vPBX/Anbindung MS Teams an vPBX: Unterschied zwischen den Versionen

VisuellWikitext
KKeine Bearbeitungszusammenfassung
KKeine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Zeile 417: Zeile 417:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-4-in-azure-wert-schlüssel-paar-erzeugen-und-auf-vpbx-übertragen"></span>
=== Schritt 4: In Azure Wert-Schlüssel-Paar erzeugen und auf vPBX übertragen ===
= Schritt 4: In Azure Wert-Schlüssel-Paar erzeugen und auf vPBX übertragen =


{{Info
{{Textbox
|body =  
|boxtype=tip
|header=
|text=


In diesem Schritt wird in Azure ein Wert-Schlüssel-Paar ("Teams app id" / "Teams app key") erstellt, welches zur Abfrage des Presence-Status von MS Teams nötig ist.
In diesem Schritt wird in Azure ein Wert-Schlüssel-Paar ("Teams app id" / "Teams app key") erstellt, welches zur Abfrage des Presence-Status von MS Teams nötig ist.


}}
|icon=yes}}




Zeile 436: Zeile 437:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="anwendungs-id-client-erstellen"></span>
==== "Anwendungs-ID (Client)" erstellen ====
== "Anwendungs-ID (Client)" erstellen ==




Zeile 641: Zeile 641:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="geheimer-clientschlüssel-erzeugen"></span>
==== "Geheimer Clientschlüssel" erzeugen ====
== "Geheimer Clientschlüssel" erzeugen ==




Zeile 653: Zeile 652:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


Unter "Zertifikate &amp; Geheimnisse" auf '''"Neuer geheimer Clientschlüssel"''' klicken, ...
Unter "Zertifikate & Geheimnisse" auf '''"Neuer geheimer Clientschlüssel"''' klicken, ...




Zeile 707: Zeile 706:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="api-berechtigungen"></span>
==== API-Berechtigungen ====
== API-Berechtigungen ==




Zeile 734: Zeile 732:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="authentifizierung-der-vpbx-an-teams"></span>
==== Authentifizierung der vPBX an Teams ====
== Authentifizierung der vPBX an Teams ==




Zeile 746: Zeile 743:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span>Zum Abschluss die vPBX an der Microsoft Umgebung anmelden:</span>
Zum Abschluss die vPBX an der Microsoft Umgebung anmelden:


* https://teams.ihredomain.ch/oauth/ im Browser aufrufen
* https://teams.ihredomain.ch/oauth/ im Browser aufrufen
Zeile 761: Zeile 758:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-5-aktivieren-von-microsoft-teams-benutzer-und-eintragen-der-ms-teams-telefonnummer-pro-teilnehmer-auf-der-vpbx"></span>
=== Schritt 5: Aktivieren von "Microsoft Teams Benutzer" und Eintragen der "MS Teams Telefonnummer" pro Teilnehmer auf der vPBX ===
= Schritt 5: Aktivieren von "Microsoft Teams Benutzer" und Eintragen der "MS Teams Telefonnummer" pro Teilnehmer auf der vPBX =
 


</div>
</div>
Zeile 795: Zeile 790:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-6-in-powershell-an-teams-anmelden"></span>
=== Schritt 6: Konfiguration Direct Routing Service ===
= <span style="font-size: 24.0px;letter-spacing: -0.01em;">Schritt 6: In Powershell an Teams anmelden</span> =




Zeile 803: Zeile 797:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


'''Powershell-Befehle'''
Unter "VoIP" / "Direct Routing" den SBC wie folgt eintragen:




Zeile 813: Zeile 807:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


'''Anmerkungen / Screenshots'''
[[File:KB_VoIP_Telefonie_Anbindung_MS_Teams_an_Business_Trunk_Anleitung_Anbindung_MS_Teams_an_Business_Trunkimage-2023-10-4_13-18-53.png]]




Zeile 820: Zeile 814:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section single">
 
<div class="ac-layout-cell">
 
<span id="import-des-microsoftteams-moduls"></span>
====== Import des MicrosoftTeams Moduls ======
 
<syntaxhighlight>Import-Module MicrosoftTeams</syntaxhighlight>
<br />
 
 
 
<br />
 
 


</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span>Falls das Modul noch nicht installiert ist, wie folgt installieren:</span>
=== Schritt 7: VoIP-Routingrichtlinie erstellen ===
 
<syntaxhighlight>Find-Module -Name MicrosoftTeams | Install-Module</syntaxhighlight>
Falls keine Rechte für's Ausführen von Scripten:
 
<syntaxhighlight>Set-ExecutionPolicy Unrestricted</syntaxhighlight>
Changelog Microsoft Teams PowerShell: https://docs.microsoft.com/de-de/MicrosoftTeams/teams-powershell-release-notes
 
<span id="modul-upgraden"></span>
====== Modul upgraden ======
 
<syntaxhighlight>Update-Module MicrosoftTeams</syntaxhighlight>
Welche Version vom MicrosoftTeams-Modul ist installiert?


<syntaxhighlight>Get-InstalledModule -Name MicrosoftTeams</syntaxhighlight>


</div>
</div>
Zeile 859: Zeile 825:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="credentials-objekt-erstellen-zugangsdaten-eines-office365-admins-werden-benötigt"></span>
Unter "VoIP" / "<span style="letter-spacing: 0.0px;">VoIP-Routingrichtlinie"</span><span style="letter-spacing: 0.0px;"> die entsprechende VoIP-Routingrichtlinie erstellen:</span>
====== Credentials-Objekt erstellen (Zugangsdaten eines Office365-Admins werden benötigt) ======
 
<syntaxhighlight>Connect-MicrosoftTeams</syntaxhighlight>


</div>
<div class="ac-layout-cell">


Hier müssen die Zugangsdaten vom Admin-User eingegeben werden.
</div>[[Datei:Anbindung MS Teams an Business Trunk 1707724487231.png]]<div class="ac-layout-cell">


<br />
<br />




Zeile 885: Zeile 845:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-7-pstn-gateway-erstellen-einmalig"></span>
=== Schritt 8: VoIP-Route erstellen ===
= <span style="color: rgb(23,43,77);">Schritt 7: PSTN-Gateway erstellen </span>(einmalig) =




Zeile 893: Zeile 852:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


MSTEAMS_FQDN = teams.ihredomain.ch
Unter "VoIP" / "Direct Routing" / "VoIP-Routen" die entsprechende Route erstellen:
<br />
 
<span id="gateway-erstellen-und-direct-routing-service-verbinden-msteams_url-wird-ihnen-von-iway-ag-mitgeteilt"></span>
====== Gateway erstellen und Direct Routing Service verbinden (MSTEAMS_URL wird Ihnen von iWay AG mitgeteilt) ======
 
<syntaxhighlight>New-CsOnlinePSTNGateway -Fqdn MSTEAMS_FQDN -MaxConcurrentSessions 100 -Enabled $true -ForwardPai $true -ForwardCallHistory $true</syntaxhighlight>
{{Note
|body =
 
Sie werden nun nach dem SipSignalingPort (PORT_VON_SBC) gefragt. Geben Sie hier 5061 ein.
 
}}




Zeile 915: Zeile 862:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


Mit dem folgenden Befehl kann die Konfiguration überprüft werden:
[[File:KB_VoIP_Telefonie_Anbindung_MS_Teams_an_Business_Trunk_Anleitung_Anbindung_MS_Teams_an_Business_Trunkimage-2023-10-23_14-40-39.png|center]]
 
<syntaxhighlight>Get-CsOnlinePSTNGateway</syntaxhighlight>
PSTN-Gateway wieder löschen:


<syntaxhighlight>Remove-CsOnlinePSTNGateway -Identity MSTEAMS_FQDN</syntaxhighlight>


</div>
</div>
Zeile 930: Zeile 873:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-8-voice-routing-und-entsprechende-policy-einrichten-einmalig"></span>
=== Schritt 9: Rufnummern den Benutzern zuweisen ===
= Schritt 8: Voice Routing und entsprechende Policy einrichten (einmalig) =
 


</div>
</div>
Zeile 938: Zeile 879:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="pstn-usage-erstellen"></span>
Unter "Benutzer" den entsprechenen Benutzer bearbeiten, auf "Bearbeiten" klicken ...
== PSTN-Usage erstellen ==


<syntaxhighlight>Set-CsOnlinePstnUsage -Identity Global -Usage @{Add="Unrestricted"}</syntaxhighlight>


</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<br />
[[File:KB_VoIP_Telefonie_Anbindung_MS_Teams_an_Business_Trunk_Anleitung_Anbindung_MS_Teams_an_Business_Trunkimage-2023-10-4_13-21-36.png]]
 




Zeile 958: Zeile 896:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="route-erstellen"></span>
... und auf der rechten Seite die Telefonnummer im <span style="color: rgb(51,51,51);">im internationalen Format (E.164), z. B. </span>+41435001111 eintragen:
== Route erstellen ==


<syntaxhighlight>New-CsOnlineVoiceRoute -Identity "Unrestricted" -OnlinePstnGatewayList MSTEAMS_FQDN -Priority 1 -OnlinePstnUsages "Unrestricted" -NumberPattern ".*"</syntaxhighlight>


</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">


Überprüfen der Route
[[File:KB_VoIP_Telefonie_Anbindung_MS_Teams_an_Business_Trunk_Anleitung_Anbindung_MS_Teams_an_Business_Trunkimage-2023-10-4_13-24-10.png|center]]
 
<syntaxhighlight>Get-CsOnlineVoiceRoute</syntaxhighlight>
OnlineVoiceRoute wieder löschen:


<syntaxhighlight>Remove-CsOnlineVoiceRoute -Identity "Unrestricted"</syntaxhighlight>


</div>
</div>
Zeile 981: Zeile 913:
</div>
</div>
{{Layout}}
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-section two_left_sidebar">


<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="user-routing-policy-erstellen"></span>
Dem User die die <span>VoIP-Routingrichtlinie </span>"Unrestricted" <span style="letter-spacing: 0.0px;">zuweisen:</span>
== <span>User-Routing-Policy erstellen</span> ==


<syntaxhighlight>New-CsOnlineVoiceRoutingPolicy "Unrestricted" -OnlinePstnUsages "Unrestricted"</syntaxhighlight>


</div>
</div>
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span>Überprüfen der User-Routing-Policy:</span>
[[File:KB_VoIP_Telefonie_Anbindung_MS_Teams_an_Business_Trunk_Anleitung_Anbindung_MS_Teams_an_Business_Trunkimage-2023-11-10_15-55-0.png]]
 
<syntaxhighlight>Get-CsOnlineVoiceRoutingPolicy</syntaxhighlight>
OnlineVoiceRoutingPolicy wieder löschen:
<br />
 


<syntaxhighlight>Remove-CsOnlineVoiceRoutingPolicy -Identity "Unrestricted"</syntaxhighlight>


</div>
</div>
Zeile 1'010: Zeile 934:
<div class="ac-layout-cell">
<div class="ac-layout-cell">


<span id="schritt-9-benutzer-aktivieren-und-ms-teams-uuid-auf-vpbx-eintragen-für-jeden-benutzer"></span>
= Schritt 9: Benutzer aktivieren und MS Teams UUID auf vPBX eintragen (für jeden Benutzer) =
</div>
</div>
{{Layout}}
<div class="ac-layout-section single">
<div class="ac-layout-cell">
<span id="powershell-einträge"></span>
== <span style="font-size: 20.0px;letter-spacing: -0.008em;">Powershell-Einträge</span> ==
</div>
</div>
{{Layout}}
<div class="ac-layout-section two_equal">
<div class="ac-layout-cell">
<span style="letter-spacing: 0.0px;font-size: 16.0px;">Benutzer aktivieren, Telefonnummer und Voicemail Box zuweisen:</span>
{| class="wikitable wrapped"
|-
| OFFICE365_USER
| Username des Microsoft 365-Accounts (z. B.: max.muster@ihredomain.ch)
|-
| RUFNUMMER
| "MS Teams Telefonnummer" der vPBX im Format +41435001111
Update 1.7.21: Offensichtlich können dort beliebige Nummern gewählt werden, auch z. B. vierstellige, interne Nummern.
|}
<syntaxhighlight>Set-CsPhoneNumberAssignment -Identity OFFICE365_USER -PhoneNumber RUFNUMMER -PhoneNumberType DirectRouting
Set-CsPhoneNumberAssignment -Identity OFFICE365_USER -EnterpriseVoiceEnabled $true</syntaxhighlight>
<span style="font-size: 16.0px;letter-spacing: -0.006em;">Zuweisen der User-Routing-Policy:</span>
<syntaxhighlight>Grant-CsOnlineVoiceRoutingPolicy -Identity OFFICE365_USER -PolicyName "Unrestricted"</syntaxhighlight>
</div>
<div class="ac-layout-cell">
[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-39-38.png]]
<br />


-----




Zeile 1'070: Zeile 945:


<div class="ac-layout-cell">
<div class="ac-layout-cell">
=== Hinweise zum Status nach der Inbetriebnahme ===


<span id="ms-teams-uuid-pro-benutzer-auslesen-und-in-die-vpbx-übertragen"></span>
==== Ein- und ausgehende Telefonie kann evtl. nicht sofort nach der Inbetriebnahme funktionieren ====
== MS Teams UUID pro Benutzer auslesen und in die vPBX übertragen ==
{{Textbox
 
|boxtype=tip
 
|header=
</div>
|text=
 
Es kann sein, dass die ein- und ausgehende Telefonie erst ein paar Minuten nach der Inbetriebnahme funktioniert.
</div>
|icon=yes}}
{{Layout}}
<div class="ac-layout-section two_equal">
 
<div class="ac-layout-cell">
 
Neue PowerShell Session mit dem Azure Active Directory verbinden
 
<syntaxhighlight>Import-Module AzureAD
Connect-AzureAD</syntaxhighlight>
 
</div>
<div class="ac-layout-cell">
 
<span>Falls das Modul noch nicht installiert ist, wie folgt installieren:</span>
 
<syntaxhighlight>Find-Module -Name AzureAD | Install-Module</syntaxhighlight>
 
</div>
 
</div>
{{Layout}}
<div class="ac-layout-section two_equal">


<div class="ac-layout-cell">
==== Unter "VoIP" / "Direct Routing" können Fehler angezeigt werden ====
 
Es kann sein, dass  unter "VoIP" / "Direct Routing" können Fehler angezeigt werden, wie diese hier:
Pro Benutzer die '''ObjectId''' auslesen...
 
<syntaxhighlight>Get-AzureADUser -ObjectId "vorname.nachname@ihredomain.ch"</syntaxhighlight>
 
</div>
<div class="ac-layout-cell">
 
<span>Ausgabe wie folgt:<br />
</span>
 
<syntaxhighlight>ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
abcabcab-abca-abca-abca-abcabcabcabc Hans Beispiel hans.beispiel@ihredomain.ch Member</syntaxhighlight>
 
</div>
 
</div>
{{Layout}}
<div class="ac-layout-section two_equal">
 
<div class="ac-layout-cell">
 
...und auf beim vPBX-Teilnehmer im Feld '''"MS Teams UUID"''' auf der vPBX eintragen:
 
<br />
 
 
 
</div>
<div class="ac-layout-cell">
 
[[File:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-30-31.png]]
 
 
</div>
 
</div>
 
</div>
[[Category:Teams]] [[Category:Vpbx]] [[Category:Microsoft]] [[Category:Ms]]
{{AttachmentsSectionStart}}
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_16-51-19.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_17-4-57.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_17-35-19.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-2-25_14-31-35.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-2-25_14-32-51.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2020-2-18_16-46-51.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-45-29.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-46-20.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-47-6.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-53-14.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-10-24.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-10-43.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-7-15_13-39-32.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2020-2-18_16-46-51.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-2-25_14-32-51.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-2-25_14-31-35.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-10-43.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_17-10-24.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-53-14.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-47-6.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-46-20.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-3-18_16-45-29.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_17-4-57.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_16-51-19.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-1-14_17-35-19.png]]
* [[Medium:KB_VoIP_Telefonie_vPBX_Anbindung_MS_Teams_an_vPBXimage2021-7-15_13-39-32.png]]


{{AttachmentsSectionEnd}}
[[Datei:Anbindung MS Teams an Business Trunk 1711019123117.png]]


<!-- From bodyContent 42238058.mraw -->
Solange die Telefonie über Ihr Teams läuft, ist alles in Ordnung.

Version vom 12. April 2024, 10:32 Uhr

Voraussetzungen für Anbindung von MS Teams an die vPBX

Erstens: Die richtige Telefon-Lizenz für jeden User, welcher "in die weite Welt" telefonieren will

LizenzenLizenz "Microsoft Teams Telefon Standard" pro User oder eine Lizenz, welche diese Option enthält.


iWay AG bietet im Moment keine Microsoft-Lizenzen an.


Zweitens: Admin-Zugriff auf Microsoft 365

Zugriffe/BerechtigungenZugriff auf Microsoft 365 Admin: https://admin.microsoft.com/
Zugriff auf Microsoft 365 Teams Admin: https://admin.teams.microsoft.com/


Vorbemerkungen zur MS Teams Domain

Es wird davon ausgegangen, dass Sie die Domain "ihredomain.ch" schon in MS Teams verwenden. Es werden nun folgende 5 DNS-Einträge hinzugefügt: 4 Einträge für "Skype for Business" und A-Record von teams.ihredomain.ch auf Ihre vPBX xyz.vpbx.iway.ch.


Nach der Umstellung wird Ihre vPBX nur noch unter https://teams.ihredomain.ch erreichbar sein, da nicht zwei SSL-Zertifikate auf eine vPBX zeigen können. Ihre zuvor angemeldeten Telefone/CTI-Clients müssen entsprechend umkonfiguriert/neu provisioniert werden. Ebenfalls müssen die Teilnehmer-Logins den MS-Teams-Usern angeglichen werden, d. h. die Teilnehmer-Logins auf der vPBX müssen ebenfalls vorname.nachname lauten.


Inhalt:

Schritt 1: Einrichten der Domain

Dieser Schritt zeigt das Einrichten der Domain im "Microsoft 365 admin center" unter https://admin.microsoft.com/AdminPortal/Home#/Domains.




Erstellen der DNS-Server-Einträge

Tragen Sie auf Ihren DNS-Servern folgende Einträge für Ihre Domain "ihredomain.ch" ein:


Hostname Domain TTL IN Type Prio Content
sip .ihredomain.ch 3600 IN CNAME
sipdir.online.lync.com
lyncdiscover .ihredomain.ch 3600 IN CNAME
webdir.online.lync.com
_sip._tls .ihredomain.ch 3600 IN SRV 100 1 443 sipdir.online.lync.com
_sipfederationtls._tcp .ihredomain.ch 3600 IN SRV 100 1 5061 sipfed.online.lync.com


Erstellen Sie auch noch folgenden A-Eintrag, bei welchem teams.ihredomain.ch auf die IP Ihrer vPBX xyz.vpbx.iway.ch zeigt:


Hostname Domain TTL IN Type Prio Content
teams .ihredomain.ch 3600 IN A
IP.der.iWay.vPBX


Die IP Ihrer vPBX ist unten links zu finden:


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage-2023-11-24 15-30-16.png


Zum Zeitpunkt der Umstellung der vPBX auf Teams muss dieser DNS-Eintrag weltweit verfügbar sein, da sonst das nötige Zertifikat nicht erstellt werden kann.


Aktivierung Ihrer Domain für "Skype for Business"

Öffnen Sie https://admin.microsoft.com/AdminPortal/Home#/Domains 

Klicken Sie auf "ihredomain.ch" (jene Domain, welche Sie schon für sich eingerichtet ist):


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-15 17-19-25.png


Klicken Sie auf "DNS records" und dann auf "Manage DNS":


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-15 17-26-32.png


Klicken Sie unten auf 
KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-15 17-30-30.png
:


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-15 17-30-1.png


Setzen Sie hier das Häkchen unter "Advanced Options" bei "Skype for Business":


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-15 17-32-23.png


Überprüfen Sie die DNS-Einträge und schliessen Sie diesen Schritt ab.


Schritt 2: Weisen Sie den MS Teams Usern die richtige Microsoft Lizenz 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 Lizenzen braucht es zusätzlich pro Benutzer die "Phone System"-Lizenz


Weisen Sie unter "Users" / "Active Users" den MS Teams Usern die richtige Microsoft Linzenz zu:


Anbindung MS Teams an vPBX 1712913615104.png


Schritt 3: Auf vPBX "Teams-Kompatibilitätsmodus" einschalten und Domain ändern

Auf der vPBX unter "PBX Einstellungen" bei "Teams-Kompatibilitätsmodus" auf "VoIP+Presence" umstellen und auf "Speichern" klicken:


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-9-21 8-24-32.png


Im selben Menü unter "Allgemeine Einstellungen" den Hostname (z. B. "teams") und die Domain (ihredomain.ch) angeben:

Zu diesem Zeitpunkt muss der neue DNS-Eintrag (teams.ihredomain.ch) weltweit verfügbar sein, da sonst das nötige Zertifikat nicht erstellt werden kann. Nach dieser Umstellung ist Ihre vPBX nur noch unter https://teams.ihredomain.ch mit Zertifikat erreichbar. Alle Telefone und CTI-Clients müssen auf die neue Domain umkonfiguriert werden.


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-9-21 8-26-42.png


Schritt 4: In Azure Wert-Schlüssel-Paar erzeugen und auf vPBX übertragen

In diesem Schritt wird in Azure ein Wert-Schlüssel-Paar ("Teams app id" / "Teams app key") erstellt, welches zur Abfrage des Presence-Status von MS Teams nötig ist.


"Anwendungs-ID (Client)" erstellen



Azure öffnen (https://portal.azure.com/) und dann unter "Azure Active Directory" / "App-Registrierungen" eine "Neue Registrierung" erstellen:



Direktlink: https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-18 16-49-38.png














Unter "Name" einen frei gewählten Namen angeben, z. B. "iwayteamsbridge" (es kann eine eigene Bezeichnung verwendet werden):





Bei "Unterstützte Kontotypen" "Nur Konten in diesem Organisationsverzeichnis" auswählen:


















Unter "Umleitung-URI (optional)" die neue URL Ihrer vPBX https://teams.ihredomain.ch/oauth/ angeben:

Zuunterst auf 
KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-18 17-5-9.png
klicken.


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-18 16-53-55.png


Den Wert hinter "Anwendungs-ID (Client)" kopieren ....





























... und auf der vPBX in den"PBX Einstellungen" ins Feld "Teams app id" kopieren:


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-18 17-8-22.png

KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-9-21 8-50-25.png


"Geheimer Clientschlüssel" erzeugen

Unter "Zertifikate & Geheimnisse" auf "Neuer geheimer Clientschlüssel" klicken, ...


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-18 17-11-45.png



... "Geheimen Clientschlüssel hinzufügen", ...


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-3-18 17-17-2.png


... diesen auf der vPBX in den "PBX Einstellungen" ins Feld "Teams app key" kopieren und danach auf "Speichern" klicken.


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBXimage2021-9-21 8-57-48.png


API-Berechtigungen

API-Berechtigungen müssen folgende gesetzt werden:

  • User.Read
  • Presence.Read
  • Presence.ReadAll


Authentifizierung der vPBX an Teams

Zum Abschluss die vPBX an der Microsoft Umgebung anmelden:


Schritt 5: Aktivieren von "Microsoft Teams Benutzer" und Eintragen der "MS Teams Telefonnummer" pro Teilnehmer auf der vPBX

Alle Benutzer auf der PBX erstellen bzw. entsprechend dieser Regel ändern: 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 vPBX hans.beispiel heissen.

Bei jedem Teams Benutzer ist nach dem Erstellen die Option "Microsoft Teams Benutzer" zu aktivieren und die Telefonnummer (Format +41...), mit welcher der Benutzer in der Teams Umgebung verknüpft werden wird, unter "MS Teams Telefonnummer" einzutragen, siehe Screenshot rechts.

Update Juli 2021: Als "MS Teams Telefonnummer" muss keine gültige Telefonnummer verwendet werden und auch das Format +41... muss nicht beachtet werden: Es können auch (z. B. vierstellige) interne Telefonnummern verwendet werden, wie z. B. 1000, 1001, 1002 etc. 
Das Eintragen von Internen Nummern ins Feld "MS Teams Telefonnummer" scheint nur zuverlässig zu funktionieren wenn alle User ausschliesslich MS Teams verwenden. Ansonsten gibt es Probleme beim Weiterleiten von Anrufen von MS Teams zu Hardware-Telefonen oder CTI-Client. 


KB VoIP Telefonie vPBX Anbindung MS Teams an vPBX2021-09-21 09 14 29-172.18.5.89 - Remotedesktopverbindung.png


Schritt 6: Konfiguration Direct Routing Service

Unter "VoIP" / "Direct Routing" den SBC wie folgt eintragen:


KB VoIP Telefonie Anbindung MS Teams an Business Trunk Anleitung Anbindung MS Teams an Business Trunkimage-2023-10-4 13-18-53.png


Schritt 7: VoIP-Routingrichtlinie erstellen

Unter "VoIP" / "VoIP-Routingrichtlinie" die entsprechende VoIP-Routingrichtlinie erstellen:


Anbindung MS Teams an Business Trunk 1707724487231.png



Schritt 8: VoIP-Route erstellen

Unter "VoIP" / "Direct Routing" / "VoIP-Routen" die entsprechende Route erstellen:


KB VoIP Telefonie Anbindung MS Teams an Business Trunk Anleitung Anbindung MS Teams an Business Trunkimage-2023-10-23 14-40-39.png


Schritt 9: Rufnummern den Benutzern zuweisen

Unter "Benutzer" den entsprechenen Benutzer bearbeiten, auf "Bearbeiten" klicken ...


KB VoIP Telefonie Anbindung MS Teams an Business Trunk Anleitung Anbindung MS Teams an Business Trunkimage-2023-10-4 13-21-36.png


... und auf der rechten Seite die Telefonnummer im im internationalen Format (E.164), z. B. +41435001111 eintragen:


KB VoIP Telefonie Anbindung MS Teams an Business Trunk Anleitung Anbindung MS Teams an Business Trunkimage-2023-10-4 13-24-10.png


Dem User die die VoIP-Routingrichtlinie "Unrestricted" zuweisen:


KB VoIP Telefonie Anbindung MS Teams an Business Trunk Anleitung Anbindung MS Teams an Business Trunkimage-2023-11-10 15-55-0.png




Hinweise zum Status nach der Inbetriebnahme

Ein- und ausgehende Telefonie kann evtl. nicht sofort nach der Inbetriebnahme funktionieren

Es kann sein, dass die ein- und ausgehende Telefonie erst ein paar Minuten nach der Inbetriebnahme funktioniert.


Unter "VoIP" / "Direct Routing" können Fehler angezeigt werden

Es kann sein, dass unter "VoIP" / "Direct Routing" können Fehler angezeigt werden, wie diese hier:

Anbindung MS Teams an Business Trunk 1711019123117.png

Solange die Telefonie über Ihr Teams läuft, ist alles in Ordnung.

Von «https://wiki.iway.ch/kb/index.php?title=VoIP_Telefonie/vPBX/Anbindung_MS_Teams_an_vPBX&oldid=3239»