New-CsRgsQuestion
Dernière rubrique modifiée : 2012-03-23
Crée une question Response Group. L’application Response Group utilise des questions pour proposer des choix aux appelants, puis elle exécute une action en fonction de ces choix.
Syntaxe
New-CsRgsQuestion -Prompt <Prompt> [-AnswerList <PSListModifier>] [-InvalidAnswerPrompt <Prompt>] [-Name <String>] [-NoAnswerPrompt <Prompt>]
Description détaillée
Pour pouvoir traiter les appels, l’application Response Group, en règle générale, donne une instruction ou pose une question, puis elle exécute une action en fonction de la réponse de l’appelant. Le service, par exemple, peut demander à l’appelant d’appuyer sur 1 pour sélectionner l’anglais ou sur 2 pour choisir l’espagnol. À la suite d’une question de ce type, le système doit attendre la réponse de l’appelant, puis il exécute l’action appropriée. Dans ce cas, cette action se traduira par un transfert de l’appel vers une file d’attente de langue anglaise si l’appelant appuie sur la touche 1 du clavier du téléphone ou par un transfert vers une file d’attente de langue espagnole si l’appelant appuie sur la touche 2.
Pour pouvoir créer une question, vous devez utiliser la cmdlet New-CsRgsQuestion. Lorsque vous créez une question Response Group, vous devez, au minimum, fournir un message (à savoir, la question elle-même) ainsi qu'un groupe de réponses. Si, par exemple, vous donnez la possibilité aux appelants d’appuyer sur 1 ou 2, deux réponses seront nécessaires : une pour définir l’action à exécuter si l’appelant appuie sur 1 et une autre pour spécifier l’action à exécuter s’il appuie sur 2. Si vous permettez aux appelants d’appuyer sur 1, 2, 3 ou 4, vous devez fournir quatre réponses, et ainsi de suite.
En outre, New-CsRgsQuestion permet de définir le message à utiliser si l’appelant répond de manière incorrecte ou ne répond pas du tout. Par exemple, si l’appelant dans le scénario d’origine appuie sur 3, le message peut être le suivant : « Désolé, cette réponse n’est pas correcte ». À cette étape, le message d’origine sera relu.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsRgsQuestion : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Cependant, parce que cette cmdlet crée un objet en mémoire et, en soi, n’apporte aucune modification au système,elle peut être exécutée par n’importe qui. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsQuestion"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Prompt |
Obligatoire |
Objet Message |
Question à poser à l’appelant. Vous devez créer les messages à l’aide de la cmdlet New-CsRgsPrompt. |
AnswerList |
Facultatif |
Modificateur de liste PS |
Tableau des réponses valides associées à la question. Par exemple, une question au support technique peut avoir Assistance matérielle, Installation de logiciel et Connexions réseau en guise de réponses. Vous devez créer les réponses à l’aide de la cmdlet New-CsRgsAnswer. |
InvalidAnswerPrompt |
Facultatif |
Objet Message |
Réponse diffusée si l’appelant sélectionne une réponse non valide. Vous devez créer le message InvalidAnswerPrompt à l’aide de la cmdlet New-CsRgsPrompt. Notez qu’après avoir lu le message InvalidAnswerPrompt, l’application répétera le message d’origine. |
Name |
Facultatif |
Chaîne |
Identificateur de la question. Les noms des questions, qui ne doivent pas être uniques, sont limités à 128 caractères au maximum. |
NoAnswerPrompt |
Facultatif |
Objet Message |
Réponse à diffuser si l’appelant ne répond pas au premier message. Vous devez créer le message NoAnswerPrompt à l’aide de la cmdlet New-CsRgsPrompt. |
Types d’entrées
Aucun. New-CsRgsQuestion n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsRgsQuestion crée des instances de l’objet Microsoft.Rtc.Management.WriteableSettings.Question.
Exemple
-------------------------- Exemple 1 ------------------------
$new = Get-CsRgsQueue -Identity service:ApplicationServer:pool0.litwareinc.com -Name "New Service Request"
$existing = Get-CsRgsQueue -Identity service:ApplicationServer:pool0.litwareinc.com -Name "Existing Service Request"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $new.Identity
$z = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $existing.Identity
$newRequest = New-CsRgsAnswer -Action $y -DtmfResponse 1 -VoiceResponseList "New" -Name "New Request"
$existingRequest = New-CsRgsAnswer -Action $z -DtmfResponse 2 -VoiceResponseList "Existing" -Name "Existing Request"
$u = New-CsRgsPrompt -TextToSpeechPrompt "Press 1 or say New for a new service request. Press 2 or say Existing for an existing service request."
$question = New-CsRgsQuestion -Prompt $u -AnswerList $newRequest $newRequest, $existingRequest
Les commandes présentées dans l’exemple 1 créent deux réponses Response Group et associent ces réponses à une nouvelle question Response Group. Pour créer les deux réponses, vous devez avant tout spécifier les actions d’appel à entreprendre en fonction de la réponse fournie par l’appelant. Par conséquent, les deux premières commandes de l’exemple créent des références d’objet à deux files d’attente Response Group : New Service Request et Existing Service Request. Une fois ces références d’objet créées, la commande suivante utilise New-CsRgsPrompt pour créer un message vocal stocké dans une variable appelée $w.
Une fois cette opération terminée, les deux commandes suivantes créent deux actions d’appel correspondantes : une pour transférer les appelants vers la file d’attente New Service Request et une autre pour les transférer vers la file d’attente Existing Service Request. Une fois les actions d’appel créées, la cmdlet New-CsRgsAnswer permet de créer deux réponses Response Group, une étant stockée dans la variable $newRequest, l’autre dans la variable $existingRequest.
Les deux réponses stockées, la cmdlet New-CsRgsPrompt peut ensuite servir à créer un message pour la nouvelle question. Dans cet exemple, le message est un message vocal qui demande à l’appelant d’appuyer sur 1 (soit « New ») pour une nouvelle demande de service ou sur 2 (soit « Existing ») pour une demande de service existante. Le message même est stocké dans une variable appelée $u.
Après création du message, vous pouvez appeler la cmdlet New-CsRgsQuestion pour créer la nouvelle question. Outre le paramètre Prompt, le paramètre, le paramètre AnswerList est utilisé pour indiquer les deux réponses associées à la question : les variables $newRequest et $existingRequest.