VoIP:Teams:Resource Management: Difference between revisions

From VTX Public Wiki

(Switch to version 2.0.0 of MicrosoftTeams module)
(→‎Create Resource accounts: Add Blackboxwarning)
 
(2 intermediate revisions by the same user not shown)
Line 32: Line 32:


=== Create Resource accounts ===
=== Create Resource accounts ===



{{Blackboxwarning|1='''2023-08''': Warning, you need to have at least another real user with a valid Teams + Phone System license, you cannot have only free Teams Resource licenses, you need at least another real user with a real license, @VTX: cf example t1990043 }}



* '''Problematic''': You would like to create a resource that will be linked to a Call Queue or Auto Attendent and assign it with a Phone Number
* '''Problematic''': You would like to create a resource that will be linked to a Call Queue or Auto Attendent and assign it with a Phone Number
Line 50: Line 55:
=== Number Mapping : Assign numbers to Resource accounts ===
=== Number Mapping : Assign numbers to Resource accounts ===


==== Assign Resource numbers using a VTX Powershell Script VTX_Connect_Teams_Assign_Resource_Numbers.ps1 ====
==== Assign Resource numbers using a VTX Powershell Script VTX_Teams_Assign_Numbers.ps1 ====




{{Notice|1=Since last versions of the MicrosoftTeams module, we can use the same script to assign number and resources}}
{{Warning|1=By default for security reason, it is not allowed to execute a powershell script downloaded on the internet, that is why you will need to open them with Wordpad to check what it does, save it and execute it afterwards}}


Please refer to [[{{FULLPAGENAME}}#Assign_numbers_using_a_VTX_Powershell_Script_VTX_Teams_Assign_Numbers.ps1]]
# Download https://wiki.vtx.ch/media/VTX_Connect_Teams_Assign_Resource_Numbers.ps1 on your computer ( Right Click on the link / Download )
# Open it with Wordpad and use Ctrl-s to save it again ( to inform the system that it is local script )
# Execute it on your PC : It will ask you for these parameters and create the routing
## VTX Teams Domain : ex: 123456.teams.ipvoip.ch
## Your MS Admin Credentials for : ex: admin@MSDOMAIN.onmicrosoft.com
## The MS Team resource email : ex: callqueueX@MSDOMAIN.onmicrosoft.com or autoattendantX@MSDOMAIN.onmicrosoft.com
## The Telephone number you wish to set : ex: +41225661234




''Here is a list of screenshots to see how the script works''
<table>
<tr><td>
[[Image:Teams-Resource-Number-Assignment-00.png|thumb|600px|left|Teams Resource Number Assignment - Start Powershell Script]]
</td><td>
[[Image:Teams-Resource-Number-Assignment-01.png|thumb|600px|left|Teams Resource Number Assignment - Disclaimer]]
</td></tr>
<tr><td>
[[Image:Teams-Resource-Number-Assignment-02.png|thumb|600px|left|Teams Resource Number Assignment - Enter the Teams Domain Provided by VTX]]
</td><td>
[[Image:Teams-Resource-Number-Assignment-03.png|thumb|600px|left|Teams Resource Number Assignment - Enter Teams Admin credentials]]
</td></tr>
<tr><td>
[[Image:Teams-Resource-Number-Assignment-04.png|thumb|600px|left|Teams Resource Number Assignment - Enter Teams Resource email]]
</td><td>
[[Image:Teams-Resource-Number-Assignment-05.png|thumb|600px|left|Teams Resource Number Assignment - Enter Teams Resource Phone Number]]
</td></tr>
<tr><td>
[[Image:Teams-Resource-Number-Assignment-06.png|thumb|600px|left|Teams Resource Number Assignment - Setup another resource ?]]
</td><td>
[[Image:Teams-Resource-Number-Assignment-07.png|thumb|600px|left|Teams Resource Number Assignment - List all resource setup ?]]
</td></tr>
<tr><td>
[[Image:Teams-Resource-Number-Assignment-08.png|thumb|600px|left|Teams Resource Number Assignment - List of resources]]
</td><td>
</td></tr>
</table>


==== Or Assign Resource numbers manually in Powershell Command Prompt ====
==== Or Assign Resource numbers manually in Powershell Command Prompt ====
Line 104: Line 76:
Connect-MicrosoftTeams
Connect-MicrosoftTeams
# Assign a number to your resource
# Assign a number to your resource
Set-CsOnlineApplicationInstance -Identity $TeamsResourceEmail -OnpremPhoneNumber $TeamsResourceNumber
Set-CsPhoneNumberAssignment -Identity "$TeamsResourceEmail" -PhoneNumber "$TeamsResourceNumber" -PhoneNumberType DirectRouting
# Assign a Voice Routing Policy to your resource to allow it to call out towards external numbers
# Assign a Voice Routing Policy to your resource to allow it to call out towards external numbers
Grant-CsOnlineVoiceRoutingPolicy -Identity $TeamsResourceEmail -PolicyName "CsOnlineVoiceRoutingPolicy-$TeamsDomain"
Grant-CsOnlineVoiceRoutingPolicy -Identity $TeamsResourceEmail -PolicyName "CsOnlineVoiceRoutingPolicy-$TeamsDomain"

Latest revision as of 07:28, 11 September 2023

Create and Manage Call Queues[edit | edit source]

  • Problematic: You would like to create a Call Queue that will play some greetings and then ring on several phones in parallel / serial modes
  • Solution : Follow procedure below
  1. Connect to https://admin.teams.microsoft.com/call-queues
  2. Follow documentation in https://docs.microsoft.com/en-us/microsoftteams/create-a-phone-system-call-queue
  3. Add a "Microsoft Teams" and "Microsoft 365 Phone System - Virtual User" license to your user
  4. Assign a number in the corresponding resource in next sections
Microsoft Teams Admin - Create a Call Queue

Create and Manage Auto Attendants[edit | edit source]

  • Problematic: You would like to create an auto Attendant that can answer your call, play accouncement, and route calls using Time Conditions (inclusing Holidays) or IVR system
  • Solution : Follow procedure below
  1. Connect to https://admin.teams.microsoft.com/auto-attendants
  2. Follow documentation in https://docs.microsoft.com/en-us/microsoftteams/create-a-phone-system-auto-attendant
  3. Add a "Microsoft Teams" and "Microsoft 365 Phone System - Virtual User" license to your user
  4. Assign a number in the corresponding resource in next sections
Microsoft Teams Admin - Create an auto attendant


Create Resource accounts[edit | edit source]

Warning 2023-08: Warning, you need to have at least another real user with a valid Teams + Phone System license, you cannot have only free Teams Resource licenses, you need at least another real user with a real license, @VTX: cf example t1990043 Warning


  • Problematic: You would like to create a resource that will be linked to a Call Queue or Auto Attendent and assign it with a Phone Number
  • Solution : Follow procedure below
  1. Connect to https://admin.teams.microsoft.com/company-wide-settings/resource-accounts
  2. Follow documentation in https://docs.microsoft.com/en-us/microsoftteams/manage-resource-accounts#create-a-resource-account-in-the-microsoft-teams-admin-center


Microsoft Teams Admin - Create Resources
Microsoft Teams Admin - Assign Licenses

Number Mapping : Assign numbers to Resource accounts[edit | edit source]

Assign Resource numbers using a VTX Powershell Script VTX_Teams_Assign_Numbers.ps1[edit | edit source]

Since last versions of the MicrosoftTeams module, we can use the same script to assign number and resources

Please refer to VoIP:Teams:Resource Management#Assign_numbers_using_a_VTX_Powershell_Script_VTX_Teams_Assign_Numbers.ps1


Or Assign Resource numbers manually in Powershell Command Prompt[edit | edit source]

  1. Open a powershell prompt on your PC
  2. Copy paste command below one by one changing the values in bold with your own
# Set Variables
$TeamsDomain = "123456.teams.ipvoip.ch"
$TeamsResourceEmail = "resourceX@MSDOMAIN.onmicrosoft.com"
$TeamsResourceNumber = "+41215661234"
# Connect to Microsoft Teams management
Connect-MicrosoftTeams
# Assign a number to your resource
Set-CsPhoneNumberAssignment -Identity "$TeamsResourceEmail" -PhoneNumber "$TeamsResourceNumber" -PhoneNumberType DirectRouting
# Assign a Voice Routing Policy to your resource to allow it to call out towards external numbers
Grant-CsOnlineVoiceRoutingPolicy -Identity $TeamsResourceEmail -PolicyName "CsOnlineVoiceRoutingPolicy-$TeamsDomain"
# Wait 60s for settings to be applied
Sleep -s 60
# Verify Your setup
Get-CsOnlineApplicationInstance -Identity $TeamsResourceEmail
Get-CsOnlineUser -Identity $TeamsResourceEmail | Select sipaddress,EnterpriseVoiceEnabled,OnPremLineURI,OnlineVoiceRoutingPolicy | Format-List
# Logout
DisConnect-MicrosoftTeams
Retrieved from "https://wiki.vtx.ch/mediawiki/index.php?title=VoIP:Teams:Resource_Management&oldid=3193"