diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsSharedVoicemailTriageSettingsTemplate.md b/teams/teams-ps/MicrosoftTeams/Get-CsSharedVoicemailTriageSettingsTemplate.md new file mode 100644 index 0000000000..0d6d848474 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-CsSharedVoicemailTriageSettingsTemplate.md @@ -0,0 +1,99 @@ +--- +applicable: Microsoft Teams Queues App, Outlook +author: vijurtse +external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml +Locale: en-US +Module Name: MicrosoftTeams +ms.author: vijurtse +ms.reviewer: williamlooney +online version: https://learn.microsoft.com/powershell/module/microsoftteams/Get-CsSharedVoicemailTriageSettingsTemplate +schema: 2.0.0 +title: Get-CsSharedVoicemailTriageSettingsTemplate +--- + +# Get-CsSharedVoicemailTriageSettingsTemplate + +## SYNOPSIS +The Get‑CsSharedVoicemailTriageSettingsTemplate cmdlet retrieves the configuration for automatic triage of Shared Voicemails, including the importance flag, summary, suggested actions, and category settings. + +## SYNTAX + +``` +Get-CsSharedVoicemailTriageSettingsTemplate [[-Id] ] [] +``` + +## DESCRIPTION +Use the Get‑CsSharedVoicemailTriageSettingsTemplate cmdlet to retrieve the configuration for automatic triage of Shared Voicemails. This includes settings for importance flagging, summary generation, suggested actions, and category assignment. +## EXAMPLES + +### Example 1 +``` +Get‑CsSharedVoicemailTriageSettingsTemplate -Id 3a4b3d9b-91d8-4fbf-bcff-6907f325842c + +``` +This example retrieves the configuration of the specified Shared Voicemail triage template. + +### Example 2 +``` +Get‑CsSharedVoicemailTriageSettingsTemplate + +``` +This example retrieves a list of all available templates for voicemail triage settings. + +## PARAMETERS + +### -ID + +Template ID + +```yaml +Type: System.String +Parameter Sets: (All) + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + + +### CommonParameters + +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None + +## OUTPUTS + +### Microsoft.Rtc.Management.OAA.Models.AutoAttendant + +## NOTES + +## RELATED LINKS + +[New-CsSharedVoicemailTriageSettingsTemplate](./New-CsSharedVoicemailTriageSettingsTemplate.md) + +[Set-CsSharedVoicemailTriageSettingsTemplate](./Set-CsSharedVoicemailTriageSettingsTemplate.md) + +[Remove-CsSharedVoicemailTriageSettingsTemplate](./Remove-CsSharedVoicemailTriageSettingsTemplate.md) + +[New-CsCallQueue](./New-CsCallQueue.md) + +[Get-CsCallQueue](./Get-CsCallQueue.md) + +[Set-CsCallQueue](./Set-CsCallQueue.md) + +[Remove-CsCallQueue](./Remove-CsCallQueue.md) + +[New-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/new-csautoattendant) + +[Get-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/get-csautoattendant) + +[Set-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/set-csautoattendant) + +[Remove-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/remove-csautoattendant) + + diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md index 8b02998b4b..da06831917 100644 --- a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md +++ b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md @@ -299,6 +299,9 @@ Retrieves the list of Shared Call History templates. ### [Get-CsSharedCallQueueHistoryTemplate](Get-CsSharedCallQueueHistoryTemplate.md) Deprecated - new cmdlet is Get-CsSharedCallHistoryTemplate +### [Get-CsSharedVoicemailTriageSettingsTemplate](Get-CsSharedVoicemailTriageSettingsTemplate.md) +Retrieves the configuration for automatic triage of Shared Voicemails + ### [Get-CsTagsTemplate](Get-CsTagsTemplate.md) Retrieves a list of existing Tag templates. @@ -926,6 +929,9 @@ Use the New-CsSharedCallHistoryTemplate cmdlet to create a Shared Call History t ### [New-CsSharedCallQueueHistoryTemplate](New-CsSharedCallQueueHistoryTemplate.md) Deprecated - new cmdlet is New-CsSharedCallHistoryTemplate +### [New-CsSharedVoicemailTriageSettingsTemplate](New-CsSharedVoicemailTriageSettingsTemplate.md) +This cmdlet creates an AI triage settings template for Shared Voicemails. + ### [New-CsTag](New-CsTag.md) Use the New-CsTag cmdlet to create a new tag that can be added to a Tag template. @@ -1233,7 +1239,10 @@ This cmdlet will remove/delete a device from the remote log collection configura Removes Shared Call History template. ### [Remove-CsSharedCallQueueHistoryTemplate](Remove-CsSharedCallQueueHistoryTemplate.md) -Deprecated - use new cmdlet CsSharedCallHistoryTemplate +Deprecated - use new cmdlet CsSharedCallHistoryTemplate. + +### [Remove-CsSharedVoicemailTriageSettingsTemplate](Remove-CsSharedVoicemailTriageSettingsTemplate.md) +Removes AI Triage SettingsTemplate for Shared Voicemails. ### [Remove-CsTagsTemplate](Remove-CsTagsTemplate.md) Deletes an existing Tag template. @@ -1557,7 +1566,10 @@ This cmdlet allows the admin to create and edit a device requested for remote lo This cmdlet allows to configure Shared Call History template. ### [Set-CsSharedCallQueueHistoryTemplate](Set-CsSharedCallQueueHistoryTemplate.md) -Deprecated - use new cmdlet Set-CsSharedCallHistoryTemplate +Deprecated - use new cmdlet Set-CsSharedCallHistoryTemplate. + +### [Set-CsSharedVoicemailTriageSettingsTemplate](Set-CsSharedVoicemailTriageSettingsTemplate.md) +This cmdlet allows to configure AI Triage Settings Template for Shared Voicemails. ### [Set-CsTagsTemplate](Set-CsTagsTemplate.md) Make changes to an existing Tag template. diff --git a/teams/teams-ps/MicrosoftTeams/New-CsAutoAttendant.md b/teams/teams-ps/MicrosoftTeams/New-CsAutoAttendant.md index fae93fb738..63e5321499 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsAutoAttendant.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsAutoAttendant.md @@ -20,7 +20,7 @@ Use the New-CsAutoAttendant cmdlet to create a new Auto Attendant (AA). ## SYNTAX ```powershell -New-CsAutoAttendant -Name -LanguageId -TimeZoneId -DefaultCallFlow [-CallFlows ] [-CallHandlingAssociations ] [-Operator ] [-VoiceId ] [-EnableVoiceResponse] [-EnableMainlineAttendant] [-MainlineAttendantAgentVoiceId ] [-InclusionScope ] [-ExclusionScope ] [-AuthorizedUsers ] [-HideAuthorizedUsers ] [-UserNameExtension ] [-AutoRecordingTemplateId ] [-Tenant ] [] +New-CsAutoAttendant -Name -LanguageId -TimeZoneId -DefaultCallFlow [-CallFlows ] [-CallHandlingAssociations ] [-Operator ] [-VoiceId ] [-EnableVoiceResponse] [-EnableMainlineAttendant] [-MainlineAttendantAgentVoiceId ] [-InclusionScope ] [-ExclusionScope ] [-AuthorizedUsers ] [-HideAuthorizedUsers ] [-UserNameExtension ] [-AutoRecordingTemplateId ] [-SharedVoicemailTriageSettingsTemplateId ] [-Tenant ] [] ``` ## DESCRIPTION @@ -43,6 +43,7 @@ You can create new AAs by using the New-CsAutoAttendant cmdlet; each newly creat > - -EnableMainLineAttendant > - -MainlineAttendantAgentVoiceId > - -AutoRecordingTemplateId +> - -SharedVoicemailTriageSettingsTemplateId **NOTES**: @@ -531,6 +532,26 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -SharedVoicemailTriageSettingsTemplateId + +The SharedVoicemailTriageSettingsTemplateId enables automatic triage of Shared Voicemails using a compliant Substrate Large Language Model (LLM). It also specifies which additional LLM‑generated fields are added to each shared voicemail message, including the importance flag, summary, suggested actions, and categories. All data is processed in real time and stored in Exchange as part of the delivered voicemail message. + +> [!NOTE] +> Voicemail transcription must be enabled in your Voicemail Policies. The LLM‑based triage process relies exclusively on the voicemail transcription. If the tenant’s configured language is not supported for voicemail transcription, no transcription will be generated and automatic triaging will not occur. +> + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Tenant This parameter is reserved for Microsoft internal use only. diff --git a/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md b/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md index 51090cdf0f..2e4062b951 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsCallQueue.md @@ -19,7 +19,7 @@ Creates new Call Queue in your Teams organization. ## SYNTAX ``` -New-CsCallQueue -Name [-AgentAlertTime ] [-AllowOptOut ] [-DistributionLists ] [-Tenant ] [-UseDefaultMusicOnHold ] [-WelcomeMusicAudioFileId ] [-MusicOnHoldAudioFileId ] [-OverflowAction ] [-OverflowActionTarget ] [-OverflowActionCallPriority ] [-OverflowThreshold ] [-TimeoutAction ] [-TimeoutActionTarget ] [-TimeoutActionCallPriority ] [-TimeoutThreshold ] [-NoAgentAction ] [-NoAgentActionTarget ] [-NoAgentActionCallPriority ] [-RoutingMethod ] [-PresenceBasedRouting ] [-ConferenceMode ] [-User ] [-LanguageId ] [-LineUri ] [-OboResourceAccountIds ] [-OverflowDisconnectTextToSpeechPrompt ][-OverflowDisconnectAudioFilePrompt ] [-OverflowRedirectPersonTextToSpeechPrompt ][-OverflowRedirectPersonAudioFilePrompt ] [-OverflowRedirectVoiceAppTextToSpeechPrompt ] [-OverflowRedirectVoiceAppAudioFilePrompt ] [-OverflowRedirectPhoneNumberTextToSpeechPrompt ] [-OverflowRedirectPhoneNumberAudioFilePrompt ] [-OverflowRedirectVoicemailTextToSpeechPrompt ] [-OverflowRedirectVoicemailAudioFilePrompt ] [-OverflowSharedVoicemailTextToSpeechPrompt ] [-OverflowSharedVoicemailAudioFilePrompt ] [-EnableOverflowSharedVoicemailTranscription ] [-EnableOverflowSharedVoicemailSystemPromptSuppression ] [-TimeoutDisconnectTextToSpeechPrompt ][-TimeoutDisconnectAudioFilePrompt ] [-TimeoutRedirectPersonTextToSpeechPrompt ] [-TimeoutRedirectPersonAudioFilePrompt ] [-TimeoutRedirectVoiceAppTextToSpeechPrompt ] [-TimeoutRedirectVoiceAppAudioFilePrompt ] [-TimeoutRedirectPhoneNumberTextToSpeechPrompt ] [-TimeoutRedirectPhoneNumberAudioFilePrompt ] [-TimeoutRedirectVoicemailTextToSpeechPrompt ] [-TimeoutRedirectVoicemailAudioFilePrompt ] [-TimeoutSharedVoicemailTextToSpeechPrompt ] [-TimeoutSharedVoicemailAudioFilePrompt ] [-EnableTimeoutSharedVoicemailTranscription ] [-EnableTimeoutSharedVoicemailSystemPromptSuppression ] [-NoAgentApplyTo ] [-NoAgentDisconnectTextToSpeechPrompt ][-NoAgentDisconnectAudioFilePrompt ] [-NoAgentRedirectPersonTextToSpeechPrompt ] [-NoAgentRedirectPersonAudioFilePrompt ] [-NoAgentRedirectVoiceAppTextToSpeechPrompt ] [-NoAgentRedirectVoiceAppAudioFilePrompt ] [-NoAgentRedirectPhoneNumberTextToSpeechPrompt ] [-NoAgentRedirectPhoneNumberAudioFilePrompt ] [-NoAgentRedirectVoicemailTextToSpeechPrompt ] [-NoAgentRedirectVoicemailAudioFilePrompt ] [-NoAgentSharedVoicemailTextToSpeechPrompt ] [-NoAgentSharedVoicemailAudioFilePrompt ] [-EnableNoAgentSharedVoicemailTranscription ] [-EnableNoAgentSharedVoicemailSystemPromptSuppression ] [-ChannelId ] [-ChannelUserObjectId ] [-ShiftsTeamId ] [-ShiftsSchedulingGroupId ] [-AuthorizedUsers ] [-HideAuthorizedUsers ] [-WelcomeTextToSpeechPrompt ] [-IsCallbackEnabled ] [-CallbackRequestDtmf ] [-WaitTimeBeforeOfferingCallbackInSecond ] [-NumberOfCallsInQueueBeforeOfferingCallback ] [-CallToAgentRatioThresholdBeforeOfferingCallback ] [-CallbackOfferAudioFilePromptResourceId ] [-CallbackOfferTextToSpeechPrompt ] [-CallbackEmailNotificationTarget ] [-ServiceLevelThresholdResponseTimeInSecond ] [-ComplianceRecordingForCallQueueTemplateId ] [-TextAnnouncementForCR ] [-CustomAudioFileAnnouncementForCR ] [-TextAnnouncementForCRFailure ] [-CustomAudioFileAnnouncementForCRFailure ] [-ShouldOverwriteCallableChannelProperty ] [-SharedCallQueueHistoryTemplateId ] [-AutoRecordingTemplateId ] [] +New-CsCallQueue -Name [-AgentAlertTime ] [-AllowOptOut ] [-DistributionLists ] [-Tenant ] [-UseDefaultMusicOnHold ] [-WelcomeMusicAudioFileId ] [-MusicOnHoldAudioFileId ] [-OverflowAction ] [-OverflowActionTarget ] [-OverflowActionCallPriority ] [-OverflowThreshold ] [-TimeoutAction ] [-TimeoutActionTarget ] [-TimeoutActionCallPriority ] [-TimeoutThreshold ] [-NoAgentAction ] [-NoAgentActionTarget ] [-NoAgentActionCallPriority ] [-RoutingMethod ] [-PresenceBasedRouting ] [-ConferenceMode ] [-User ] [-LanguageId ] [-LineUri ] [-OboResourceAccountIds ] [-OverflowDisconnectTextToSpeechPrompt ][-OverflowDisconnectAudioFilePrompt ] [-OverflowRedirectPersonTextToSpeechPrompt ][-OverflowRedirectPersonAudioFilePrompt ] [-OverflowRedirectVoiceAppTextToSpeechPrompt ] [-OverflowRedirectVoiceAppAudioFilePrompt ] [-OverflowRedirectPhoneNumberTextToSpeechPrompt ] [-OverflowRedirectPhoneNumberAudioFilePrompt ] [-OverflowRedirectVoicemailTextToSpeechPrompt ] [-OverflowRedirectVoicemailAudioFilePrompt ] [-OverflowSharedVoicemailTextToSpeechPrompt ] [-OverflowSharedVoicemailAudioFilePrompt ] [-EnableOverflowSharedVoicemailTranscription ] [-EnableOverflowSharedVoicemailSystemPromptSuppression ] [-TimeoutDisconnectTextToSpeechPrompt ][-TimeoutDisconnectAudioFilePrompt ] [-TimeoutRedirectPersonTextToSpeechPrompt ] [-TimeoutRedirectPersonAudioFilePrompt ] [-TimeoutRedirectVoiceAppTextToSpeechPrompt ] [-TimeoutRedirectVoiceAppAudioFilePrompt ] [-TimeoutRedirectPhoneNumberTextToSpeechPrompt ] [-TimeoutRedirectPhoneNumberAudioFilePrompt ] [-TimeoutRedirectVoicemailTextToSpeechPrompt ] [-TimeoutRedirectVoicemailAudioFilePrompt ] [-TimeoutSharedVoicemailTextToSpeechPrompt ] [-TimeoutSharedVoicemailAudioFilePrompt ] [-EnableTimeoutSharedVoicemailTranscription ] [-EnableTimeoutSharedVoicemailSystemPromptSuppression ] [-NoAgentApplyTo ] [-NoAgentDisconnectTextToSpeechPrompt ][-NoAgentDisconnectAudioFilePrompt ] [-NoAgentRedirectPersonTextToSpeechPrompt ] [-NoAgentRedirectPersonAudioFilePrompt ] [-NoAgentRedirectVoiceAppTextToSpeechPrompt ] [-NoAgentRedirectVoiceAppAudioFilePrompt ] [-NoAgentRedirectPhoneNumberTextToSpeechPrompt ] [-NoAgentRedirectPhoneNumberAudioFilePrompt ] [-NoAgentRedirectVoicemailTextToSpeechPrompt ] [-NoAgentRedirectVoicemailAudioFilePrompt ] [-NoAgentSharedVoicemailTextToSpeechPrompt ] [-NoAgentSharedVoicemailAudioFilePrompt ] [-EnableNoAgentSharedVoicemailTranscription ] [-EnableNoAgentSharedVoicemailSystemPromptSuppression ] [-ChannelId ] [-ChannelUserObjectId ] [-ShiftsTeamId ] [-ShiftsSchedulingGroupId ] [-AuthorizedUsers ] [-HideAuthorizedUsers ] [-WelcomeTextToSpeechPrompt ] [-IsCallbackEnabled ] [-CallbackRequestDtmf ] [-WaitTimeBeforeOfferingCallbackInSecond ] [-NumberOfCallsInQueueBeforeOfferingCallback ] [-CallToAgentRatioThresholdBeforeOfferingCallback ] [-CallbackOfferAudioFilePromptResourceId ] [-CallbackOfferTextToSpeechPrompt ] [-CallbackEmailNotificationTarget ] [-ServiceLevelThresholdResponseTimeInSecond ] [-ComplianceRecordingForCallQueueTemplateId ] [-TextAnnouncementForCR ] [-CustomAudioFileAnnouncementForCR ] [-TextAnnouncementForCRFailure ] [-CustomAudioFileAnnouncementForCRFailure ] [-ShouldOverwriteCallableChannelProperty ] [-SharedCallHistoryTemplateId ] [-AutoRecordingTemplateId ] [-SharedVoicemailTriageSettingsTemplateId ] [] ``` ## DESCRIPTION @@ -58,7 +58,18 @@ The New-CsCallQueue cmdlet creates a new Call Queue. > - -NoAgentRedirectVoicemailAudioFilePrompt > > Shared call history +> - -SharedCallHistoryTemplateId +> +> Automatic recording > - -AutoRecordingTemplateId +> +> Automatic triage of Shared Voicemails with AI +> - -SharedVoicemailTriageSettingsTemplateId +> +> The following configuration parameters will only work for customers that are participating in the Voice Applications private preview for these features. General Availability for this functionality has not been determined at this time. +> +> - -AutoRecordingTemplateId +> - -SharedVoicemailTriageSettingsTemplateId > > Authorized users can't edit call queues with these features enabled: > - The call exception routing when the destination directly references another Auto attendant or Call queue @@ -1167,9 +1178,9 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -SharedCallQueueHistoryTemplateId +### -SharedCallHistoryTemplateId -The SharedCallQueueHistoryTemplateId parameter indicates the Shared Call History template to apply to the call queue. +The SharedCallHistoryTemplateId parameter indicates the Shared Call History template to apply to the call queue. > [!NOTE] > `-ConferenceMode` must be set to $true @@ -1189,6 +1200,26 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -SharedVoicemailTriageSettingsTemplateId + +The SharedVoicemailTriageSettingsTemplateId enables automatic triage of Shared Voicemails using a compliant Substrate Large Language Model (LLM). It also specifies which additional LLM‑generated fields are added to each shared voicemail message, including the importance flag, summary, suggested actions, and categories. All data is processed in real time and stored in Exchange as part of the delivered voicemail message. + +> [!NOTE] +> Voicemail transcription must be enabled in your Voicemail Policies. The LLM‑based triage process relies exclusively on the voicemail transcription. If the tenant’s configured language is not supported for voicemail transcription, no transcription will be generated and automatic triaging will not occur. +> + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -ShiftsSchedulingGroupId Id of the Scheduling Group to connect a call queue to. diff --git a/teams/teams-ps/MicrosoftTeams/New-CsOnlineVoicemailPolicy.md b/teams/teams-ps/MicrosoftTeams/New-CsOnlineVoicemailPolicy.md index a53361648f..db7071f157 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsOnlineVoicemailPolicy.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsOnlineVoicemailPolicy.md @@ -26,29 +26,32 @@ New-CsOnlineVoicemailPolicy [-Identity] [-EnableEditingCallAnswerRulesS [-EnableTranscriptionTranslation ] [-MaximumRecordingLength ] [-PostAmbleAudioFile ] [-PreambleAudioFile ] [-PreamblePostambleMandatory ] [-PrimarySystemPromptLanguage ] - [-SecondarySystemPromptLanguage ] [-ShareData ] [-WhatIf] [-Confirm] + [-SecondarySystemPromptLanguage ] [-ShareData ] [-EnableVoicemailTriage ] [-WhatIf] [-Confirm] [-Description ] [] ``` ## DESCRIPTION -Cloud Voicemail service provides organizations with voicemail deposit capabilities for Phone System -implementation. - -By default, users enabled for Phone System will be enabled for Cloud Voicemail. The Online Voicemail -policy controls whether or not voicemail transcription, profanity masking for the voicemail -transcriptions, translation for the voicemail transcriptions, and editing call answer rule settings -are enabled for a user. The policies also specify the voicemail maximum recording length for a user -and the primary and secondary voicemail system prompt languages. - -- Voicemail transcription is enabled by default -- Transcription profanity masking is disabled by default -- Transcription translation is enabled by default -- Editing call answer rule settings is enabled by default -- Voicemail maximum recording length is set to 5 minutes by default -- Primary and secondary system prompt languages are set to null by default and the user's voicemail language setting is used +Cloud Voicemail provides voicemail recording, deposit, and retrieval capabilities for Microsoft Teams and Teams Phone users. + +By default, Teams and Teams Phone users are enabled for Cloud Voicemail. The Online Voicemail Policy controls whether voicemail transcription, transcription profanity masking, transcription translation, AI-powered voicemail triage, and call answer rule editing are enabled for a user. The policy also specifies the maximum voicemail recording length and the primary and secondary system prompt languages used by the voicemail service. + +By default: + +- Voicemail transcription is enabled +- Transcription profanity masking is disabled +- Transcription translation is enabled +- Call answer rule editing is enabled +- The maximum voicemail recording length is 5 minutes +- The primary and secondary system prompt languages are not configured. The user's voicemail language setting is used instead +- AI-powered voicemail triage is disabled Tenant admin would be able to create a customized online voicemail policy to match the organization's requirements. +> [!IMPORTANT] +> The following configuration parameters will only work for customers that are participating in the Voice Applications private preview for these features. General Availability for this functionality has not been determined at this time. +> +> - EnableVoicemailTriage + ## EXAMPLES ### Example 1 @@ -58,6 +61,15 @@ New-CsOnlineVoicemailPolicy -Identity "CustomOnlineVoicemailPolicy" -MaximumReco The command shown in Example 1 creates a per-user online voicemail policy CustomOnlineVoicemailPolicy with MaximumRecordingLength set to 60 seconds and other fields set to tenant level global value. +### Example 2 +``` +New-CsOnlineVoicemailPolicy -Identity "CustomOnlineVoicemailPolicy" -Description "Test Desc" -EnableTranscription $true -EnableTranscriptionProfanityMasking $true -EnableEditingCallAnswerRulesSetting $true -MaximumRecordingLength "00:05:00" -EnableTranscriptionTranslation $true -PreamblePostambleMandatory $false -EnableVoicemailTriage $true + +``` +This example creates a custom Online Voicemail policy with transcription, transcription translation, profanity masking, voicemail rule editing, and Voicemail Triage enabled. The policy also limits voicemail recordings to 5 minutes and makes preamble/postamble messages optional. + +When Voicemail Triage is enabled, eligible users receive AI-generated insights based on the voicemail transcription, such as a concise summary and additional metadata that help them quickly understand and prioritise voicemail messages without listening to the entire recording. + ## PARAMETERS ### -Confirm @@ -156,6 +168,23 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -EnableVoicemailTriage +Specifies whether AI-powered voicemail triage is enabled. + +When enabled, voicemail messages delivered to users with an eligible Microsoft 365 Copilot license are enriched with AI-generated metadata derived from the voicemail transcription, including a summary, identified action items, a suggested category, and an importance classification. + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Identity A unique identifier specifying the scope, and in some cases the name, of the policy. @@ -270,6 +299,9 @@ Accept wildcard characters: False Specifies whether voicemail and transcription data are shared with the service for training and improving accuracy. Possible values are Defer and Deny. +> [!IMPORTANT] +> This parameter is deprecated and no longer has any effect. Its value is ignored by the service and is retained only for backward compatibility. + ```yaml Type: String Parameter Sets: (All) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsSharedVoicemailTriageSettingsTemplate.md b/teams/teams-ps/MicrosoftTeams/New-CsSharedVoicemailTriageSettingsTemplate.md new file mode 100644 index 0000000000..d167ebbeef --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/New-CsSharedVoicemailTriageSettingsTemplate.md @@ -0,0 +1,177 @@ +--- +applicable: Microsoft Teams Queues App, Outlook +author: vijurtse +external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml +Locale: en-US +Module Name: MicrosoftTeams +ms.author: vijurtse +ms.reviewer: williamlooney +online version: https://learn.microsoft.com/powershell/module/microsoftteams/New-CsSharedVoicemailTriageSettingsTemplate +schema: 2.0.0 +title: New-CsSharedVoicemailTriageSettingsTemplate +--- + +# New-CsSharedVoicemailTriageSettingsTemplate + +## SYNOPSIS +The Shared Voicemail Triage Settings Template enables automatic triage of Shared Voicemail using a compliant Substrate Large Language Model (LLM). +It also defines which LLM‑generated fields are added to each shared voicemail message, including the importance flag, summary, suggested actions, and categories. +All data is processed in real time by the model, and the results are stored in your organization’s Exchange environment as part of the delivered voicemail message. + +## SYNTAX + +``` +New-CsSharedVoicemailTriageSettingsTemplate -Name -Description [-EnableUrgencyDetection ] [-EnableCategoryDetection ] [-EnableCallToActionDetection ] [-EnableVoiceToTextSummary ] [] + +``` + +## DESCRIPTION +Use the New-CsSharedVoicemailTriageSettingsTemplate cmdlet to create a template for AI triage of Shared Voicemails. The template defines which LLM‑generated fields will be added to each shared voicemail message, including the importance flag, summary, suggested actions, and categories. + +## EXAMPLES + +### Example 1 +``` +New-CsSharedVoicemailTriageSettingsTemplate -Name "Voicemails triage with summaries, actions and categories " -Description "Template will enable automatic triage of voicemails and generate summary, identify message importance actions and category" + +``` +This example creates a new template for automatic triaging of Shared Voicemails, with all triage capabilities enabled by default: summary generation, message prioritization, action identification, and category assignment. + +### Example 2 +``` +New-CsSharedVoicemailTriageSettingsTemplate -Name "Voicemails triage without summaries and actions" -Description "Template will enable automatic triage of voicemails and identify message importance and category" -EnableUrgencyDetection $true -EnableCategoryDetection $true -EnableVoiceToTextSummary $false -EnableCallToActionDetection $false + +``` +This example creates a new template for automatic triage of Shared Voicemails with message prioritization and action identification enabled only. + +## PARAMETERS + +### -Description + +A description for the template for automatic voicemails triage + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -EnableCallToActionDetection + +When enabled, LLM identifies all actionable tasks in the voicemail and also assigns standard action types such as Callback, Email Reply, Set Appointment, Reschedule Appointment, or Cancel Appointment. + +PARAMVALUE: True| False + +```yaml +Type: bool + +Required: False +Position: Named +Default value: True +``` + +### -EnableCategoryDetection + +When enabled, LLM assigns category as short noun representing the voicemail’s primary intent. +Standard categories such as Junk or Harmful Content may also be applied when appropriate. + +PARAMVALUE: True| False + +```yaml +Type: bool + +Required: False +Position: Named +Default value: True +``` + +### -EnableUrgencyDetection + +When enabled, LLM identifies time critical messages and marks them as Important + +PARAMVALUE: True| False + +```yaml +Type: bool + +Required: False +Position: Named +Default value: True +``` + +### -EnableVoiceToTextSummary + +When enabled, LLM generates a one paragraph summary for a message. The first sentence captures the caller’s intent, followed by key details such as dates, times, required actions, and contact information. + +PARAMVALUE: True| False + +```yaml +Type: bool + +Required: False +Position: Named +Default value: True +``` + + +### -Name + +The name of the template. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters + +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None + +## OUTPUTS + +### Microsoft.Rtc.Management.OAA.Models.AutoAttendant + +## NOTES + +## RELATED LINKS + +[Get-CsSharedVoicemailTriageSettingsTemplate](./Get-CsSharedVoicemailTriageSettingsTemplate.md) + +[Set-CsSharedVoicemailTriageSettingsTemplate](./Set-CsSharedVoicemailTriageSettingsTemplate.md) + +[Remove-CsSharedVoicemailTriageSettingsTemplate](./Remove-CsSharedVoicemailTriageSettingsTemplate.md) + +[New-CsCallQueue](./New-CsCallQueue.md) + +[Get-CsCallQueue](./Get-CsCallQueue.md) + +[Set-CsCallQueue](./Set-CsCallQueue.md) + +[Remove-CsCallQueue](./Remove-CsCallQueue.md) + +[New-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/new-csautoattendant) + +[Get-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/get-csautoattendant) + +[Set-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/set-csautoattendant) + +[Remove-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/remove-csautoattendant) + + diff --git a/teams/teams-ps/MicrosoftTeams/Remove-CsSharedVoicemailTriageSettingsTemplate.md b/teams/teams-ps/MicrosoftTeams/Remove-CsSharedVoicemailTriageSettingsTemplate.md new file mode 100644 index 0000000000..9893e465f4 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Remove-CsSharedVoicemailTriageSettingsTemplate.md @@ -0,0 +1,98 @@ +--- +applicable: Microsoft Teams +author: tomkau +external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml +Locale: en-US +Module Name: MicrosoftTeams +ms.author: tomkau +ms.reviewer: williamlooney +online version: https://learn.microsoft.com/powershell/module/microsoftteams/Remove-CsSharedVoicemailTriageSettingsTemplate +schema: 2.0.0 +title: Remove-CsSharedVoicemailTriageSettingsTemplate +--- + +# Remove-CsSharedVoicemailTriageSettingsTemplate + +## SYNOPSIS +This cmdlet deletes a Shared Voicemail Settings Triage template. Before deleting a template, ensure that it is not associated with any Auto Attendant or Call Queue, as templates that are currently in use cannot be removed. + +## SYNTAX + +``` +Remove-CsSharedVoicemailTriageSettingsTemplate -Id [] +``` + +## DESCRIPTION +Use the Remove-CsSharedVoicemailTriageSettingsTemplate to delete a Shared Voicemail Triage template. + +## EXAMPLES + +### Example 1 +``` +Remove-CsSharedVoicemailTriageSettingsTemplate -Id 5e3a575e-1faa-49ff-83c2-5cf1c36c0e01 +``` + +This example deletes the Shared Voicemail Triage template with the identity 5e3a575e-1faa-49ff-83c2-5cf1c36c0e01. If no Shared Voicemail Triage template exists with the identity 5e3a575e-1faa-49ff-83c2-5cf1c36c0e01, then this example generates an error. + +## PARAMETERS + +### -Id + +The Id parameter is the unique identifier assigned to the Shared Voicemail Triage template. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters + +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None + +## OUTPUTS + +### Microsoft.Rtc.Management.OAA.Models.AutoAttendant + +## NOTES + +## RELATED LINKS + +[New-CsSharedVoicemailTriageSettingsTemplate](./New-CsSharedVoicemailTriageSettingsTemplate.md) + +[Get-CsSharedVoicemailTriageSettingsTemplate](./Get-CsSharedVoicemailTriageSettingsTemplate.md) + +[Set-CsSharedVoicemailTriageSettingsTemplate](./Set-CsSharedVoicemailTriageSettingsTemplate.md) + +[New-CsCallQueue](./New-CsCallQueue.md) + +[Get-CsCallQueue](./Get-CsCallQueue.md) + +[Set-CsCallQueue](./Set-CsCallQueue.md) + +[Remove-CsCallQueue](./Remove-CsCallQueue.md) + +[New-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/new-csautoattendant) + +[Get-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/get-csautoattendant) + +[Set-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/set-csautoattendant) + +[Remove-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/remove-csautoattendant) + +[Get-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/get-csautoattendant) + +[Set-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/set-csautoattendant) + +[Remove-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/remove-csautoattendant) + diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsAutoAttendant.md b/teams/teams-ps/MicrosoftTeams/Set-CsAutoAttendant.md index bd8b31e68a..fb51cdb20a 100644 --- a/teams/teams-ps/MicrosoftTeams/Set-CsAutoAttendant.md +++ b/teams/teams-ps/MicrosoftTeams/Set-CsAutoAttendant.md @@ -44,11 +44,12 @@ $christmasCallHandlingAssociation = New-CsAutoAttendantCallHandlingAssociation - $autoAttendant.CallFlows += @($christmasCallFlow) $autoAttendant.CallHandlingAssociations += @($christmasCallHandlingAssociation) +$autoAttendant.SharedVoicemailTriageSettingsTemplateId = "aaa85a3c-440b-4332-b15c-f70d24030636" Set-CsAutoAttendant -Instance $autoAttendant ``` -This example adds a Christmas holiday to an AA that has an Identity of fa9081d6-b4f3-5c96-baec-0b00077709e5. +This example adds a Christmas holiday to an AA that has an Identity of fa9081d6-b4f3-5c96-baec-0b00077709e5 and enables automatic triage of Shared Voicemails with AI. ### Example 2 ```powershell diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsCallQueue.md b/teams/teams-ps/MicrosoftTeams/Set-CsCallQueue.md index 382df9e1a0..d153959b38 100644 --- a/teams/teams-ps/MicrosoftTeams/Set-CsCallQueue.md +++ b/teams/teams-ps/MicrosoftTeams/Set-CsCallQueue.md @@ -20,7 +20,7 @@ Updates a Call Queue in your Skype for Business Online or Teams organization. ## SYNTAX ``` -Set-CsCallQueue -Identity [-AgentAlertTime ] [-AllowOptOut ] [-ChannelId ] [-ChannelUserObjectId ] [-ShiftsTeamId ] [-ShiftsSchedulingGroupId ] [-DistributionLists ] [-MusicOnHoldAudioFileId ] [-Name ] [-OboResourceAccountIds ] [-OverflowAction ] [-OverflowActionTarget ] [-OverflowActionCallPriority ] [-OverflowThreshold ] [-RoutingMethod ] [-TimeoutAction ] [-Tenant ] [-TimeoutActionTarget ] [-TimeoutActionCallPriority ] [-TimeoutThreshold ] [-NoAgentApplyTo ] [-NoAgentAction ] [-NoAgentActionTarget ] [-NoAgentActionCallPriority ] [-UseDefaultMusicOnHold ] [-WelcomeMusicAudioFileId ] [-PresenceBasedRouting ] [-ConferenceMode ] [-Users ] [-LanguageId ] [-LineUri ] [-OverflowDisconnectTextToSpeechPrompt ][-OverflowDisconnectAudioFilePrompt ] [-OverflowRedirectPersonTextToSpeechPrompt ] [-OverflowRedirectPersonAudioFilePrompt ] [-OverflowRedirectVoiceAppTextToSpeechPrompt ] [-OverflowRedirectVoiceAppAudioFilePrompt ] [-OverflowRedirectPhoneNumberTextToSpeechPrompt ] [-OverflowRedirectPhoneNumberAudioFilePrompt ] [-OverflowRedirectVoicemailTextToSpeechPrompt ] [-OverflowRedirectVoicemailAudioFilePrompt ] [-OverflowSharedVoicemailTextToSpeechPrompt ] [-OverflowSharedVoicemailAudioFilePrompt ] [-EnableOverflowSharedVoicemailTranscription ] [-EnableOverflowSharedVoicemailSystemPromptSuppression ] [-TimeoutDisconnectTextToSpeechPrompt ][-TimeoutDisconnectAudioFilePrompt ] [-TimeoutRedirectPersonTextToSpeechPrompt ] [-TimeoutRedirectPersonAudioFilePrompt ] [-TimeoutRedirectVoiceAppTextToSpeechPrompt ] [-TimeoutRedirectVoiceAppAudioFilePrompt ] [-TimeoutRedirectPhoneNumberTextToSpeechPrompt ][-TimeoutRedirectPhoneNumberAudioFilePrompt ] [-TimeoutRedirectVoicemailTextToSpeechPrompt ] [-TimeoutRedirectVoicemailAudioFilePrompt ] [-TimeoutSharedVoicemailTextToSpeechPrompt ] [-TimeoutSharedVoicemailAudioFilePrompt ] [-TimeoutSharedVoicemailTextToSpeechPrompt ] [-TimeoutSharedVoicemailAudioFilePrompt ] [-EnableTimeoutSharedVoicemailTranscription ] [-EnableTimeoutSharedVoicemailSystemPromptSuppression ] [-NoAgentDisconnectTextToSpeechPrompt ][-NoAgentDisconnectAudioFilePrompt ] [-NoAgentRedirectPersonTextToSpeechPrompt ] [-NoAgentRedirectPersonAudioFilePrompt ] [-NoAgentRedirectVoiceAppTextToSpeechPrompt ] [-NoAgentRedirectVoiceAppAudioFilePrompt ] [-NoAgentRedirectPhoneNumberTextToSpeechPrompt ] [-NoAgentRedirectPhoneNumberAudioFilePrompt ] [-NoAgentRedirectVoicemailTextToSpeechPrompt ] [-NoAgentRedirectVoicemailAudioFilePrompt ] [-NoAgentSharedVoicemailTextToSpeechPrompt ] [-NoAgentSharedVoicemailAudioFilePrompt ] [-EnableNoAgentSharedVoicemailTranscription ] [-EnableNoAgentSharedVoicemailSystemPromptSuppression ] [AuthorizedUsers ] [-HideAuthorizedUsers ] [-WelcomeTextToSpeechPrompt ] [-IsCallbackEnabled ] [-CallbackRequestDtmf ] [-WaitTimeBeforeOfferingCallbackInSecond ] [-NumberOfCallsInQueueBeforeOfferingCallback ] [-CallToAgentRatioThresholdBeforeOfferingCallback ] [-CallbackOfferAudioFilePromptResourceId ] [-CallbackOfferTextToSpeechPrompt ] [-CallbackEmailNotificationTarget ] [-ServiceLevelThresholdResponseTimeInSecond [Int16> ] [-ComplianceRecordingForCallQueueTemplateId ] [-TextAnnouncementForCR ] [-CustomAudioFileAnnouncementForCR ] [-TextAnnouncementForCRFailure ] [-CustomAudioFileAnnouncementForCRFailure ] [-ShouldOverwriteCallableChannelProperty ] [-SharedCallQueueHistoryTemplateId ] [-AutoRecordingTemplateId ] [] +Set-CsCallQueue -Identity [-AgentAlertTime ] [-AllowOptOut ] [-ChannelId ] [-ChannelUserObjectId ] [-ShiftsTeamId ] [-ShiftsSchedulingGroupId ] [-DistributionLists ] [-MusicOnHoldAudioFileId ] [-Name ] [-OboResourceAccountIds ] [-OverflowAction ] [-OverflowActionTarget ] [-OverflowActionCallPriority ] [-OverflowThreshold ] [-RoutingMethod ] [-TimeoutAction ] [-Tenant ] [-TimeoutActionTarget ] [-TimeoutActionCallPriority ] [-TimeoutThreshold ] [-NoAgentApplyTo ] [-NoAgentAction ] [-NoAgentActionTarget ] [-NoAgentActionCallPriority ] [-UseDefaultMusicOnHold ] [-WelcomeMusicAudioFileId ] [-PresenceBasedRouting ] [-ConferenceMode ] [-Users ] [-LanguageId ] [-LineUri ] [-OverflowDisconnectTextToSpeechPrompt ][-OverflowDisconnectAudioFilePrompt ] [-OverflowRedirectPersonTextToSpeechPrompt ] [-OverflowRedirectPersonAudioFilePrompt ] [-OverflowRedirectVoiceAppTextToSpeechPrompt ] [-OverflowRedirectVoiceAppAudioFilePrompt ] [-OverflowRedirectPhoneNumberTextToSpeechPrompt ] [-OverflowRedirectPhoneNumberAudioFilePrompt ] [-OverflowRedirectVoicemailTextToSpeechPrompt ] [-OverflowRedirectVoicemailAudioFilePrompt ] [-OverflowSharedVoicemailTextToSpeechPrompt ] [-OverflowSharedVoicemailAudioFilePrompt ] [-EnableOverflowSharedVoicemailTranscription ] [-EnableOverflowSharedVoicemailSystemPromptSuppression ] [-TimeoutDisconnectTextToSpeechPrompt ][-TimeoutDisconnectAudioFilePrompt ] [-TimeoutRedirectPersonTextToSpeechPrompt ] [-TimeoutRedirectPersonAudioFilePrompt ] [-TimeoutRedirectVoiceAppTextToSpeechPrompt ] [-TimeoutRedirectVoiceAppAudioFilePrompt ] [-TimeoutRedirectPhoneNumberTextToSpeechPrompt ][-TimeoutRedirectPhoneNumberAudioFilePrompt ] [-TimeoutRedirectVoicemailTextToSpeechPrompt ] [-TimeoutRedirectVoicemailAudioFilePrompt ] [-TimeoutSharedVoicemailTextToSpeechPrompt ] [-TimeoutSharedVoicemailAudioFilePrompt ] [-TimeoutSharedVoicemailTextToSpeechPrompt ] [-TimeoutSharedVoicemailAudioFilePrompt ] [-EnableTimeoutSharedVoicemailTranscription ] [-EnableTimeoutSharedVoicemailSystemPromptSuppression ] [-NoAgentDisconnectTextToSpeechPrompt ][-NoAgentDisconnectAudioFilePrompt ] [-NoAgentRedirectPersonTextToSpeechPrompt ] [-NoAgentRedirectPersonAudioFilePrompt ] [-NoAgentRedirectVoiceAppTextToSpeechPrompt ] [-NoAgentRedirectVoiceAppAudioFilePrompt ] [-NoAgentRedirectPhoneNumberTextToSpeechPrompt ] [-NoAgentRedirectPhoneNumberAudioFilePrompt ] [-NoAgentRedirectVoicemailTextToSpeechPrompt ] [-NoAgentRedirectVoicemailAudioFilePrompt ] [-NoAgentSharedVoicemailTextToSpeechPrompt ] [-NoAgentSharedVoicemailAudioFilePrompt ] [-EnableNoAgentSharedVoicemailTranscription ] [-EnableNoAgentSharedVoicemailSystemPromptSuppression ] [AuthorizedUsers ] [-HideAuthorizedUsers ] [-WelcomeTextToSpeechPrompt ] [-IsCallbackEnabled ] [-CallbackRequestDtmf ] [-WaitTimeBeforeOfferingCallbackInSecond ] [-NumberOfCallsInQueueBeforeOfferingCallback ] [-CallToAgentRatioThresholdBeforeOfferingCallback ] [-CallbackOfferAudioFilePromptResourceId ] [-CallbackOfferTextToSpeechPrompt ] [-CallbackEmailNotificationTarget ] [-ServiceLevelThresholdResponseTimeInSecond [Int16> ] [-ComplianceRecordingForCallQueueTemplateId ] [-TextAnnouncementForCR ] [-CustomAudioFileAnnouncementForCR ] [-TextAnnouncementForCRFailure ] [-CustomAudioFileAnnouncementForCRFailure ] [-ShouldOverwriteCallableChannelProperty ] [-SharedCallHistoryTemplateId ] [-AutoRecordingTemplateId ] [-SharedVoicemailTriageSettingsTemplateId ] [] ``` ## DESCRIPTION @@ -59,14 +59,19 @@ Set-CsCallQueue cmdlet provides a way for you to modify the properties of an exi > - -NoAgentRedirectVoicemailTextToSpeechPrompt > - -NoAgentRedirectVoicemailAudioFilePrompt > -> Shared call queue history -> - -SharedCallQueueHistoryTemplateId -> +> Shared call history +> - -SharedCallHistoryTemplateId +> +> Automatic Recording +> - -AutoRecordingTemplateId +> +> Automatic triage of Shared Voicemails with AI +> - -SharedVoicemailTriageSettingsTemplateId +> > The following configuration parameters will only work for customers that are participating in the Voice Applications private preview for these features. General Availability for this functionality has not been determined at this time. > -> Shared call queue history -> - -SharedCallQueueHistoryTemplateId > - -AutoRecordingTemplateId +> - -SharedVoicemailTriageSettingsTemplateId > > Authorized users can't edit call queues with these features enabled: > - The call exception routing when the destination directly references another Auto attendant or Call queue @@ -89,6 +94,10 @@ Set-CsCallQueue -Identity e7e00636-47da-449c-a36b-1b3d6ee04440 -DistributionList This example updates the Call Queue with new distribution lists and references a new music on hold audio file using the audio file ID from the stored variable $audioFile created with the [Import-CsOnlineAudioFile cmdlet](https://learn.microsoft.com/powershell/module/microsoftteams/import-csonlineaudiofile) +### Example 3 +Set-CsCallQueue -Identity e7e00636-47da-449c-a36b-1b3d6ee04440 -SharedVoicemailTriageSettingsTemplateId 3a4b3d9b-91d8-4fbf-bcff-6907f325842c +This example enables automatic triage with AI for shared voicemail messages received by the Call Queue. + ## PARAMETERS ### -AgentAlertTime @@ -1190,14 +1199,14 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -SharedCallQueueHistoryTemplateId +### -SharedCallHistoryTemplateId -The SharedCallQueueHistoryTemplateId parameter indicates the Shared Call Queue History template to apply to the call queue. +The SharedCallHistoryTemplateId parameter indicates the Shared Call History template to apply to the call queue. > [!NOTE] > `-ConferenceMode` must be set to $true > -> Shared call queue history is not availble when using a Teams channel for queue membership +> Shared call history is not availble when using a Teams channel for queue membership > - `-ChannelId` and `-ChannelUserObjectId` are set. ```yaml @@ -1211,6 +1220,26 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` +### -SharedVoicemailTriageSettingsTemplateId + +The SharedVoicemailTriageSettingsTemplateId enables automatic triage of Shared Voicemails using a compliant Substrate Large Language Model (LLM). It also specifies which additional LLM‑generated fields are added to each shared voicemail message, including the importance flag, summary, suggested actions, and categories. All data is processed in real time and stored in Exchange as part of the delivered voicemail message. + +> [!NOTE] +> Voicemail transcription must be enabled in your Voicemail Policies. The LLM‑based triage process relies exclusively on the voicemail transcription. If the tenant’s configured language is not supported for voicemail transcription, no transcription will be generated and automatic triaging will not occur. +> + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -ShiftsSchedulingGroupId diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsOnlineVoicemailPolicy.md b/teams/teams-ps/MicrosoftTeams/Set-CsOnlineVoicemailPolicy.md index f069563cdd..86b455c9e4 100644 --- a/teams/teams-ps/MicrosoftTeams/Set-CsOnlineVoicemailPolicy.md +++ b/teams/teams-ps/MicrosoftTeams/Set-CsOnlineVoicemailPolicy.md @@ -23,23 +23,31 @@ Modifies an existing Online Voicemail policy. Set-CsOnlineVoicemailPolicy [[-Identity] ] [-Description ] [-EnableEditingCallAnswerRulesSetting ] [-EnableTranscription ] [-EnableTranscriptionProfanityMasking ] [-EnableTranscriptionTranslation ] [-MaximumRecordingLength ] [-PostambleAudioFile ] [-PostambleAudioFile ] [-PreamblePostambleMandatory ] -[-PrimarySystemPromptLanguage ] [-SecondarySystemPromptLanguage ] [-ShareData ] [-WhatIf] [-Confirm] [] +[-PrimarySystemPromptLanguage ] [-SecondarySystemPromptLanguage ] [-ShareData ] [-EnableVoicemailTriage ] [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION -Cloud Voicemail service provides organizations with voicemail deposit capabilities for Phone System implementation. +Cloud Voicemail provides voicemail recording, deposit, and retrieval capabilities for Microsoft Teams and Teams Phone users. -By default, users enabled for Phone System will be enabled for Cloud Voicemail. The Online Voicemail policy controls whether or not voicemail transcription, profanity masking for the voicemail transcriptions, translation for the voicemail transcriptions, and editing call answer rule settings are enabled for a user. The policies also specify the voicemail maximum recording length for a user and the primary and secondary voicemail system prompt languages. +By default, Teams and Teams Phone users are enabled for Cloud Voicemail. The Online Voicemail Policy controls whether voicemail transcription, transcription profanity masking, transcription translation, AI-powered voicemail triage, and call answer rule editing are enabled for a user. The policy also specifies the maximum voicemail recording length and the primary and secondary system prompt languages used by the voicemail service. -- Voicemail transcription is enabled by default -- Transcription profanity masking is disabled by default -- Transcription translation is enabled by default -- Editing call answer rule settings is enabled by default -- Voicemail maximum recording length is set to 5 minutes by default -- Primary and secondary system prompt languages are set to null by default and the user's voicemail language setting is used +By default: + +- Voicemail transcription is enabled +- Transcription profanity masking is disabled +- Transcription translation is enabled +- Call answer rule editing is enabled +- The maximum voicemail recording length is 5 minutes +- The primary and secondary system prompt languages are not configured. The user's voicemail language setting is used instead +- AI-powered voicemail triage is disabled Tenant admin would be able to create a customized online voicemail policy to match the organization's requirements. +> [!IMPORTANT] +> The following configuration parameters will only work for customers that are participating in the Voice Applications private preview for these features. General Availability for this functionality has not been determined at this time. +> +> - EnableVoicemailTriage + ## EXAMPLES ### Example 1 @@ -56,6 +64,14 @@ Set-CsOnlineVoicemailPolicy -EnableTranscriptionProfanityMasking $false The command shown in Example 2 changes the EnableTranscriptionProfanityMasking to false for tenant level global online voicemail policy when calling without Identity parameter. +### Example 3 +``` +Set-CsOnlineVoicemailPolicy -Identity "CustomOnlineVoicemailPolicy" -EnableTranscription $true -EnableVoicemailTriage $true +``` +This command enables AI-powered voicemail triage for users assigned to the specified Online Voicemail Policy. + +When AI-powered voicemail triage is enabled, voicemail messages delivered to users with an eligible Microsoft 365 Copilot license include an AI-generated summary, identified action items, a suggested category, and an importance classification. + ## PARAMETERS ### -Confirm @@ -154,6 +170,23 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -EnableVoicemailTriage +Specifies whether AI-powered voicemail triage is enabled. + +When enabled, voicemail messages delivered to users with an eligible Microsoft 365 Copilot license are enriched with AI-generated metadata derived from the voicemail transcription, including a summary, identified action items, a suggested category, and an importance classification. + +```yaml +Type: Boolean +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Identity A unique identifier specifying the scope, and in some cases the name, of the policy. @@ -264,7 +297,10 @@ Accept wildcard characters: False ### -ShareData -Specifies whether voicemail and transcription data are shared with the service for training and improving accuracy. Possible values are Defer and Deny. +Specifies whether voicemail and transcription data are shared with the service for training and improving accuracy. Possible values are Defer and Deny. +> [!IMPORTANT] +> This parameter is deprecated and no longer has any effect. Its value is ignored by the service and is retained only for backward compatibility. +> ```yaml Type: String @@ -278,6 +314,7 @@ Accept pipeline input: False Accept wildcard characters: False ``` + ### -WhatIf Describes what would happen if you executed the command without actually executing the command. diff --git a/teams/teams-ps/MicrosoftTeams/Set-CsSharedVoicemailTriageSettingsTemplate.md b/teams/teams-ps/MicrosoftTeams/Set-CsSharedVoicemailTriageSettingsTemplate.md new file mode 100644 index 0000000000..df290fa829 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Set-CsSharedVoicemailTriageSettingsTemplate.md @@ -0,0 +1,136 @@ +--- +applicable: Microsoft Teams Queues App, Outlook +author: vijurtse +external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml +Locale: en-US +Module Name: MicrosoftTeams +ms.author: vijurtse +ms.reviewer: williamlooney +online version: https://learn.microsoft.com/powershell/module/microsoftteams/Set-CsSharedVoicemailTriageSettingsTemplate +schema: 2.0.0 +title: Set-CsSharedVoicemailTriageSettingsTemplate +--- + +# Set-CsSharedVoicemailTriageSettingsTemplate + +## SYNOPSIS + +The Set‑CsSharedVoicemailTriageSettingsTemplate cmdlet updates the configuration for automatic triage of Shared Voicemails performed by the Substrate Large Language Model (LLM). You can enable or disable individual triage capabilities, including summary generation, message prioritization, suggested actions, and category assignment. + +To fully disable LLM‑based triaging for Shared Voicemails, the corresponding triage settings template must be removed from the associated Call Queue, Auto Attendant, or Main Line Attendant configuration. Alternatively, you can delete the template itself using Remove‑CsSharedVoicemailTriageSettingsTemplate. + +## SYNTAX + +``` +Set-CsSharedVoicemailTriageSettingsTemplate -Instance [] + +``` + +## DESCRIPTION +Use the Set‑CsSharedVoicemailTriageSettingsTemplate cmdlet to update the triage rules applied to Shared Voicemails. You can enable or disable individual LLM‑based triage capabilities, including summary generation, message prioritization, suggested actions, and category assignment. + +## EXAMPLES + +### Example 1 + +``` +$templateInstance = Get-CsSharedVoicemailTriageSettingsTemplate -Id 3a4b3d9b-91d8-4fbf-bcff-6907f325842c +$templateInstance.Name = "Triage without urgency identification" +$templateInstance.Description = "Template to triage voicemails while skipping message‑urgency identification" +$templateInstance.EnableUrgencyDetection = $false +$templateInstance.EnableCategoryDetection = $true +$templateInstance.EnableCallToActionDetection = $true +$templateInstance.EnableVoiceToTextSummary = $true +Set-CsSharedVoicemailTriageSettingsTemplate -Instance $templateInstance + + +``` +This example updates the template name and description, and disables identification of voicemail message importance. + +### Example 2 + +``` +$templateInstance = Get-CsSharedVoicemailTriageSettingsTemplate -Id 3a4b3d9b-91d8-4fbf-bcff-6907f325842c +$templateInstance.EnableUrgencyDetection = $true +$templateInstance.EnableCategoryDetection = $false +$templateInstance.EnableCallToActionDetection = $false +$templateInstance.EnableVoiceToTextSummary = $true +Set-CsSharedVoicemailTriageSettingsTemplate -Instance $templateInstance + +``` +This example disables identification of category and actions for shared voicemail messages. + + +### Example 3 + +``` +$templateInstance = Get-CsSharedVoicemailTriageSettingsTemplate -Id 3a4b3d9b-91d8-4fbf-bcff-6907f325842c +$templateInstance.EnableUrgencyDetection = $false +$templateInstance.EnableCategoryDetection = $false +$templateInstance.EnableCallToActionDetection = $false +$templateInstance.EnableVoiceToTextSummary = $false +Set-CsSharedVoicemailTriageSettingsTemplate -Instance $templateInstance + +``` +This example disables adding LLM‑generated fields to Shared Voicemail messages only. To fully stop LLM involvement, the triage settings template must be removed from the associated Call Queue, Auto Attendant, or Main Line Attendant configuration. Alternatively, you can delete the template itself using Remove‑CsSharedVoicemailTriageSettingsTemplate. + +## PARAMETERS + +### -Instance + +The instance of the Voicemail triage template to change + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + + + +### CommonParameters + +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### None + +## OUTPUTS + +### Microsoft.Rtc.Management.OAA.Models.AutoAttendant + +## NOTES + +## RELATED LINKS + +[New-CsSharedVoicemailTriageSettingsTemplate](./New-CsSharedVoicemailTriageSettingsTemplate.md) + +[Get-CsSharedVoicemailTriageSettingsTemplate](./Get-CsSharedVoicemailTriageSettingsTemplate.md) + +[Remove-CsSharedVoicemailTriageSettingsTemplate](./Remove-CsSharedVoicemailTriageSettingsTemplate.md) + +[New-CsCallQueue](./New-CsCallQueue.md) + +[Get-CsCallQueue](./Get-CsCallQueue.md) + +[Set-CsCallQueue](./Set-CsCallQueue.md) + +[Remove-CsCallQueue](./Remove-CsCallQueue.md) + +[New-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/new-csautoattendant) + +[Get-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/get-csautoattendant) + +[Set-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/set-csautoattendant) + +[Remove-CsAutoAttendant](https://learn.microsoft.com/powershell/module/microsoftteams/remove-csautoattendant) + + +