Extrait de code de charge utile personnalisée

L'extrait de codeCustom Payload est requis dans votre script lorsque vous utilisez des actions qui ont la propriété customPayload, comme Voicebot Exchange ou Textbot Conversation. Il est utilisé pour transmettre des données de NiCE CXone à votre fournisseur d’agent virtuel Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct.. Si vous devez recevoir des données personnalisées de votre agent virtuel, utilisez la variable customPayloadVarName (out). Utilisez les informations de cette page pour créer l'extrait de code Charge utile personnalisée qui répond aux exigences de l'implémentation de l'agent virtuel de votre organisation.

Cet extrait de code est nécessaire pour les agents virtuels suivants :

• Amazon Lex V1 et Amazon Lex V2 : L’extrait de code Charge utile personnalisée est requis pour Lex V1 et Lex V2, même si vous n’avez pas besoin de transmettre des données à l’agent virtuel. L’agent virtuel utilise les données transmises par la propriété customPayload pour remplir la propriété SessionAttributes du côté Amazon.
• Google Dialogflow ES : La charge utile personnalisée transmet des informations contextuelles que l’agent virtuel Dialogflow ES utilise pour déterminer l’intention La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir.. Suivre les bonnes pratiques recommandées pour intégrer des données de charge utile personnalisées avec Google Dialogflow ES.

Pour tous les autres agents virtuels, vous ne devez inclure l’extrait que si vous avez des données personnalisées à transmettre au bot. Si vous utilisez Dialogflow CX, suivez les meilleures pratiques pour inclure une charge utile personnalisée. Si vous n'incluez pas d'extrait de charge utile personnalisé, assurez-vous de transmettre un paramètre d'espace réservé.

Transmettre un espace réservé

Si vous utilisez un agent virtuel qui n'a pas besoin de recevoir d'informations, comme Amazon Lex V2 ou Amazon Lex V1, suivez cet exemple :

DYNAMIC customPayload 
 customPayload.placeholder=""

Transmettre des données

Pour tous les fournisseurs d'agents virtuels qui doivent transmettre des informations à l'agent virtuel, suivez cet exemple. Remplacez les paramètres de l’exemple par les informations que vous devez transmettre.

DYNAMIC customPayload
ASSIGN customPayload.context.id="information"
ASSIGN customPayload.context.lifespan=1
ASSIGN customPayload.context.parameters.name="Fenrir"
ASSIGN customPayload.context.parameters.age="19"
ASSIGN customPayload.context.parameters.date="20201020"			

Google Dialogflow CX Charge utile personnalisée

• Vous pouvez transmettre des données personnalisées à Dialogflow CX à l'aide de paires clé-valeur JSON. Dans une Snippet 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()}"	

• Transmettez le customPayload JSON à l'agent virtuel à l'aide de la propriété Payload de QueryParameters. Consultez la documentation de Google sur QueryParameters 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 à 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 .

Conseils contextuels pourDialogflow CX

Les conseils de contexte de parole peuvent être transmis dans l'extrait de code Charge utile personnalisée dans le paramètre speechContexts. La valeur de speechContexts.phrases doit être un jeton de classe Google pour l’indice que vous voulez donner. Le jeton doit correspondre à la langue et aux paramètres régionaux de vos contacts. Par exemple :

DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		

Configurez ces paramètres comme suit :

• speechContexts.phrases : Le jeton de classe Google pour l’indice que vous voulez donner. Le jeton doit correspondre à la langue et aux paramètres régionaux de vos contacts. Si vous souhaitez ajouter plusieurs jetons, ajoutez un paramètre speechContexts.phrases pour chaque jeton.
• speechContexts.boost : Une valeur numérique pondérée entre 1-20 et la valeur phrase spécifiée. Le service de transcription utilise cette valeur lorsqu’il sélectionne une transcription possible pour les mots dans les données audio. Plus la valeur est élevée, plus la probabilité que le service de transcription choisisse ce mot ou cette phrase parmi les alternatives est grande.

Vous pouvez voir le contenu de ce paramètre dans Studio et les journaux d'application.

Transférer des contacts entre Dialogflow agents virtuels CX

Pour configurer le transfert d'un contact d'un Dialogflow agent virtuel CX vers un autre Dialogflow agent virtuel CX, incluez la ligne suivante dans l'extrait de code Charge utile personnalisée. Remplacez custom_value par le nom de la variable qui contient l'ID de conversation :

{
  “cxone_override_conversation“: {custom_value} 
}		

Assurez-vous de configurer votre script pour remplir la variable que vous utilisez avec ce paramètre.

Votre script doit être configuré avec soin afin que

Le paramètre cxone_override_conversation est semblable à l'ID d'état de session du bot défini dans l'extrait État de session du bot snippet. Les deux aident l'agent virtuel à maintenir le contexte de la conversation entre les tours. Votre script doit être configuré avec soin afin que les valeurs d'ID d'état de session du bot et d'ID de conversation apparaissent aux emplacements corrects. L'état de la session du bot a toujours priorité sur le paramètre cxone_override_conversation. Configurez votre script comme suit :

Agent virtuel	Tourner #	Configuration
1.	1.	La propriété botSessionState de l’action Voicebot EXCHANGEou Textbot EXCHANGE est vide. Le tour retourne un ID d'état de session de bot et remplit botSessionStateVarName (out). Il s'agit de l'ID d'état de session du bot n°1.
1.	2 tours ou plus avec cet agent virtuel	Le script envoie l'ID d'état de session du bot n° 1 à l'agent virtuel CX n° 1 Dialogflow. Le même ID est retourné au script.
2.	3 (premier avec cet agent virtuel)	La propriété botSessionState de l’action Voicebot EXCHANGEou Textbot EXCHANGE est vide. L'extrait de charge utile personnalisé pour ce tour contient cxone_override_conversation = [variable]. Le tour retourne un ID d'état de session de bot unique et remplit botSessionStateVarName (out), remplaçant toute valeur qu'il contient déjà. Il s'agit de l'ID d'état de session du bot n°2.
2.	4 (deuxième tour avec cet agent virtuel)	Le script envoie l'ID d'état de session du bot n° 2 à l'agent virtuel CX n° 2 Dialogflow. Le même ID est retourné au script.

Si vous utilisez plus de deux instances de Dialogflow CX, le modèle continue comme établi dans le tableau précédent.

Google Dialogflow ES Charge utile personnalisée

• CustomPayload est utilisé pour transmettre le contexte d'une intention La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir.. Le Contexte aide l'agent virtuel à comprendre l'intention de l'utilisateur. Les Contextes ne sont pas obligatoires, mais ils aident l'agent virtuel à faire correspondre un énoncé Ce qu’un contact dit ou tape. à une intention.
• Dans une action Snippet de votre script, créez un objet customPayload qui respecte le format décrit dans la documentation Google Dialogflow ES pour REST Resource :  projects.agent.sessions.context. L'aide en ligne de Studio fournit des informations supplémentaires sur les objets de données dynamiques.
• Vous pouvez également transmettre des données personnalisées avec customPayload sans contextes. Pour ce faire, incluez des paires clé-valeur JSON standard dans un objet de données dynamiques.
• Les contextes de parole sont transmis dans la charge utile personnalisée dans le paramètre speech_contact. Vous pouvez voir le contenu de ce paramètre dans les traces Studio et les journaux d'application.
• L’objet dynamique customPayload est transmis en tant que paramètre d’agent virtuel au format JSON, comme le montre l’exemple de script.

• Configurez les indices de contexte de Parole dans l'extrait Custom Payload .

Conseils contextuels pour le discours DialogflowES

Conseils de contexte de parole peuvent être transmis dans l'extrait de code Charge utile personnalisée dans le paramètre speechContexts. La valeur de speechContexts.phrases doit être un jeton de classe Google pour l’indice que vous voulez donner. Le jeton doit correspondre à la langue et aux paramètres régionaux de vos contacts. Par exemple :

DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		

Configurez ces paramètres comme suit :

• speechContexts.phrases : Le jeton de classe Google pour l’indice que vous voulez donner. Le jeton doit correspondre à la langue et aux paramètres régionaux de vos contacts. Si vous souhaitez ajouter plusieurs jetons, ajoutez un paramètre speechContexts.phrases pour chaque jeton.
• speechContexts.boost : Une valeur numérique pondérée entre 1-20 et la valeur phrase spécifiée. Le service de transcription utilise cette valeur lorsqu’il sélectionne une transcription possible pour les mots dans les données audio. Plus la valeur est élevée, plus la probabilité que le service de transcription choisisse ce mot ou cette phrase parmi les alternatives est grande.

Vous pouvez voir le contenu de ce paramètre dans Studio traces et les journaux d'application.