Extrait de code Comportement de l’invite suivante

Les informations contenues dans cette page d’aide s’appliquent à la fois à CXone Studio et à Desktop Studio.

L’extrait de code Comportement de l’invite suivante vous permet de personnaliser les comportements pour un tour spécifique de la conversation. Si vous souhaitez définir des comportements par défaut pour tous les tours de la conversation, utilisez un extrait de code Comportements de l’invite suivante par défaut. Les comportements que vous pouvez définir sont le bruit de confort, la détection DTMF Tonalités de signalisation générées lorsqu’un utilisateur appuie ou appuie sur une touche du clavier de son téléphone., les délais et les dépassements de délai, et les interventions. Pour en savoir plus sur ces comportements, consultez la page d’aide Comportements des invites.

Utilisez cet extrait de code avec les actions qui ont la propriété nextPromptBehavior, telles que l’Cloud Transcribeactionaction ou l’Voicebot Exchangeactionaction .

Temps nécessaire pour chaque tour de conversation

Veillez à calculer le temps nécessaire pour chaque tour dans la conversation. Par exemple, prononcer un numéro à 14 chiffres peut prendre entre huit et quinze secondes s’il n’y a pas de pause, mais répondre Oui ou Non ne prend qu’une ou deux secondes. Pour saisir l’intégralité du numéro, le tour de conversation où le numéro est prononcé doit être plus long que le tour Oui/Non.

Au tour où le numéro est prononcé, vous devez augmenter maxUtteranceMilliseconds d’une longueur supérieure à la valeur par défaut. En outre, vous pouvez également allonger maxPostEnergySilenceMS pour ce tour. Cela permet de s’assurer que le contact a le temps d’énoncer le numéro.

Pour modifier ces valeurs pour un tour, placez une action SNIPPET avant et après l’action Voicebot Exchange pour ce tour. Dans l’SNIPPET avant Voicebot Exchange, modifiez les paramètres dont vous avez besoin. Dans l’SNIPPET après Voicebot Exchange, rétablissez les paramètres.

Ajouter un extrait de code Comportement de l’invite suivante

Ouvrez votre script dans Studio.
Ajoutez une action Snippet à votre script avant l’action Voicebot Exchange qui doit exécuter les comportements spécifiés. Si vous utilisez cet extrait de code pour des applications qui ne sont pas des agents virtuels, placez Snippet avant l’action Cloud Transcribe. Connectez les actions.

Ajoutez la déclaration d’objet suivante à l’extrait de code :

DYNAMIC nextPromptBehaviors
<add behaviors as needed>
ASSIGN nextPromptBehaviorsJson="{nextPromptBehaviors.asjson()}"

Ajoutez les comportements que vous voulez que l’action exécute en utilisant la syntaxe suivante :

ASSIGN nextPromptBehaviors.[comportement] = [valeur]

où [behavior] comprend le nom de la propriété et tous les noms des membres et sous-membres associés. Pour plus d’informations, voir l’exemple d’extrait de code dans la section suivante.
Configurez la propriété nextPromptBehavior de l’action Voicebot Exchange ou Cloud Transcribe avec la variable utilisée pour contenir le contenu JSON de l’objet nextPromptBehaviors. Dans l’exemple de code, il s’agit de nextPromptBehaviorsJson.

Propriétés pour le comportement des invites

Le tableau suivant décrit les propriétés disponibles pour les extraits de code Comportement de l’invite suivante . Les propriétés vous permettent de configurer les comportements de l’invite suivante . Les comportements sont décrits en détail dans la page d’aide Comportements des invites d’agent virtuel. Les comportements fonctionnent comme décrit lorsqu’ils sont utilisés avec des applications d’agents non virtuels de Transcription tour par tour.

L’exemple suivant d’un extrait Comportement de l’invite suivante montre les noms complets des membres et sous-membres de l’objet à utiliser pour chaque propriété.

Voir l’exemple

DYNAMIC nextPromptBehaviors
ASSIGN nextPromptBehaviors.silenceRules.engageComfortSequence="false"
ASSIGN nextPromptBehaviors.silenceRules.botResponseDelayTolerance=5000
//botResponseDelayTolerance is not related to userInputTimeout. 
ASSIGN nextPromptBehaviors.silenceRules.comfortPromptSequence.prompts[1].audioFilePath="comfort.wav"
ASSIGN nextPromptBehaviors.silenceRules.millisecondsToWaitForUserResponse=10000
ASSIGN nextPromptBehaviors.audioCollectionRules.collectionType="SEND_UTTERANCE_AUDIO"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.detectDtmf="true"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.clearDigits="true"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.terminationCharacters="#"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.stripTerminator="true"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.interDigitTimeoutMilliseconds=5000
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.maxDigits=10
ASSIGN nextPromptBehaviors.audioCollectionRules.bargeConfiguration.enableSpeakerBarge="true"
ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.maxPostEnergySilenceMS=500
ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.maxUtteranceMilliseconds=10000
ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.trimSilence=1
ASSIGN nextPromptBehaviorsJson="{nextPromptBehaviors.asjson()}"

Propriété	Comportement	Détails
audioFilePath	Bruit de confort pendant les retards de l’agent virtuel	Entrez l’emplacement du fichier audio de bruit de confort. Le fichier doit se trouver dans votrelocataire Regroupement organisationnel de haut niveau utilisé pour gérer le support technique, la facturation et les paramètres globaux pour votre environnement CXonela structure du fichier. Incluez le chemin complet si le fichier se trouve dans un dossier. La structure du fichier est appliquée comme elle le serait pour tout autre comportement d’invite. À utiliser avec : botResponseDelayTolerance engageComfortSequence
botResponseDelayTolerance	Bruit de confort pendant les retards de l’agent virtuel	Entrez la durée en millisecondes qui déclenche le fichier audio de bruit de confort. À utiliser avec : audioFilePath engageComfortSequence Cette propriété ne peut être utilisée qu’avec le comportement de bruit de confort. Il ne contrôle pas le moment où le script emprunte la branche userInputTimeout. millisecondsToWaitForUserResponse est la propriété qui contrôle le moment où cette branche est empruntée.
clearDigits	Collection DTMF	Définissez cette propriété sur true si vous souhaitez effacer le tampon de tonalités DTMF lorsque l’action commence. Le tampon met en cache les tonalités DTMF lorsque le contact appuie sur une touche du clavier de son téléphone. Cette propriété est similaire à la propriété clearDigits de l’action Menu. Cette propriété doit être utilisée avec detectDtmf. Il existe d’autres options liées aux DTMF que vous pouvez configurer avec des propriétés supplémentaires.
detectDtmf	Collection DTMF	Définissez cette propriété sur true si vous souhaitez que l’action capture les entrées DTMF. Cette propriété permet la collecte de tonalités DTMF. Pour configurer d’autres options liées aux DTMF, vous devez inclure d’autres propriétés : clearDigits terminationCharacters stripTerminator interDigitTimeoutMilliseconds maxDigits
enableSpeakerBarge	Intervention	Définissez cette propriété sur true pour activer l’intervention. Cette propriété doit être activée (true) pour la plupart des interactions avec le bot, mais peut être désactivée (false) lorsque l’audio contient des informations que l’appelant doit entendre, telles que des clauses de non-responsabilité. Cette propriété peut être utilisée seule.
engageComfortSequence	Bruit de confort pendant les retards de l’agent virtuel	Définissez cette propriété sur true si vous souhaitez activer le bruit de confort pour cette action. Définissez-la sur false si vous ne souhaitez pas que cette action utilise un bruit de confort. À utiliser avec : botResponseDelayTolerance audioFilePath
interDigitTimeoutMilliseconds	Collection DTMF Gestion du délai d’attente des contacts	Entrez la durée en millisecondes pendant laquelle le système attend après qu’un contact a saisi un chiffre pour déterminer si le contact entrera un autre chiffre. Cette propriété est similaire à la propriété InterDigitTimeout de l’action Menu. Cette propriété doit être utilisée avec detectDtmf. Il existe d’autres options liées aux DTMF que vous pouvez configurer avec des propriétés supplémentaires.
maxDigits	Collection DTMF	Saisissez le nombre maximal de chiffres que le contact peut saisir pour l’invite de cette action. Par exemple, si l’invite demande au contact de saisir les quatre derniers chiffres de son numéro d’identification, définissez cette propriété sur 4. Lorsque la valeur maxDigitsest atteinte, le script continue à s’exécuter. Cette propriété est similaire à la propriété MaxDigits de l’Menuaction . Cette propriété doit être utilisée avec detectDtmf. Il existe d’autres options liées aux DTMF que vous pouvez configurer avec des propriétés supplémentaires.
maxPostEnergySilenceMS	Gestion du délai d’attente des contacts	Configurez la durée en millisecondes pendant laquelle le bot attend après que le contact s’est arrêté pendant qu’il parlait. La valeur par défaut est de 500 millisecondes. Vous pouvez augmenter la durée de la pause pour réduire les risques que le bot interrompe les contacts. Plus la pause est longue, plus les échanges de l’interaction auront de latence. La meilleure pratique consiste à augmenter cette valeur uniquement lorsque vous vous attendez à ce que la réponse du contact soit composée de chiffres. Cette propriété peut être utilisée seule.
maxUtteranceMilliseconds	Traitement du bruit de fond Gestion du délai d’attente des contacts	Configurez la durée en millisecondes pendant laquelle le bot attend après avoir détecté l’audio du contact. Ce paramètre définit la longueur de la réponse. Lorsque la limite de maxUtteranceMilliseconds est atteinte, l’agent virtuel tente de déterminer une intention à partir de l’audio capturé. Cette fonction est utile lorsqu’il y a beaucoup de bruits de fond sur la ligne. Pour plus de détails sur le fonctionnement de cette propriété, reportez-vous à la page Comportement des invites d’agents virtuels. Cette propriété est définie par défaut comme millisecondsToWaitForUserResponse, même si vous avez personnalisé millisecondsToWaitForUserResponse. Il peut être nécessaire de modifier maxUtteranceMilliseconds en fonction de la durée de la réponse attendue du contact. Par exemple, 10 secondes (10 000 millisecondes) sont raisonnables pour une réponse courte d’un mot comme yes, no ou technical support. Les réponses attendues plus longues nécessiteront plus de temps. La valeur maximale est de cinq minutes (300 000 millisecondes). Cette propriété doit être utilisée avec millisecondsToWaitForUserResponse.
millisecondsToWaitForUserResponse	Gestion du délai d’attente des contacts Traitement du bruit de fond	Entrez la durée en millisecondes pendant laquelle l’action attend une réponse du contact avant d’expirer. Lorsque ce délai est atteint, le script prend la branche userInputTimeout. Cette propriété peut être utilisée seule. Lorsque vous configurez votre agent virtuel pour gérer des environnements bruyants, cette propriété doit être utilisée avec maxUtteranceMilliseconds.
stripTerminator	Collection DTMF	Définissez cette propriété sur true si vous souhaitez supprimer la valeur du caractère de fin des tonalités DTMF capturées. Cette propriété doit être utilisée avec detectDtmf. Il existe d’autres options liées aux DTMF que vous pouvez configurer avec des propriétés supplémentaires.
terminationCharacters	Collection DTMF	Saisissez le caractère que vous souhaitez que les contacts saisissent pour indiquer qu’ils ont fini de saisir les chiffres. Par exemple, vous pouvez souhaiter que les contacts appuient sur le signe dièse (#) lorsqu’ils ont fini de saisir un numéro de compte. Cette propriété est similaire à la propriété Termination de l’action Menu. Cette propriété doit être utilisée avec detectDtmf. Il existe d’autres options liées aux DTMF que vous pouvez configurer avec des propriétés supplémentaires.
trimSilence	Gestion du délai d’attente des contacts	Définissez -la sur true si vous souhaitez que le silence du début de l’énoncé soit supprimé de l’audio envoyé à l’agent virtuel. Cela permet de réduire le temps nécessaire au traitement de chaque énoncé. Cela peut contribuer à réduire la latence. La valeur par défaut de trimSilence est false. Cette propriété peut être utilisée seule.