VOICEBOT STREAM

Cette page d'aide concerne Studio. Ces informations sont également disponibles pour Desktop Studio.

Icon of a smiling robot head

Demande que NiCE CXone lance une connexion SIPClosed Protocol used for signaling and controlling multimedia communication sessions such as voice and video calls. avec le service de proxy audio destination. [description d'origine]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 les connexions SIPClosed Protocol used for signaling and controlling multimedia communication sessions such as voice and video calls..

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 uniquement destinée à être utilisée avec l'Google Dialogflow CX VoiceStream agent virtuelClosed A software application that handles customer interactions in place of a live human agent.. Utilisez cette action à la place de l'action VOICEBOT EXCHANGE pour les intégrations avec Dialogflow CX VoiceStream.

Types de script pris en charge

Icon of purple telephone handset

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é.

Custom Payload to Bot

La variable qui contient la charge utile personnalisée à envoyer à l'agent virtuelClosed A software application that handles customer interactions in place of a live human agent..

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 Extrait.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 intentionClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. que l'action envoie à l'agent virtuelClosed A software application that handles customer interactions in place of a live human agent..

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 virtuelClosed A software application that handles customer interactions in place of a live human agent..

ErrorDetailsVarName (out)

Lorsque la branche Error est empruntée, cette variable contient tous 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 possède des identifiants incorrects ou que le profil d'agent virtuel sélectionné est erroné.

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

Lors de l'utilisation de cette action avec Dialogflow CX VoiceStream, suivez 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 Snippet 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()}"	
  • In the VoiceBOT STREAM action in your script, configure the customPayload property with variable that has the asJSON() function in its value. You can find this variable in the customPayload object.
  • Transmettez la JSON customPayload à l'agent virtuel à l'aide de la propriété Payload de QueryParameters. Consultez la documentation 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 Dialogflow Console CX pour gérer les données transmises.
  • Ne 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 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-le à 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 au sein d'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.

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

  • Pour configurer la durée d'attente de l'agent virtuel lorsque le contact fait une pause pendant qu'il parle, ajoutez paramètre maxPostEnergySilenceMS à l'action Next Prompt Behaviorsou Default Next Prompt Behaviors Extrait.