Fragment État de session du robot

Ce snippet s’utilise avec les actions qui ont la propriété botSessionState, comme Textbot Exchange et Voicebot Exchange (ci-après, ces deux actions sont appelées « Exchange »). La propriété botSessionState doit être configurée correctement pour que vos agents virtuels Une application logicielle qui gère les interactions avec les clients à la place d'un agent humain en direct. fonctionnent comme prévu.

La propriété botSessionState doit être configurée avec la variable qui contient l'identifiant unique pour la conversation entre le contact et l'agent virtuel. Il est automatiquement attribué par le fournisseur de l'agent virtuel. L'identifiant empêche la création d'une nouvelle session à chaque tour de la conversation et aide l'agent virtuel à maintenir le contexte entre les tours.

Le fournisseur crée l'identifiant au début de la conversation et le transmet au script avec la première réponse. Le script stocke l'identifiant dans la variable nommée dans la propriété botSessionStateVarName (out) de l'action Échanger . Enfin, le script passe l'identifiant de la propriété botSessionStateVarName (out) du tour précédent à la propriété botSessionState.

Vos scripts ne doivent jamais écrire dans cette propriété ou dans sa variable. Votre script doit être configuré correctement pour utiliser l'identifiant de l'état de session du robot.

Configuration du script

Lorsque vous utilisez une action Exchange, un minimum de deux instances de l’action est nécessaire dans votre script. La propriété botSessionState dans chacune des actions Exchange doit être configurée différemment :

• La première instance de l’action Exchange située juste après l’action Begin au début du script. Configurez-le comme suit : 
  • botSessionState : ce champ doit être vide.
  • botSessionStateVarName (out) : configurez avec le nom de la variable dans laquelle vous voulez que le script enregistre l'identifiant.
• La deuxième action Exchange se trouve plus loin dans le script. Configurez-le comme suit : 
  • botSessionState : configurez avec la variable utilisée dans botSessionStateVarName (out) de la première instance de l'action Exchange. La variable doit contenir l'identifiant de l'état de session du robot au format JSON.
  • botSessionStateVarName (out) : configurez avec le nom de la variable dans laquelle vous voulez que le script enregistre l'identifiant.
• La troisième instance et toutes les instances suivantes de l'action Exchange sont facultatives. Si votre script inclut ces instances, configurez-les comme suit : 
  • botSessionState : configurez avec la variable utilisée dans botSessionStateVarName (out) de l’instance précédente de l'action Exchange. La variable doit contenir l'identifiant de l'état de session du robot au format JSON. L'identifiant de l'état de la session du bot ne change généralement pas d'un tour à l'autre. Cependant, s'il devait changer, l'action devrait être configurée pour capturer le changement.
  • botSessionStateVarName (out) : configurez avec le nom de la variable dans laquelle vous voulez que le script enregistre l'identifiant.

Cette configuration est requise pour tous les agents virtuels.

Conversion de l'identifiant de l'état de session du robot en JSON

Le contenu de la variable utilisée dans la propriété botSessionStateVarName (out) doit être converti en JSON et transmis dans la propriété botSessionState de la deuxième action Exchange de votre script. Pour ce faire, vous pouvez inclure du code dans une action Snippet ou configurer directement la propriété. Les deux approches sont acceptables. Toutefois, la création d’une variable dans Snippet pour contenir l'objet converti offre l’avantage qu'il est plus facile de voir où la conversion a lieu.

Utiliser une action Snippet

1. Configurez la propriété botSessionStateVarName (out) de l’action Exchange avec le nom de la variable devant contenir l’identifiant de l’état de session. Par exemple, botSessionState.

2. Ajoutez la ligne suivante à un Snippet situé avant l’action Exchange dans votre script :

   ASSIGN botSessionStateOut = botSessionStateOut.asJSON()

   Utilisez le nom de la variable que vous employez dans votre script.

3. Configurez la propriété botSessionState dans l’action Exchange avec le nom de la variable vous avez utilisée dans la déclaration ASSIGN. Par exemple, botSessionStateOut.

Convertir dans la propriété

Si vous convertissez la variable dans la propriété botSessionState, utilisez la variable botSessionStateVarName (out) avec la fonction asJSON(). Par exemple :

• botSessionStateVarName (out) : botSessionState
• botSessionState: botSessionState.asJSON()