Session
The session is the data that is stored for a particular user. A session can span multiple conversations.
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.
{
"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 |
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.
Last modified 11mo ago