Extrait de code État de la session du robot

L'extrait État de la session du robot est requis dans votre script lorsque vous utilisez des actions qui possèdent la propriété botSessionState. Cela comprend des actions telles que Textbot Exchange et Voicebot Exchange (à partir de maintenant, les deux actions sont désignées simplement par Exchange). La propriété botSessionState doit être configurée correctement pour que vos agents virtuels Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct. fonctionnent comme prévu. Pour ce faire, vous devez créer cet extrait dans votre script et configurer les actions correctement, comme indiqué dans les sections suivantes.

La propriété botSessionState doit être configurée avec la variable qui contient unique l'identifiant de 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 {12}nouvelle session{13} à chaque échange de la Conversation et aide l'agent virtuel à maintenir le contexte entre les échanges.

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 Exchange. Enfin, le script transmet l'identifiant de la propriété botSessionStateVarName (out) de l'échange précédent à la propriété botSessionState.

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

Configuration du script

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

• The first instance of the Exchange action is located right after the Begin action at the start of the script. Configure it as follows: 
  • botSessionState : Ce champ doit être vide.
  • botSessionStateVarName (out) : Configurez ce champ avec le nom de la variable dans laquelle vous voulez que le script stocke l'identifiant.
• The second Exchange action is located later in the script. Configure it as follows: 
  • botSessionState : Configurez ce champ 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 la session du robot au format JSON.
  • botSessionStateVarName (out) : Configurez ce champ avec le nom de la variable dans laquelle vous voulez que le script stocke l'identifiant.
• The third and any subsequent instances of the Exchange action are optional. If your script includes these instances, configure them as follows: 
  • botSessionState : Configurez ce champ 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 la session du robot au format JSON. L'identifiant de l'état de la session du robot ne change généralement pas d'un tour à l'autre. Toutefois, s'il devait changer, l'action doit être configurée pour capturer ce changement.
  • botSessionStateVarName (out) : Configurez ce champ avec le nom de la variable dans laquelle vous voulez que le script stocke l'identifiant.

Cette configuration est requise pour tous les agents virtuels.

Vérifier que la Propriété botSessionState est configurée correctement

Vous pouvez utiliser une trace de script pour confirmer que cette propriété est configurée correctement.

1. Exécutez une trace de script sur une interaction entre l'agent virtuel et un contact. Vous pouvez utiliser une trace ou Capturer une trace d'un ANI ou DNIS spécifique (uniquement pour les interactions vocales).
2. Dans la fenêtre de trace, cliquez sur la ligne qui correspond à la première action Virtual Agent Hub (Voicebot Exchange ou Textbot Exchange).
3. Dans la liste Variables, vérifiez la variable botSessionState. Sa valeur doit être null (vide).
4. Dans la fenêtre de trace, cliquez sur la ligne suivante dans la trace après la première action Virtual Agent Hub.
5. Remarque la valeur de la variable botSessionState.
6. Dans la fenêtre de trace, cliquez sur la ligne dans la trace qui correspond à toute action Virtual Agent Hub subséquente.
7. Vérifiez la valeur de la variable botSessionState. Elle doit être la même qu’à l’étape 5.

Convertir l’identificateur d’état de session de bot en JSON

Le contenu de la variable utilisée dans la propriété botSessionStateVarName (out) doit être converti en JSON et transmis à la propriété botSessionState de la deuxième action Exchange dans votre script. Pour ce faire, vous pouvez inclure du code dans une action Snippet ou configurer la propriété directement. Both approaches are acceptable. However, the benefit of creating a variable in a Snippet to hold the converted object is that it makes it easier to see where the conversion is happening.

Utiliser une action Extrait de code

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

2. Ajoutez la ligne suivante à un Extrait de code situé avant l’action Échange 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 (sortie) avec la fonction asJSON(). Par exemple :

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

Transférer des contacts d’un Agent virtuel à un autre

Pour configurer le transfert de contacts entre agents virtuels, vous devez configurer correctement les id d’état de session de bot. Chaque agent virtuel doit avoir son propre id d’état de session de bot unique. Cela aide chaque agent virtuel à conserver le contexte de la Conversation à laquelle il participe.

• Agent virtuel 1 : Configurez les variables d’état de session de bot tel que décrit précédemment sur cette page.

• Agent virtuel 2 : Configurez de la même manière, en utilisant une variable différente dans botSessionStateVarName (sortie) pour contenir l’id d’état de session de bot. Assurez-vous que, lors du premier appel à cet agent virtuel, la propriété botSessionState est vide. Le premier tour de la Conversation retourne un id d’état de session de bot unique à la variable dans botSessionStateVarName (sortie).
• Tous les agents virtuels suivants : configurez-les de la même façon que pour l’agent virtuel 2, en utilisant une variable unique pour l’id d’état de session du bot.