DIRECT ROUTING – TELEFONI I MICROSOFT TEAMS
För att komma igång med telefoni i Microsoft Teams via Cellip behöver man konfigurera ett par saker i Office 365-portalen och med PowerShell. Den här manualen går igenom allt som behöver göras.
Från Cellip får varje kund ett unikt s.k. SBC-namn, detta SBC-namn ska användas i både Office 365- portalen och i PowerShell-kommandon genom hela denna manual. Där det står sbcaxxxx ska man byta ut det till det unika SBC-namn som just du blivit tilldelad, glöm inte det.
VAD SOM SKA GÖRAS
Som kund behöver man lägga till en ny domän i Office 365, den domänen kopplas sedan ihop med en SBC (Session Border Controller = telefonigateway) hos Cellip. Detta tillsammans med några regler och policys som man lägger in med PowerShell och rätt licenser i Office 365 gör att man får telefoni i Microsoft Teams.
OBS: Osäker på att köra PowerShell i Office 365, se Appendix 1 i slutet på denna manual för utförliga instruktioner.
OBS: Dyker det upp problem med PowerShell kan Appendix 2 vara av hjälp.
1. LÄGG TILL EN NY DOMÄN I OFFICE 365
Lägg till en ny domän i Office 365 med samma namn som det SBC-namn du fått av Cellip.
Klicka på Add domain.
Namnge domänen med det SBC-namn som du fått av Cellip, i formatet sbcaxxxx.pstnaccess.cellip.com
Klicka sedan på Use this domain fortsätter med lägga upp domänen.
För att verifiera domänen skickar du värdet för TXT value: till Cellip innan du går vidare. Cellip lägger upp verifieringskoden i Cellip.com’s DNS.
När Cellip gett klartecken kan domänen verifieras genom att klicka på Verify. Klicka inte på Vertify innan Cellip gett klartecken.
Bockar ur alla val innan du klickar på Next.
Den nya domänen är nu klar.
2. SKAPA EN SBC-ANVÄNDARE I DEN NYA DOMÄNEN
Skapa en SBC-användare i den nya domänen. Användaren kommer inte att användas utan behövs bara för att aktivera Skype i denna domän. Det ställs inga krav på namnet på användaren, bara att den ska skapas i domänen som nyss skapades. Användaren ska ha en Skype Online Plan 2-licens (alternativt en Teams-licens när Skype-licens inte finns tillgängligt i Office 365).
Nedan är ett exempel:
Viktigt är att den har en Skype Online Plan 2-licens, det går bra med tex. en E-plan eller Business Premium.
Denna användare kan tas bort när allt är uppsatt och fungerar, Cellip meddelar när detta kan ske.
3. PARA IHOP TEAMS MED SBC’N
För att koppla ihop kundens Office 365 med Cellips telefoniinfrastruktur kör man ett par kommandon i PowerShell i Office 365 (module: SkypeOnlineConnector), glöm inte att ändra namn på sbcaxxxx.
POWERSHELL I OFFICE 365
Innan man kan köra följande PowerShell-kommandon i Office 365 måste man ha modulen
SkypeOnlineConnector installerad. Den laddas ner och installeras lokalt på den dator där kommandona ska köras. Är den inte redan installerad, kolla Appendix 1 i slutet på denna manual för instruktioner.
New-CsOnlinePSTNGateway -Fqdn sbcaxxx.pstnaccess.cellip.com -SipSignalingPort 5067 - MaxConcurrentSessions 100 -Enabled $true -ForwardCallHistory $true -ForwardPai $true
Verifiera med:Get-CSOnlinePSTNGateway
Exempel:
4. SKAPA PSTN USAGE, VOICE ROUTE
För att kunna ringa behövs en s.k. Pstn usage-regel och en Voice route-policy. Exemplet nedan visar hur alla telefonnummer kopplas till den kundspecifika SBC’n, glöm inte att ändra SBC-namnet:
Set-CsOnlinePstnUsage -Identity Global -Usage @{Add="Cellip-International"}
New-CsOnlineVoiceRoute -Identity "Cellip-International" -NumberPattern "\d+" -
OnlinePstnGatewayList sbcaxxxx.pstnaccess.cellip.com -OnlinePstnUsages "Cellip-International"
New-CsOnlineVoiceRoutingPolicy -Identity "Cellip-No Restrictions" -OnlinePstnUsages "Cellip- International”
Verifiera med:
Get-CsOnlineVoiceRoutingPolicy
Till Exempel:
5. AKTIVERA ANVÄNDARE FÖR PHONE SYSTEM OCH TEAMS-TELEFONI
KRAV PÅ ANVÄNDARNA I OFFICE 365
Användarna som ska kunna ringa med Teams behöver vara aktiverade för Skype Online eller Skype hybrid med användarna i Skype Online.
Användarna behöver ha en E-plan i Office 365 med Phone System-tillägget. Tillägget Phone System ingår i E5 och köps till som en add-on till E1 och E3. Licens för Teams behöver också vara aktiverad. Klick på Apps under ”Licsenses och Apps” för användaren:
Har man Microsoft 365 (Basic, Standard, Premium) behöver man tillägget Microsoft 365 Business Voice.
LANDSINSTÄLLNINGAR PÅ ANVÄNDARNA
För att det ska bli rätt med landskoder när man ringer samtal från Teams-klienten behöver
landsinställningar i Office 365 stämma överens med landskoden på det telefonnummer som man gett användaren. Har man tex. ett svenskt +46-nummer behöver Location (under Product licenses) i Office 365 vara Sverige/Sweden.
AKTIVERA ANVÄNDAREN OCH SÄTT TELEFONNUMMER:
Användarna behöver ha sina Microsoft licenser för Telefoni (Phone System) aktiverade innan man fortsätter.
Set-CsUser namn@domän.se -EnterpriseVoiceEnabled $true -HostedVoiceMail $false -OnPremLineURI tel:+46XXXXXXXX
Grant-CsOnlineVoiceRoutingPolicy -Identity namn@domän.se -PolicyName "Cellip-No Restrictions”
Om man kör Grant-CsOnlineVoiceRoutingPolicy innan allt har hunnit fixas i de underliggande systemen i Office 365 får man detta felmeddelande, vänta 15 min och försök sedan igen:
“Policy "Cellip-No Restrictions" is not a user policy. You can assign only a user policy to a specific user.”
– Vänta 15 minuter och kör sedan Grant-CsOnlineVoiceRoutingPolicy-kommandot igen.
Klart. Samtals-funktionen kommer nu dyka upp i Teams inom några timmar, ibland tar det till dagen efter.
Notera att alla användare använder Teams Calling Policy ”Global”, om inte det blir definierad, det är här man sedan kan styra inställningar som till exempel ”Busy-on-Busy”.
Vill man kunna separera Teams funktioner mer för sina användare rekommenderar vi att först skapa en helt ny Teams Calling Policy i Teams Admin Center under Voice -> Calling Policies som man sedan kopplar användarna till som ovan med hjälp av:
Grant-CsTeamsCallingPolicy -PolicyName BusyonBusy -Identity namn@domän.se (Obs: BusyonBusy är bara ett exempel på namn till en ny Calling Policy)
6. TEAMS UPGRADE ”TEAMS ONLY” VS. “ÖAR”:
För att kunna använda Teams Direct Routing tjänsten måste användarna vara i ”Teams Only” mode då ”Öar”
och Phone System inte längre är supportad av Microsoft.
Man kan antigen sätta det per användare eller som globalt via Teams Admin Center:
Använda Ni redan Teams sedan tidigare eller kommer ifrån Skype för Business behöver ni gå över till
”Teams Only” nu, för att få vår tjänst att fungera.
Nya Teams kunder ska redan befinna sig i ”Teams Only” på global nivå.
7. KORTNUMMER NORMALISERING
För att kunna ringa kortnummer via Teams och få extra funktionalitet behöver man lägga till normaliseringsregler till sin Dial Plan i Teams.
Gå till Teams Admin Center sidan via er Office Admin Center och i Teams Admin Center gå till Samtal ->Dial Plan
Markera Global Dial Plan och sedan tryck på Add
I det nya fönster skrolla ner till Normaliserings Regler och tryck på Add
LÄGG TILL NORMALISERINGS REGLER
Det öppnas upp ett nytt fönster på högra sidan för att lägga till informationen för den nya regeln, markera Advanced
Som namn ange: nr1 och under beskrivning lägg till: Untouched 2 digits Sedan under If conditions lägg I en detta: ^(\d{2})$
Under Then do this skriv: $1
För att testa skriv in två siffor och testa att det blir rätt, spara regeln.
Gör om processen för ytterligare två regler:
Name Description If Then Test
Nr2 Untouched 3 digits ^(\d{3})$ $1 test tre siffror
Nr3 Untouched 4 digits ^(\d{4})$ $1 test fyra siffro
Till slut ska er Global Dial Plan Normaliserning regel ser ut så här:
Kom ihåg att Spara längs ner på sidan.
FAQ
Fråga: Blir alla användare automatiskt aktiverade för telefoni Teams efter att man följt denna manual?
Svar: Nej. Bara de användare som du tilldelat telefonnummer och policys med Set-CsUser, Grant-
CsTeamsCallingPolicy och Grant-CsOnlineVoiceRoutingPolicy. Alla andra användare är omedvetna om att det finns telefonifunktionalitet i Teams.
Fråga: Kommer det också gå att ringa med Skype for Business med denna uppsättning?
Svar: Nej. Detta gäller bara för Microsoft Teams.
Fråga: Telefon-ikonen dyker inte upp i Teams-klienten, vad är fel?
Svar: Kontrollera att all konfiguration gjorts enligt manualen. Vänta till nästa dag, då borde ikonen dykt upp.
Om inte kontakta Cellip Support.
Fråga: Jag har telefonikonen men kan varken ringa eller ta emot samtal, vad är fel?
Svar: Kontrollera att du har rätt telefonnummer i Teams, syns vid sifferknapparna. Är det rätt nummer men fungerar ändå inte - kontakta Cellip Support.
Fråga: Vilken licens behöver jag i Office 365 för att kunna ringa med Teams?
Svar: Det krävs en E-planlicens i Office 365 med Phone System som tillägg. Phone System ingår i E5.
Fråga: Fungerar telefoni i gratisversionen av Teams, Microsoft Teams free?
Svar: Nej. Telefoni i Teams fungerar enbart med Enterprise-versionen av Teams.
Fråga: Vi har Skype on-prem i en hybriduppsättning, kommer det fungera?
Svar: Det kommer fungera om användaren som ska ha Teams-telefoni tillhör en Skype-pool i Office 365, alltså inte en server eller pool on-prem.
APPENDIX 1 – POWERSHELL MOT OFFICE 365
För att göra en del av konfigurationen för Direct Routing telefonifunktionalitet i Microsoft Teams behöver man köra en del PowerShell-kommandon mot Office 365, här är en utförlig instruktion för hur man kopplar upp PowerShell mot Office 365.
Obs! Värt att tänka på är att PowerShell är ett väldigt kraftfullt verktyg och fel använt kan det väldigt lätt och snabbt orsaka stor skada, därför ska man följa instruktionerna noga. Och ska man göra något annat ska man vara väldigt säker på vad man gör.
För att komma igång är det två steg som ska gås igenom, först behöver man Windows PowerShell version 3 eller senare installerat på datorn. Sedan behöver man en tilläggsmodul i PowerShell för Skype for Business Online, den innehåller alla kommandon man behöver för både Skype Online och Microsoft Teams.
1 KONTROLLERA INSTALLERAD POWERSHELL-VERSION
Windows PowerShell 3.0 kommer förinstallerad i Windows 8 och senare, och i Windows Server 2012 och senare. Så har du tex. Windows 10 så kan du hoppa över detta steg och gå direkt till avsnittet: ”Tillåt att script körs”.
I Windows 7 kan du behöva uppgradera till Windows PowerShell 5.1genom att följa instruktionerna på denna sida: https://www.microsoft.com/en-us/download/details.aspx?id=54616
Kontrollera vilken version du har genom att starta PowerShell genom att söka på ”PowerShell”, eller hitta programmet i Start-menyn. Högerklicka på Windows PowerShell och välj Kör som Administratör. Tillåt att programmet får startas.
För att kontrollera vilken version av Windows PowerShell som är installerad, skriv:
Get-Host | Select-Object Version
Resultatet ska vara Version 5.x eller högre. Om inte, följ länken på föregående sida för att installera en senare version.
Exempel från Windows 10:
2 TILLÅT ATT SCRIPT KÖRS
För att tillåta att skript får köras behöver man sätta en sk:. Execution Policy. Kör PowerShell som Administratör och skriv:
Set-ExecutionPolicy RemoteSigned -Force
Om PowerShell inte körs som Administratör, får man detta felmeddelande:
Starta PowerShell som Administratör och kör Set-ExecutionPolicy-kommandot igen.
3 INSTALLERA TEAMS POWERSHELL-MODULEN
Starta ett nytt Windows PowerShell-fönster (behöver inte vara som Administratör) och skriv:
Install-Module MicrosoftTeams
Vid första installatonen kan man få denna fråga:
Svara: A (Ja till allt)
Uppdatera sedan till den senaste ”Public Preview” versionen (detta gör att man inte längre behöver installera ”Skype for Business Online Connector) genom att:
Upptaera ”GET” kommandot via detta i PowerShell:
Install-Module PowerShellGet -Force -AllowClobber Kolla upp den senaste ”Preview” versionen som finns:
Find-Module MicrosoftTeams -AllowPrerelease
Och installera versionen som visas via:
Install-Module MicrosoftTeams -AllowPrerelease -RequiredVersion "1.1.10-preview"
(Obs: 1.1.10 är ett exempel)
4 KOPPLA UPP EN POWERSHELL-SESSION MOT OFFICE 365
Nu när Windows PowerShell är version 5.1 eller senare och MicrosoftTeams-modulen är installerad är det dags att koppla upp en session mot Office 365.
I PowerShell skriv:
$Cred = Get-Credential
Logga in med ett administratörs-konto i Office 365 som är skapad online och har administratörs rättigheter till era domäner.
Skriv sedan:
$session = New-CsOnlineSession -Credential $Cred
Import-PSSession $Session -AllowClobber
Har man en S4B- Hybrid-lösning sedan tidigare (där det finns en on-prem S4B lösning) måste man skriva:
$session=New-CsOnlineSession $cred -OverrideAdminDomain xxxxxxx.onmicrosoft.com Import-PSSession $session -AllowClobber
(OBS: xxxxxx ska ersättas med kundens domännamn)
Du har nu en PowerShell-session igång mot Office 365 och kan köra alla kommandon som behövs för att konfigurera Direct Routing för telefonifunktionalitet i Microsoft Teams (plus allt annat som också har med Skype for Business Online och Microsoft Teams att göra).
Sessionen mot Office 365 har en inaktivitetstimer och när den har uppnåtts måste man koppla upp en ny session i ett nytt PowerShell-fönster, det går då alltså inte att fortsätta i samma fönster och man får ett felmeddelande. Sätt upp en ny PowerShell session.
Har man MFA (Multifaktorautentisering) aktiverad så behöver man skriva:
Har man en Hybrid-lösning så måste man skriva:
$Session = New-CSonlineSession -OverrideAdminDomain xxxxxxx.onmicrosoft.com -verbose
APPENDIX 2 – VANLIGA FEL
1 INKLISTRAD KOMMANDO I POWERSHELL BLIR FEL
Säkerställ att alla kommandon skrivs i en rad, när man klipp och klistrar kommandon blir det lätt fel att man inte får med alla tecken som t.ex.: ” – ” eller att en radbrytning med ”>>” kommer emellan.
PowerShell är ett kraftfullt verktyg som man kan ställa till en del problem med och vi rekommenderar att man försöker lära sig det så att man kan styra sina inställningar i Office 365 via PowerShell också.
2 RUNNING SCRIPTS IS DISABLED
Felet kan uppstå t.ex. när man ska importera SkypeOnlineConnector.
Kontrollera att man kör PowerShell som Administratör och att man har tillåtit scripkörning som beskriven under punkt 2 i Appendix 1.
3 “UNABLE TO DISCOVER POWERSHELL ENDPOINT URI”
Felet uppstår när man försöker ansluta en PowerShell session mot sin Office365 med fel rättigheter.
Kontrollera att kontot man använder för att logga in har administratörs rättigheter i Office 365 och att man kanske kommer ifrån en Hybrid lösning och måste använda sig av:
-OverrideAdminDomain.
4 “SBCA….. NOT CONFIGURED FOR THIS TENANT”
Felet uppstår när man kör kommandot:
New-CsOnlinePSTNGateway
Kontrollera att kontot man loggar in med verkligen har administratörs rättigheter till alla era domäner, har administratören en Microsoft licens? Kör kommandot:
