New-CsRgsCallAction
Última modificación del tema: 2012-03-23
Crea una acción de llamada para Grupo de respuesta. La Aplicación de grupo de respuesta utiliza acciones de llamada para determinar qué hará el sistema al recibir una llamada. Por ejemplo, una acción de llamada puede especificar que se transfiera una llamada a otra cola, que se haga una pregunta específica del Grupo de respuesta o que se finalice la llamada.
Sintaxis
New-CsRgsCallAction -Action <Nullable> [-Prompt <Prompt>] [-Question <Question>] [-QueueID <Nullable>] [-Uri <String>]
Descripción detallada
Cuando alguien llama a un número de teléfono asociado con la Aplicación de grupo de respuesta, la aplicación determina qué flujo de trabajo corresponde al número llamado. Cuando detecta el flujo de trabajo, el servicio comprueba si la llamada se ha recibido fuera del horario laboral o en un festivo. De ser así, el servicio lleva a cabo la acción especificada para llamadas recibidas fuera del horario laboral o en un festivo. Por ejemplo, transferir la llamada directamente al correo de voz. Si la llamada se recibe durante el horario laboral, la Aplicación de grupo de respuesta lleva a cabo la acción preconfigurada para llamadas recibidas durante el horario laboral. Todas estas acciones se determinan con anterioridad y se crean con el cmdlet New-CsRgsCallAction. New-CsRgsCallAction permite colocar las llamadas en la cola de un Grupo de respuesta; enviarlas al correo de voz, a una dirección SIP o a un número de teléfono de una red telefónica conmutada (RTC); transferirlas a una pregunta de respuesta de voz interactiva (IVR); o cerrarlas.
Al usar New-CsRgsCallAction no se modifican directamente las propiedades de un flujo de trabajo, una cola, ni ningún otro elemento de la Aplicación de grupo de respuesta. De hecho, la acción de llamada creada sólo existe inicialmente en la memoria y debe almacenarse en una variable de referencia a objeto (como $x). Cuando es necesario modificar algo (como, por ejemplo, la propiedad DefaultAction de un flujo de trabajo) se asigna esta referencia a objeto a la propiedad correspondiente. Por ejemplo:
-DefaultAction $x
Debe tener en cuenta que las dos únicas acciones de llamada que se pueden asignar a la propiedad DefaultAction son TransferToQueue y TransferToQuestion. El resto de acciones de llamada (salvo TransferToQueue y TransferToQuestion) son válidas para acciones que se producen en días festivos o fuera de horario laboral. Asimismo, todas las acciones de llamada salvo TransferToQuestion se pueden usar para tiempos de espera y desbordamientos de cola.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsRgsCallAction de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Sin embargo, dado que este cmdlet crea un objeto en memoria y, por sí mismo, no hace ningún cambio en el sistema, básicamente puede ejecutarlo cualquiera. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsCallAction"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Action |
Requerido |
Modificador de lista PS |
Representa la acción de llamada que se llevará a cabo. El parámetro Action debe definirse en uno de estos valores: Terminate – Se finaliza la llamada. TransferToQueue – Se transfiere la llamada a una cola de grupo de respuesta. TransferToQuestion – Se transfiere la llamada a una pregunta de grupo de respuesta. TransferToUri – Se transfiere la llamada al URI de SIP especificado. TransferToVoiceMailUri – Se transfiere la llamada al correo de voz. TransferToPSTN – Se transfiere la llamada a un teléfono de una red telefónica conmutada (RTC). El valor Action debe especificarse cada vez que se crea una acción de llamada; no hay valor predeterminado. |
Prompt |
Opcional |
Objeto Prompt |
Indicación que se reproducirá antes de llevar a cabo la acción de llamada. (Por ejemplo, "Por favor espere mientras transferimos su llamada".) Las indicaciones se crean con el cmdlet New-CsRgsPrompt. |
Question |
Opcional |
Objeto Question |
Pregunta que se hará si el valor Action se ha definido como TransferToQuestion. La pregunta debe crearse con el cmdlet New-CsRgsQuestion. Este parámetro es obligatorio si el valor Action se ha definido como TransferToQuestion. |
QueueID |
Opcional |
Identidad Xds |
Identidad de la cola del Grupo de respuesta al que debe transferirse la llamada (se asume que el valor Action se ha establecido como TransferToQueue). El valor QueueID puede especificarse con precisión usando Get-CsRgsQueue para recuperar la identidad de la cola correspondiente. Este parámetro es obligatorio si el valor Action se ha definido como TransferToQueue. |
Uri |
Opcional |
Cadena de caracteres |
Dirección SIP, URI de correo de voz o número de teléfono RTC al que se transferirá la llamada. Este parámetro es obligatorio si el valor Action se ha definido como TransferToUri; TransferToVoiceMailUri; o TransferToPSTN. |
Tipos de entrada
Ninguno. New-CsRgsCallAction no acepta la entrada transferida.
Tipos de valores devueltos
New-CsRgsCallAction crea nuevas instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.CallAction.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Overflow"
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $x.Identity
$z.OverflowAction = $y
Set-CsRgsQueue $z
Los comandos del Ejemplo 1 muestran cómo crear una acción de llamada de Grupo de Respuesta y asignarla a una cola de Grupo de Respuesta existente; en este caso, la acción de llamada determina qué sucederá si se alcanza el desbordamiento de cola. Para ello, en primer lugar se usa Get-CsRgsQueue para recuperar la cola de la Aplicación de grupo de respuesta Help Desk Overflow Queue de ApplicationServer:atl-cs-001.litwareinc.com; la información de esta cola se almacena en una variable llamada $x. A continuación se usa un comando similar para recuperar la cola Help Desk, con esa información almacenada en una variable llamada $z.
Después de recuperar las colas se usa el cmdlet New-CsRgsPrompt para crear una indicación de texto a voz que acompañe a la acción de llamada. La nueva acción de llamada se crea con el cmdlet New-CsRgsCallAction. Se asignan tres parámetros a la acción de llamada: Prompt (la indicación que usará la acción de llamada); Action (indica qué pasará si la nueva acción de llamada se desencadena; el valor del parámetro TransferToQueue significa que la llamada se transferirá a otra cola de Grupo de respuesta); y QueueID, la cola alternativa a la que se transferirá la llamada ($x.Identity, que representa la identidad de la cola Help Desk Overflow Queue). La nueva acción de llamada se crea en la memoria y se almacena en una variable llamada $y.
Una vez creada la acción de llamada, ya puede asignarla a la cola Help Desk; para ello, debe definirse el valor de la propiedad OverflowAction como $y, la variable que contiene la acción de llamada recién creada. Si la cola Help Desk "se desborda" (es decir, si alcanza el número máximo de autores de llamadas permitidos) las siguientes llamadas se transferirán automáticamente a la cola Help Desk Overflow.
Finalmente, el último comando del ejemplo llama a Set-CsRgsQueue para escribir los cambios en la instancia real de la cola Help Desk Overflow en ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 2 ------------------------
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToPSTN -Uri "sip:+14255551298@litwareinc.com"
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue"
$z.OverflowAction = $y
Set-CsRgsQueue $z
Los comandos que se muestran en el Ejemplo 2 son similares a los comandos del Ejemplo 1. Sin embargo, aquí la nueva acción de llamada transfiere la llamada a un número de teléfono de una RTC. Para ello, la propiedad Action de la nueva acción de llamada se define como TransferToPSTN y la propiedad Uri como "sip:+14255551298@litwareinc.com".