Extrait de code État de la session du bot

Cet extrait de code est à utiliser avec les actions qui ont la propriété botSessionState, comme Textbot Exchange et Voicebot Exchange (à partir de maintenant, ces deux actions sont appelées simplement Exchange). La propriété doit être configurée correctement pour que les botSessionStateagents virtuels Une application logicielle qui traite les interactions avec les clients à la place d’un agent en chair et en os. fonctionnent comme prévu.

Le fournisseur d’agents virtuels attribue un identifiant unique à chaque conversation entre un contact et un agent virtuel. L’identifiant permet d’éviter la création d’une nouvelle session à chaque tour de conversation. 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 Échange. Il transmet ensuite l’identifiant à la propriété botSessionState.

Votre script doit être correctement configuré pour utiliser l’identifiant d’état de la session du bot. 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 les actions Exchange doit être configurée différemment :

• La première action Exchange est située juste après l’action Begin au début du script. Dans ce cas d’action, la propriété botSessionState doit être laissée vide. La propriété botSessionStateVarName (out) doit être configurée avec le nom de la variable dans laquelle vous souhaitez que le script stocke l’identifiant.
• La deuxième action Exchange se trouve plus loin dans le script. Dans cette action, la propriété botSessionState doit être configurée avec la variable utilisée dans botSessionState. La variable doit contenir l’identifiant d’état de la session du bot au format JSON. La propriété botSessionStateVarName (out) doit être configurée avec le nom de la variable dans laquelle vous souhaitez que le script stocke l’identifiant. Si votre script comporte trois actions Exchange ou plus, toutes les actions, à l’exception de la première, doivent être configurées de cette manière.

Cette configuration est requise pour tous les agents virtuels.

Convertir l’identifiant d’état de la session du bot 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 la propriété directement. Les deux approches sont acceptables. Cependant, l’avantage de créer une variable dans Snippet pour contenir l’objet converti est 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 la session. Par exemple, botSessionState.

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

   ASSIGN botSessionStateOut = botSessionStateOut.asJSON()

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

3. Configurez la propriété botSessionState dans l’action Exchange avec le nom de la variable que vous avez utilisée dans l’instruction 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()