Session

The session is the data that is stored for a particular user. A session can span multiple conversations.

You can configure how long this data is kept in the data retention settings.

Default session data

The following data is available for all sessions. An easy way to preview this data is through the debugger in the 'test your bot' window.

Read-only session data

{
   "botId":"1457",
   "sessionId":"emulator-f28feb19-9d00-426a-ac65-539d5e1d3a73",
   "version":"DRAFT",
   "channel":"web",
   "user":{
      "firstName":"Guest"
   },
   "preferredLanguage":"en",
   "locale":"en-us",
   "nlp":{
      "expression":"hi",
      "intent":{
         "name":"Greeting",
         "score":1
      },
      "entities":[
         0
      ],
      "intents":[
         {
            "name":"Greeting",
            "score":1
         }
      ],
      "sentiment":{
         "name":"positive",
         "score":0.5183199216644359
   }
   "currentDialogstate":{
      "name":"introduction",
      "id":"25b838ca-0fea-4b97-b91e-31bd8d932cf9",
      "type":"MESSAGE"
   }
   "previousDialogstate":{
      "name":"introduction",
      "id":"25b838ca-0fea-4b97-b91e-31bd8d932cf9",
      "type":"MESSAGE"
   }
}

Property	Value	Description
botId	string	ID of the bot
sessionID	string	ID of the session
version	string	version of the session
channel	string	channel of the session
user	object	object containing information about the user
preferredLanguage	string	preferred language of the user
locale	string	preferred locale of the user (for example for date formatting)
nlp	object	object containing data about the latest expression, and which intent and entities were detected, with which confidence
nlp.sentiment	object	shows the sentiment analysis score of an expression
currentDialogstate	object	show the name, id and type of the current bot dialog the user is in
previousDialogstate	object	show the name, id and type of the previous bot dialog the user was in

User-changeable session data

The builder of the bot can create and save variables to the user session. This data can be created by the bot through a conversation, or retrieved through an API call. Objects, as well as strings and other types of values can be saved to the user session.