New-CsRgsPrompt
Dernière rubrique modifiée : 2012-05-21
Crée un nouveau message de workflow pour l’application Response Group. Un message de workflow est un fichier audio qui est diffusé ou un texte qui est lu à haute voix pour fournir aux appelants des informations supplémentaires.
Syntaxe
New-CsRgsPrompt [-AudioFilePrompt <AudioFile>] [-TextToSpeechPrompt <String>]
Description détaillée
Le fait de tenir les appelants informés sur les opérations en cours et sur le pourquoi de ces opérations est un élément clé d’un workflow Response Group. Par exemple, vous pouvez configurer un workflow pour répondre à un appel, puis mettre immédiatement l’appel en attente jusqu’à ce qu’un agent soit disponible. Mais, ceci fait, vous devez également signaler à l’appelant que : 1) son appel a été traité et que 2) l’appel va être mis en attente jusqu’à ce qu’un agent soit disponible. Le message de worflow a pour fonction de fournir ce type d’information.
L’application Response Group prend en charge deux types distincts de message de workflow. Tout d’abord, vous pouvez pré-enregistrer et diffuser un fichier audio. Pour ce faire, vous devez enregistrer le message (« Veuillez patienter, nous traitons votre appel ».) dans un fichier au format .WAV ou .WMA, importer le fichier à l’aide de la cmdlet Import-CsRgsAudioFile, puis affecter le fichier à un message de workflow. Vous pouvez aussi simplement fournir le texte à lire et, lorsque le message est nécessaire, laisser l’application Response Group faire appel à ses fonctions vocales pour « lire » le texte à haute voix. Les messages vocaux sont simples à configurer : vous n’avez aucun fichier audio à enregistrer ou à importer. En revanche, les messages des fichiers audio sont généralement de meilleure qualité et offrent un meilleur niveau de fidélité.
Notez que la langue employée dans un message vocal est la même que celle utilisée dans le workflow parent.
La cmdlet New-CsRgsPrompt vous permet de créer des messages de workflow. Chaque fois que vous devez utiliser un message, vous devez le créer de zéro car il n’existe aucun moyen d’enregistrer, ni de réutiliser les messages, ce qui signifie que vous devrez également réimporter les fichiers audio. Lorsque vous créez un message de workflow, vous devez fournir un message vocal. Si vous le souhaitez, vous pouvez également diffuser un message via un fichier audio. Si vous fournissez un message vocal et un message par fichier audio, l’application Response Group utilise par défaut le fichier audio et n’a recours au message vocal que si le fichier audio n’est pas disponible. Une fois les nouveaux messages créés en mémoire, la référence d’objet correspondante est généralement ajoutée à une action d’appel Response Group.
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-CsRgsPrompt : 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-CsRgsPrompt"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TextToSpeechPrompt |
Obligatoire |
Chaîne |
Message vocal à lire lorsque le workflow est activé. Le message vocal, utilisé uniquement si aucun fichier audio n’est spécifié, peut contenir jusqu’à 4 096 caractères. |
AudioFilePrompt |
Facultatif |
Objet AudioFile |
Fichier audio diffusé lorsque le workflow est activé. Vous devez importer le fichier audio à l’aide de la cmdlet Import-CsRgsAudioFile. |
Types d’entrées
Aucun. New-CsRgsPrompt n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsRgsPrompt crée des instances de l’objet Microsoft.Rtc.Management.WritableSettings.Prompt.
Exemple
-------------------------- Exemple 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
Les commandes présentées dans l’exemple 1 montrent comment inclure un message de workflow (et une file d’attente Response Group) dans une nouvelle action d’appel. Dans la première commande, la cmdlet Get-CsRgsQueue permet de retourner une référence d’objet ($queue) à la file d’attente Response Group, « Help Desk ». Dans la deuxième commande, la cmdlet New-CsRgsPrompt permet ensuite de créer le message vocal « Welcome to the help desk. Please hold ». Le nouveau message est stocké dans la variable $prompt.
Dans la dernière commande de l’exemple, New-CsRgsCallAction permet de créer une action d’appel Response Group ($z). Au moment de créer cette action d’appel, la référence d’objet $prompt (qui contient le nouveau message de workflow) est affectée en tant que valeur du paramètre Prompt. De même, la référence d’objet $queue est utilisée avec le paramètre QueueID. Une fois la commande exécutée, la nouvelle action d’appel et son nouveau message de workflow sont prêts à être ajoutés à un workflow Response Group.
-------------------------- Exemple 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
Les commandes présentées dans l’exemple 2 sont des variantes des commandes de l’exemple 1. Dans ce cas, toutefois, le nouveau message de workflow contient un message avec fichier audio et un message vocal. Pour inclure un fichier audio dans un message de workflow, la seconde commande de l’exemple utilise la cmdlet Import-CsRgsAudioFile pour importer le fichier audio C:\Media\Welcome.wav qui est ensuite stocké dans une variable $audioFile.
Une fois le fichier audio importé, il est ajouté avec un message vocal à un nouveau message de workflow ($prompt). Pour ce faire, le paramètre AudioFilePrompt est affecté de la valeur $audioFile et le paramètre TextToSpeechPrompt du texte « Welcome to the help desk. Please hold ».