VOICEBOT STREAM

Cette page d'aide s'applique à Studio. Ces informations sont aussi disponibles pour Desktop Studio.

Icon of a smiling robot head

Intègre un agent virtuel en libre-service avec des Scripts voix à l'aide d'un flux continu audio provenant de la plateforme. Cette action permet à NiCE CXone d'utiliser l'audio en continu avec des SIPClosed 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.

Lorsque vous cliquez sur Ouvrir l’éditeur dans les propriétés de cette action, Virtual Agent Hub options. Les seules options de fournisseur que vous voyez sont celles qui prennent en charge la téléphonie personnalisée. Actuellement, le seul fournisseur pris en charge est Google Dialogflow CX VoiceStream. Vous pouvez ouvrir Virtual Agent Hub à partir de la plateforme NiCE CXone pour voir les autres fournisseurs disponibles dans votre système.

Dépendances

Cette action est réservée à l'utilisation avec l'agent virtuelClosed Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct. Google Dialogflow CX VoiceStream. 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 de façon unique cette action dans le script. La légende apparaît sur le canevas du script sous l’icône de l’action.

virtualAgentId

Le nom de l'agent virtuel sélectionné dans Virtual Agent Hub. Lorsque vous attribuez une application d'agent virtuel à une action Studio dans Virtual Agent Hub, cela remplit automatiquement cette propriété. 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 variables dans cette propriété.

Custom Payload to Bot

La variable qui contient la charge utile personnalisée à envoyer à l'agent virtuelClosed 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. Vous devez définir l'objet de charge utile personnalisée dans une action Snippet. L'objet doit être converti en JSON, soit dans l'Extrait, soit dans la propriété customPayload.

N'utilisez pas cette propriété si vous devez traiter les données que l'agent virtuel renvoie au script. Utilisez plutôt la variable customPayloadVarName (out).

Initial Intent

La première intentionClosed 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 virtuelClosed 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 conservent 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 retournée par l'agent virtuelClosed 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 empruntée, cette variable contient tous les détails associés à l'Erreur.

Conditions de branchement du 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 prise lorsque l'interaction est escaladée vers un agent humain.

On Failed to Initialize

La branche empruntée lorsque le profil nommé dans virtualAgentID présente des identifiants erronés ou que le mauvais profil d'agent virtuel est sélectionné.

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

Lorsque vous utilisez cette action avec Dialogflow CX VoiceStream, suivez ces pratiques exemplaires 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 une Snippet action de 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 l'action VoiceBOT STREAM action de votre script, configurez la propriété customPayload avec une variable qui a la fonction asJSON() dans sa valeur. Vous pouvez trouver cette variable dans l'objet customPayload.
  • Transmettez le customPayload JSON à l'agent virtuel à l'aide de la propriété Payload de QueryParameters. Consultez la documentation de Google sur QueryParameters A square with an arrow pointing from the center out from the top right corner. pour Google Dialogflow CX.
  • Les données transmises par QueryParameters sont reçues par un webhook dans Dialogflow CX. Vous pouvez écrire du code dans la console Dialogflow CX pour traiter les données transmises.
  • N'imbriquez pas 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 au script, utilisez le champ Charge utile personnalisée dans la console Dialogflow CX. Assurez-vous d'être dans la console de l'agent virtuel que vous utilisez avec NiCE CXone. Associez 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 à partir du 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 CX Dialogflow à 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 utilisés uniquement avec les agents virtuels Dialogflow CX. Pour obtenir un résultat similaire avec Dialogflow ES, utilisez des contextes.

  • Configurez les indices de contexte de la Parole et un ID de conversation personnalisé pour transférer la conversation à un agent virtuel Dialogflow CX 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 the maxPostEnergySilenceMSparamètre à l'action Next Prompt Behaviors ou Default Next Prompt BehaviorsSnippet.