New-CsRgsCallAction
Tópico modificado em: 2012-03-23
Cria uma nova ação de chamada do Grupo de Resposta. O Aplicativo Grupo de Resposta usa ações de chamada para determinar o procedimento a ser seguido pelo sistema quando uma chamada for recebida. Por exemplo, uma ação de chamada pode especificar que uma chamada seja transferida para outra fila de espera, que uma pergunta específica do Grupo de Resposta seja feita ou que a chamada seja encerrada.
Sintaxe
New-CsRgsCallAction -Action <Nullable> [-Prompt <Prompt>] [-Question <Question>] [-QueueID <Nullable>] [-Uri <String>]
Descrição Detalhada
Quando alguém liga para um número de telefone associado ao Aplicativo Grupo de Resposta, o aplicativo pesquisa o fluxo de trabalho que corresponde ao número de telefone discado. Após a localização do fluxo de trabalho, o serviço verifica se a chamada foi recebida fora do horário comercial ou em um feriado. Em caso afirmativo, o serviço executa a ação especificada para as chamadas recebidas fora do horário comercial ou em um feriado. Por exemplo: a chamada poderá ser diretamente transferida para a caixa postal. Se a chamada tiver sido recebida durante o horário comercial, o Aplicativo Grupo de Resposta executará a ação pré-configurada nas chamadas recebidas durante o horário comercial. Todas essas ações são determinadas antecipadamente e são criadas usando o cmdlet New-CsRgsCallAction. O cmdlet New-CsRgsCallAction permite que as chamadas sejam colocadas em uma fila de espera do Grupo de Resposta, transferidas para a caixa postal, um endereço SIP ou um número de telefone da rede telefônica pública comutada (PSTN), transferidas para uma pergunta de resposta interativa de voz (IVR) ou encerradas.
Quando se utiliza o cmdlet New-CsRgsCallAction, as propriedades de um fluxo de trabalho, uma fila de espera ou outro elemento do Aplicativo Grupo de Resposta não são modificadas diretamente. Em vez disso, a nova ação de chamada criada existirá inicialmente apenas na memória e deverá ser armazenada em uma variável de referência de objeto (como $x). Quando chegar o momento de modificar algo (como a propriedade DefaultAction de um fluxo de trabalho), a referência do objeto deve ser atribuída à propriedade relevante. Por exemplo:
-DefaultAction $x
Deve-se observar que as únicas duas ações de chamada que podem ser atribuídas à propriedade DefaultAction são TransferToQueue e TransferToQuestion. Todas as outras ações de chamada, exceto TransferToQueue e TransferToQuestion, são válidas para as ações que ocorrerem em feriados ou fora do horário comercial. Além disso, todas as ações de chamada, exceto TransferToQuestion, podem ser usadas para enfileirar tempos limite e excedentes.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsRgsCallAction localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. No entanto, como este cmdlet cria um objeto em memória e, por si próprio, não altera o sistema, essencialmente, ele pode ser executado por qualquer pessoa. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsCallAction"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Action |
Obrigatório |
Modificador de Lista PS |
Representa a ação a ser realizada envolvendo a chamada. A Ação deve ser definida como um dos seguintes valores: Terminate – a chamada será encerrada. TransferToQueue – a chamada será transferida para uma fila de espera do Grupo de resposta. TransferToQuestion – a chamada será transferida para uma pergunta do Grupo de resposta. TransferToUri – a chamada será transferida para o Identificador de recurso uniforme (URI) especificado do SIP. TransferToVoiceMailUri – a chamada será transferida para a caixa postal. TransferToPSTN – a chamada será transferida para um telefone da rede telefônica pública comutada (PSTN). A Ação deve ser especificada a cada vez que você criar uma nova ação de chamada; não há valor padrão. |
Prompt |
Opcional |
Objeto de prompt |
Prompt a ser executado antes que a ação de chamada seja efetuada. (Por exemplo, "Por favor, aguarde enquanto a sua chamada é transferida".) Os prompts devem ser criados usando-se o cmdlet New-CsRgsPrompt. |
Question |
Opcional |
objeto Question |
A Pergunta a ser feita se a Action tiver sido definida como TransferToQuestion. A pergunta deve ser criada usando-se o cmdlet New-CsRgsQuestion. Esse parâmetro é obrigatório se a Action tiver sido definida como TransferToQuestion. |
QueueID |
Opcional |
Identidade de Xds |
A identidade da fila de espera do Grupo de resposta para a qual a chamada deve ser transferida (considerando que Action tenha sido definida como TransferToQueue). QueueID é melhor especificado usando-se Get-CsRgsQueue, para recuperar a Identidade da fila de espera relevante. Esse parâmetro é obrigatório se Action for definida como TransferToQueue. |
Uri |
Opcional |
Cadeia de caracteres |
Endereço SIP, URI da caixa postal ou número de telefone da PSTN para o qual a chamada deve ser transferida. Esse parâmetro é obrigatório se Action tiver sido definida como TransferToUri, TransferToVoiceMailUri ou TransferToPSTN. |
Tipos de Entrada
Nenhuma. O cmdlet New-CsRgsCallAction não aceita entradas canalizadas.
Tipos de Retorno
New-CsRgsCallAction cria novas instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.CallAction.
Exemplo
-------------------------- Exemplo 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
Os comandos mostrados no Exemplo 1 mostram como se pode criar uma nova ação de chamada do Grupo de resposta e atribui-la a uma fila de espera do Grupo de resposta existente; neste caso, a ação de chamada determina o que acontecerá se o estouro da fila for atingido. Para executar esta tarefa, a primeira etapa é usar Get-CsRgsQueue para recuperar em ApplicationServer:atl-cs-001.litwareinc.com a fila de espera Excedente da assistência técnica da fila do Aplicativo Grupo de Resposta. As informações desta fila de espera são armazenadas em uma variável denominada $x. Um comando similar será então usado para recuperar a fila de espera Assistência Técnica, com tais informações armazenadas em uma variável denominada $z.
Depois de recuperar as filas de espera, o cmdlet New-CsRgsPrompt será usado para criar um prompt de texto em fala, para acompanhar a nova ação de chamada. A nova ação de chamada é criada executando-se o cmdlet New-CsRgsCallAction. Três parâmetros são atribuídos à ação de chamada: Prompt (o prompt a ser usado pela ação de chamada), Action (indica o que acontecerá se a nova ação de chamada for acionada; o valor de parâmetro TransferToQueue significa que a chamada será transferida a uma outra fila de espera do Grupo de resposta) e QueueID (a fila de espera alternativa para a qual a chamada será transferida; $x.Identity representa a Identidade da fila de espera Excedente da assistência técnica). A nova ação de chamada é criada na memória e, em seguida, armazenada em uma variável denominada $y.
Depois de criar a ação de chamada, ela pode ser atribuída à fila de espera Assistência Técnica; isso é feito pela definição do valor da propriedade OverflowAction como sendo $y, a variável que contém a ação de chamada recém-criada. Se a fila Assistência Técnica "estourar" (ou seja, se alcançar o número máximo de chamadores permitidos), quaisquer chamadas subsequentes serão transferidas automaticamente para a fila de espera Excedente da assistência técnica.
Finalmente, o último comando no exemplo chama Set-CsRgsQueue, para gravar em ApplicationServer:atl-cs-001.litwareinc.com as alterações à instância real da fila Excedente da assistência técnica.
-------------------------- Exemplo 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
Os comandos mostrados no Exemplo 2 são similares aos comandos mostrados no Exemplo 1. No Exemplo 2, no entanto, a nova ação de chamada transfere a chamada para um número de telefone da PSTN. Para isso, a propriedade Action é definida como TransferToPSTN e a propriedade Uri é definida como "sip:+14255551298@litwareinc.com".