VOICEBOT STREAM

Intègre un agent virtuel en libre-service avec des scripts vocaux à l'aide d'un flux continu audio provenant de la plateforme. Cette action permet à NiCE CXone d'utiliser l'audio en continu avec des SIP Protocole utilisé pour la signalisation et le contrôle de sessions de communication multimédia telles que les appels vocaux et vidéo.connexions. Cette action ne vous permet pas de modifier le comportement de l'agent virtuel entre les tours. Vous n'avez besoin que d'une seule instance de cette action dans votre script.

Dépendances

Cette action est destinée uniquement à être utilisée avec l'Google Dialogflow CX VoiceStream agent virtuel Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct.. Utilisez cette action à la place de l'action VOICEBOT EXCHANGE pour les intégrations avec Dialogflow CX VoiceStream.

Types de script pris en charge

Téléphone

Propriétés de Saisie

Ces propriétés définissent les données que l'action utilise lors de son exécution.Vous pouvez utiliser la substitution de variables dans toutes les propriétés de cette action.

Propriété	Description
Ajouter une légende	Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action.
virtualAgentId	Nom de l'agent virtuel sélectionné dans le Virtual Agent Hub. Lorsque vous attribuez une application d'agent virtuel à une action Studio dans Virtual Agent Hub, cette propriété est automatiquement renseignée. Le nom est la valeur utilisée dans le champ Virtual Agent (Bot) Name de l'application Virtual Agent Hub. Vous pouvez utiliser la substitution de variable dans cette propriété.
Charge utile personnalisée vers le Bot	``` La variable qui contient la charge utile personnalisée à envoyer à l'agent virtuel Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct.. Entrez le nom de l'objet JSON qui transmet les données du script à l'agent virtuel. You devez définir l'objet charge utile personnalisée dans une action Snippet.L'objet doit être converti en JSON, soit dans le snippet, soit dans la propriété customPayload. N'utilisez pas cette propriété si vous devez traiter des données que l’agent virtuel renvoie au script. Utilisez plutôt la variable customPayloadVarName (sortie). ```
Intention initiale	La première intention La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir. que l'action envoie à l'agent virtuel Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct..

Propriétés de sortie

Ces propriétés contiennent des variables qui stockent les données renvoyées par l'exécution de l'action. Elles sont disponibles à des fins de référence et d’utilisation lorsque l'action est terminée.

Propriété	Description
CustomPayloadFromBotVarName (out)	Cette variable contient la charge utile personnalisée renvoyée par l'agent virtuel Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct..
ErrorDetailsVarName (out)	Lorsque la branche Error est prise, cette variable contient les détails associés à l'erreur.

Conditions de branche de Résultat

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition	Description
Par défaut	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
OnContained	La branche prise lorsque l'interaction avec l'agent virtuel se termine avec succès.
Error During Session	Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.
On Escalate	La branche taken lorsque l'interaction est escaladée vers un agent humain.
On Failed to Initialize	La branche prise lorsque le profil nommé dans virtualAgentID comporte des identifiants incorrects ou que le mauvais profil d'agent virtuel est sélectionné.

Meilleures pratiques pour la Charge utile personnalisée avec Dialogflow CX VoiceStream

Lors de l'utilisation de cette action avec Dialogflow CX VoiceStream, suivre ces meilleures pratiques pour l'intégration des charges utiles personnalisées :

• Vous pouvez transmettre des données personnalisées à Dialogflow CX à l'aide de paires clé-valeur JSON. Dans un Extrait Action dans votre script, créez un objet customPayload dynamique et ajoutez-y les paires clé-valeur. Par exemple :

  DYNAMIC customPayload
  customPayload.ani = ani
  customPayload.contactID = contactId
  customPayload.masterContactId = masterId
  customPayloadJSON = "{customPayload.asJSON()}"	

• Dans le VoiceBOT STREAM action dans votre script, configurez la propriété customPayload avec une variable qui possède la fonction asJSON() dans sa valeur. Vous trouverez cette variable dans l’objet customPayload.
• Transmettez le JSON customPayload à l'agent virtuel à l'aide de la propriété Payload de QueryParameters. Consultez la documentation Google sur QueryParameters pour Google Dialogflow CX.
• Les données transmises via QueryParameters sont reçues par un webhook dans Dialogflow CX.Vous pouvez écrire du code dans la Dialogflow Console CX pour gérer les données transmises.
• Ne pas imbriquer un objet dans l'objet customPayload. Les objets imbriqués sont envoyés sous forme de chaînes littérales.
• Pour transmettre des données personnalisées de votre agent virtuel Dialogflow CX vers le script, utilisez le champ Charge utile personnalisée dans la console Dialogflow CX.Vérifiez que vous vous trouvez dans la console de l’agent virtuel que vous utilisez avec NiCE CXone. Mappez ceci à votre script à l'aide de la variable customPayloadVarName (out) dans l'action VOICEBOT STREAM de votre script.

• Pour transmettre des données personnalisées à Dialogflow CX depuis le script, utilisez session_params dans l'objet customPayload dans une action Snippet. Par exemple :

  DYNAMIC customPayload
  customPayload.session_params.name = "Winnie le Pooh" 
  customPayload.session_params.job = "Food critic" 
  customPayload.session_params.location = "Hundred Acre Wood"	

  Accédez aux paramètres de session dans l’intention de l’agent Dialogflow CX à l’aide de la syntaxe suivante :

  $session.params.name = Winnie Le Pooh
  $session.params.job = Food critic
  $session.params.location = 100 Acre Wood 

  Les paramètres de session sont uniquement utilisés avec les agents virtuels Dialogflow CX. Pour obtenir un résultat similaire avec Dialogflow ES, utilisez les contextes.

• Configurez les indices de contexte de parole et un ID de conversation personnalisé pour transférer la conversation vers un agent virtuel CX Dialogflow différent dans l'extrait Charge utile personnalisée .

• Pour configurer la durée pendant laquelle l'agent virtuel attend lorsque le contact fait une pause en parlant, ajoutez le paramètre maxPostEnergySilenceMS à l'action Extrait Next Prompt Behaviors ou Default Next Prompt Behaviors.