Extrait de l'état de la session du bot

L'extrait Bot Session State est requis dans votre script lorsque vous utilisez des actions qui ont la propriété botSessionState. Cela comprend des actions telles que Textbot Exchange et Voicebot Exchange (ci-après, les deux actions sont simplement appelées 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.

The botSessionState property must be configured with the variable that holds the unique identifier for the conversation between the contact and the virtual agent. It is automatically assigned by the virtual agent provider. The identifier prevents a new session from being created with every turn in the conversation and helps the virtual agent maintain context between turns.

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 ExchangeLe 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 cette Action. Enfin, le script transmet 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 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 nécessaire 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 : cette valeur doit être vide.
  • SessionStateVarName (out) : Configurez avec le nom de la Variable où vous souhaitez que le script stocke l'identifiant.
• The second Exchange action is located later in the script. Configure it as follows: 
  • botSessionState : Configurez avec la variable utilisée dans botSessionStateVarName (out) dans la première instance de l'action Exchange. La variable doit contenir l'identifiant d'état de session de bot au format JSON.
  • botSessionStateVarName (out) : configurez avec le nom de la variable dans laquelle vous souhaitez 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 avec la variable utilisée dans botSessionStateVarName (out) dans l'instance précédente de l'action Exchange. La variable doit contenir l'identifiant d'état de session de bot 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 souhaitez 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 un script trace 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 voix).
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, cochez la variable botSessionState. Sa valeur doit être nulle (vide).
4. Dans la fenêtre de trace, cliquez sur la ligne suivante après la première action Virtual Agent Hub.
5. Notez la valeur de la variable botSessionState.
6. Dans la fenêtre de trace, cliquez sur la ligne de la trace qui correspond à toute action Virtual Agent Hub suivante.
7. Vérifiez la valeur de la variable botSessionState. Elle doit être identique à celle de l'étape 5.

Convertir l'identifiant 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 de votre script. Pour ce faire, vous pouvez inclure du code dans une action Snippet ou configurer directement la propriété. 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

1. Configurez la propriété botSessionStateVarName (out) de l'action Exchange avec le nom de la variable qui contiendra l'identifiant d'é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 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 asJSON()fonction. Par exemple :

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

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

Pour configurer le transférer des contacts entre les agents virtuels, vous devez définir correctement les ID d'état de session de bot. Chaque agent virtuel doit disposer de son propre ID d'état de session de bot unique. Cela permet à chaque agent virtuel de conserver le contexte de la conversation à laquelle il participe.

• Agent virtuel 1 : configurez les variables d'état de session du bot comme décrit précédemment sur cette page.

• Agent virtuel 2 : Configuré de la même manière, en utilisant une variable différente dans botSessionStateVarName (sortant) pour conserver l'ID d'état de session du bot. Assurez-vous qu'au premier appel vers cet agent virtuel, la propriété botSessionState soit vide. Le premier tour de la conversation renvoie un ID d'état de session du bot unique à la variable dans botSessionStateVarName (sortant).
• Tous les agents virtuels suivants : Configurez-les de la même manière que l'agent virtuel 2, en utilisant une Variable unique pour l'ID d'état de session du bot.