Erwin Bierens

Knowledge is Power

No Agents opt-in or Logged In in a Microsoft Teams Call Queue

2023-06-21 2 min read Microsoft Teams

This week (week 25, 2023) Microsoft has launched a new version of the Microsoft Teams PowerShell module, version 5.3.0.

  • [BREAKING CHANGE] Adds State parameter & output attribute to [New|Get|Set|Update]-CsTeamsShiftsConnection and [New|Get|Set|Update]-CsTeamsShiftsConnectionInstance cmdlets.
  • Releases [New|Get|Set|Remove|Grant]-CsTeamsMeetingTemplatePermissionPolicy cmdlets.
  • Releases Get-CsTeamsMeetingTemplateConfiguration cmdlet.
  • Releases Get-CsTeamsFirstPartyMeetingTemplateConfiguration cmdlet.
  • Release New-CsTeamsHiddenMeetingTemplate cmdlet.
  • Adds new parameters to the Set-CsCallQueue and New-CsCallQueue Cmdlets to enable users to set No Agent Opt In/Logged In options for call handling in Call Queue. New parameters are added for No Agent disconnect/redirection options, target, shared voicemail prompts and whether to enable shared voicemail system prompt suppression and transcription.
  • Adds warning message in the output of the Set-CsPhoneNumberAssignment Cmdlet. This message provides information about users with licenses in a grace period.

In this post i want to go in detail on how to configure the No Agent Opt In/Logged In for your Call Queues. I believe this is one of the features many admin/users (including me) are waiting for within the Call Queues configuration!

First step is to update your module by the following cmdlet:

Update-Module MicrosoftTeams

If you encounter problems you can use the -force parameter. For more info about installing the Microsoft Teams PowerShell module, follow this link.

In the following example i will show you how to add a redirection to a Auto Attendant with a simple text to speech prompt that applies to all calls

Set-CsCallQueue -Identity <object Id> -NoAgentAction Forward -NoAgentActionTarget "tel:+31881234567" -NoAgentRedirectPhoneNumberTextToSpeechPrompt "no agents available, please hold. We are forwarding you" -NoAgentApplyTo AllCalls

In the example above i used Reverse Number Lookup (RNL) to redirect to my Auto Attendant.

*> I’ve also tried to get the AgentsAction working with Queue, but nor objectId or resource account address are working right now. *

In order to get your Object Id use the following cmdlet:

Get-CsCallQueue |ft Name,Identity

The following parameters have been added to the Set and New-CsCallQueue cmdlet

  • NoAgentsAction [Disconnect, Forward, Queue, SharedVoicemail, Voicemail]
  • NoActionTarget [Phonenumber, resource account]
  • NoAgentApplyTo [AllCalls, NewCalls]
  • NoAgentRedirectPhoneNumberTextToSpeechPrompt
  • NoAgentDisconnectAudioFilePrompt
  • NoAgentDisconnectTextToSpeechPrompt
  • NoAgentRedirectPersonAudioFilePrompt
  • NoAgentRedirectPersonTextToSpeechPrompt
  • NoAgentRedirectVoiceAppAudioFilePrompt
  • NoAgentRedirectVoiceAppTextToSpeechPrompt
  • NoAgentRedirectPhoneNumberAudioFilePrompt
  • NoAgentRedirectVoicemailAudioFilePrompt
  • NoAgentRedirectVoicemailTextToSpeechPrompt
  • NoAgentSharedVoicemailTextToSpeechPrompt
  • NoAgentSharedVoicemailAudioFilePrompt
  • EnableNoAgentSharedVoicemailTranscription
  • EnableNoAgentSharedVoicemailSystemPromptSuppression

Let me know in the comments how you have build your NoAgentsAction configuration.

comments powered by Disqus