New-CsRgsPrompt
Tópico modificado em: 2012-05-21
Cria um novo prompt de fluxo de trabalho para o Aplicativo Grupo de Resposta. Um prompt de fluxo de trabalho é um arquivo de áudio tocado ou um texto lido para fornecer informações adicionais aos chamadores.
Sintaxe
New-CsRgsPrompt [-AudioFilePrompt <AudioFile>] [-TextToSpeechPrompt <String>]
Descrição Detalhada
Manter os chamadores bem informados sobre o que está acontecendo, e o motivo, é uma parte importante do fluxo de trabalho de um Grupo de Resposta. Por exemplo, o fluxo de trabalho pode estar configurado para atender ao telefone e pôr a chamada em espera imediatamente até que um agente esteja disponível. Isso é ótimo, mas também é necessário informar ao chamador que: 1) o telefone foi atendido; e 2) que a chamada vai ser posta em espera até que um agente esteja disponível. Fornecer informações como essas é o trabalho do prompt de fluxo de trabalho.
O Aplicativo Grupo de Resposta tem suporte a dois tipos diferentes de prompts de fluxo de trabalho. Primeiro, é possível gravar previamente um arquivo de áudio para depois tocá-lo. Para fazer isso, você deve gravar o prompt ("Por favor aguarde. Sua chamada é importante para nós") em formato .WAV ou .WMA; importar o arquivo usando o cmdlet Import-CsRgsAudioFile; e atribuir o arquivo a um prompt de fluxo de trabalho. Outra opção é apenas fornecer o texto a ser lido e, quando o prompt for necessário, o Aplicativo Grupo de Resposta usará suas capacidades de conversão de texto em fala para "ler" o texto em voz alta. Prompts de conversão de texto em fala são mais fáceis de serem configurados: não há arquivos de áudio para gravar e importar. No entanto, prompts de arquivos de áudio costumam ter maior qualidade e fidelidade.
Note que o idioma usado em um prompt de conversão de texto em fala é o mesmo usado no fluxo de trabalho pai.
O cmdlet New-CsRgsPrompt oferece uma maneira de criar prompts de fluxo de trabalho. Cada vez que for necessário usar um prompt, ele deve ser criado do zero; não há como salvar e reutilizar prompts (isso significa será preciso reimportar arquivos de áudio). Ao criar um novo prompt de fluxo de trabalho, você terá que fornecer um prompt de conversão de texto em fala; se preferir, pode fornecer um prompt de arquivo de áudio. Caso forneça tanto um prompt de conversão de texto em fala quanto um arquivo de áudio, o Aplicativo Grupo de Resposta usará o arquivo de áudio por padrão, e usará o prompt de conversão de texto em fala apenas se o arquivo de áudio não estiver disponível. Depois que os novos prompts são criados na memória, a referência de objeto correspondente costuma ser adicionada à ação de chamada de um Grupo de Resposta.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsRgsPrompt localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. No entanto, como este cmdlet cria um objeto na memória e, por si só, não faz alterações no sistema, ele pode essencialmente ser executado por qualquer pessoa. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsPrompt"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
TextToSpeechPrompt |
Obrigatório |
Cadeia de caracteres |
Prompt de TTS (conversão de texto em fala) a ser lido quando o fluxo de trabalho é ativado. O prompt de TTS, que é usado apenas se nenhum arquivo de áudio for especificado, pode conter no máximo 4096 caracteres. |
AudioFilePrompt |
Opcional |
Objeto AudioFile |
Arquivo de áudio a ser tocado quando o fluxo de trabalho é ativado. O arquivo de áudio deve ser importado usando o cmdlet Import-CsRgsAudioFile. |
Tipos de Entrada
Nenhuma. New-CsRgsPrompt não aceita entrada em pipeline.
Tipos de Retorno
New-CsRgsPrompt cria instâncias do objeto Microsoft.Rtc.Management.WritableSettings.Prompt.
Exemplo
-------------------------- Exemplo 1 ------------------------
$queue = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$prompt = New-CsRgsPrompt -TextToSpeechPrompt "Welcome to the help desk. Please hold."
$z = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueID $queue.Identity
Os comandos mostrados no Exemplo 1 demonstram como um prompt de fluxo de trabalho e uma fila de Grupo de Resposta podem ser incluídos em uma nova ação de chamada. No primeiro comando, o cmdlet Get-CsRgsQueue é usado para retornar uma referência de objeto ($queue) à fila de Grupo de Resposta Help Desk. No segundo comando, o cmdlet New-CsRgsPrompt é usado para criar um novo prompt de conversão de texto em fala, "Welcome to the help desk. Please hold" ("Bem-vindo ao suporte técnico. Por favor aguarde"). Esse novo prompt é armazenado em uma variável chamada $prompt.
O comando final do exemplo usa New-CsRgsCallAction para criar uma nova ação de chamada de Grupo de Resposta ($z). Ao criar a ação de chamada, a referência de objeto $prompt (que contém o prompt de fluxo de trabalho recém-criado) é usada como valor do parâmetro Prompt; a referência de objeto $queue é usada em conjunto com o parâmetro QueueID. Depois de executar este comando, a nova ação de chamada e seu novo prompt de fluxo de trabalho estarão prontos para serem adicionados a um fluxo de trabalho de Grupo de Resposta.
-------------------------- Exemplo 2 ------------------------
$queue = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue"
$audioFile = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "welcome.wav" -Content (Get-Content C:\Media\Welcome.wav -Encoding byte -ReadCount 0)
$prompt = New-CsRgsPrompt -AudioFilePrompt $audioFile -TextToSpeechPrompt "Welcome to the help desk. Please hold."
$z = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueID $queue.Identity
Os comandos mostrados no Exemplo 2 são uma variação dos comandos mostrados no Exemplo 1. Neste caso, no entanto, o novo prompt de fluxo de trabalho inclui um prompt de arquivo de áudio, além de um prompt de conversão de texto em fala. Para incluir um arquivo de áudio em um prompt de fluxo de trabalho, o segundo comando no exemplo usa o cmdlet Import-CsRgsAudioFile para importar o arquivo de áudio C:\Media\Welcome.wav. O arquivo importado é então armazenado em uma variável chamada $audioFile.
Depois que o arquivo de áudio tiver sido importado, ele e o prompt de conversão de texto em fala serão adicionados a um novo prompt de fluxo de trabalho ($prompt). Para isso, o parâmetro AudioFilePrompt é definido como $audioFile, e o parâmetro TextToSpeechPrompt é definido como o valor de texto "Welcome to the help desk. Please hold" ("Bem-vindo ao suporte técnico. Por favor aguarde").