New-CsRgsPrompt
Última modificación del tema: 2012-05-21
Crea una indicación de grupo de trabajo para la Aplicación de grupo de respuesta. Una indicación de flujo de trabajo es un archivo de audio que se reproduce, o texto que se lee en voz alta, para suministrar al autor de la llamada información adicional.
Sintaxis
New-CsRgsPrompt [-AudioFilePrompt <AudioFile>] [-TextToSpeechPrompt <String>]
Descripción detallada
Mantener a los autores de llamadas informados sobre qué está pasando y por qué es una parte importante del flujo de trabajo de un grupo de respuesta. Por ejemplo, el flujo de trabajo puede configurarse para responder a las llamadas y colocarlas en espera de inmediato hasta que haya un agente disponible. Es un proceso correcto, pero es necesario informar al autor de la llamada que: 1) se ha respondido a la llamada; y, 2) la llamada estará en espera hasta que haya un agente disponible. Suministrar este tipo de información es la tarea de la indicación de flujo de trabajo.
La Aplicación de grupo de respuesta admite dos tipos de indicaciones de flujo de trabajo. Una opción, es grabar un archivo de audio para reproducirlo después. Para ello, primero debe grabar la indicación ("Por favor, espere. Su llamada es importante para nosotros.") en formato .WAV o .WMA; importar el archivo con el cmdlet Import-CsRgsAudioFile; y, a continuación, asignar el archivo a una indicación de flujo de trabajo. Otra opción es especificar el texto que debe leerse y, cuando la indicación sea necesaria, el Aplicación de grupo de respuesta usará la función de texto a voz para leer el texto en voz alta. Las indicaciones de texto a voz son más fáciles de configurar: no es necesario grabar ni importar archivos de audio. Sin embargo, las indicaciones de archivo de audio suelen tener mayor calidad y fidelidad.
Tenga en cuenta que el lenguaje utilizado en una indicación de texto a voz es el mismo que el utilizado en el flujo de trabajo primario.
El cmdlet New-CsRgsPrompt permite crear indicaciones de flujo de trabajo. Cada vez que necesite usar una indicación deberá crearla desde cero; no es posible guardar y reutilizar indicaciones. (Esto significa que también tendrá que volver a importar archivos de audio.) Al crear una indicación de flujo de trabajo debe especificar una indicación de texto a voz; si lo desea, también puede especificar una indicación de archivo de audio. Si especifica tanto una indicación de texto a voz como un archivo de audio, la Aplicación de grupo de respuesta usará el archivo de audio de manera predeterminada, y sólo usará la indicación de texto a voz si el archivo de audio no está disponible. Una vez creadas las indicaciones en la memoria, normalmente se agrega la referencia al objeto correspondiente a una acción de llamada de grupo de respuesta.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsRgsPrompt localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Sin embargo, debido a que este cmdlet crea un objeto en memoria y que no realiza ningún cambio en el sistema por sí mismo, puede ejecutarlo prácticamente cualquier usuario. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsPrompt"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
TextToSpeechPrompt |
Requerido |
Cadena de caracteres |
Indicación de texto a voz (TTS) que se leerá al activar el flujo de trabajo. La indicación de texto a voz (TTS), que sólo se usa si no se especifica un archivo de audio, puede contener un máximo de 4096 caracteres. |
AudioFilePrompt |
Opcional |
Objeto AudioFile |
Archivo de audio que se reproducirá al activar el flujo de trabajo. El archivo de audio debe importarse con el cmdlet Import-CsRgsAudioFile. |
Tipos de entrada
Ninguno. New-CsRgsPrompt no acepta entradas canalizadas.
Tipos de valores devueltos
New-CsRgsPrompt crea instancias del objeto Microsoft.Rtc.Management.WritableSettings.Prompt.
Ejemplo
-------------------------- Ejemplo 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
Los comandos del Ejemplo 1 muestran como incluir una indicación de flujo de trabajo (y una cola de grupo de respuesta) en una acción de llamada nueva. En el primer comando, se usa el cmdlet Get-CsRgsQueue para devolver una referencia a objeto ($queue) al servicio de asistencia de la cola del grupo de respuesta. En el segundo comando, se usa el cmdlet New-CsRgsPrompt para crear una indicación de texto a voz "Welcome to the help desk. Please hold." Esta nueva indicación se almacena en una variable llamada $prompt.
En el último comando del ejemplo, se usa New-CsRgsCallAction para crear una acción de llamada de grupo de respuesta ($z). Al crear la acción de llamada, se usa la referencia a objeto $prompt (que contiene la indicación de flujo de trabajo recién creada) como valor del parámetro Prompt; del mismo modo, la referencia a objeto $queue se usa en combinación con el parámetro QueueID. Una vez ejecutado el comando, la nueva acción de llamada y su indicación de flujo de trabajo están listas para agregarse a un flujo de trabajo de grupo de respuesta.
-------------------------- Ejemplo 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
Los comandos del Ejemplo 2 son una variación de los del Ejemplo 1. Aunque, en este caso, la nueva indicación de flujo de trabajo incluye una indicación de archivo de audio, además de la indicación de texto a voz. Con el fin de incluir un archivo de audio en una indicación de flujo de trabajo, el segundo comando del ejemplo usa el cmdlet Import-CsRgsAudioFile para importar el archivo de audio C:\Media\Welcome.wav. El archivo importado se almacena en una variable llamada $audioFile.
Cuando se ha importado el archivo de audio, la indicación de audio y la de texto a voz se agregan a una nueva indicación de flujo de trabajo ($prompt). Para ello, el parámetro AudioFilePrompt se establece en $audioFile, y TextToSpeechPrompt se establece en el valor de texto "Welcome to the help desk. Please hold."