{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/en/JS_API/session_lifetime_control/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"1fdf4733-f8c7-516c-91ec-891bd463b5fc","excerpt":"Session lifetime control?> Session — a sequence of client and bot interactions within a single conversation context. A session begins with the first client…","html":"

Session lifetime control

\n
\n

Session — a sequence of client and bot interactions within a single conversation context.

\n

A session begins with the first client request if there is no other active session for this client.

\n

Reasons for a session termination:

\n\n

The requirements for a session termination are unique for every bot. Requirement configuration is made at the script level. The script is supposed to determine the moment of the old session ending and the moment of the beginning of a new one. It is possible thanks to the $reaction.newSession.

\n

The newSession reaction throws a specific exception. When such an exception is caught the log is written and a new session is created.

\n
\n

Methods of session control

\n

You can use the methods below to control the session:

\n\n
\n

How to use

\n\n
theme: /\n    init:\n        bind(\"postProcess\", function($context) {\n            $context.session.lastActiveTime = $jsapi.currentTime();\n            log($context.session.lastActiveTime)\n        });\n \n        bind(\"preProcess\", function($context) {\n            if ($context.session.lastActiveTime) {\n                var interval = $jsapi.currentTime() - $context.session.lastActiveTime;\n                if (interval > 10000) {\n                    $reactions.newSession( {message: 'test 6', session: $context.request.data } );\n                }\n            }\n        });
\n
\n\n
    state: sessionStart\n        event!: newChatStarted\n        script:\n            $request.query = $request.rawRequest.messages[0].text;\n            $request.event = null;\n            $reactions.newSession({request: $request});
\n

The script switched to a state triggered by the newChatStarted event. We need to create a new session but we also must handle the client’s message that accompanied the event.

\n

We override $request.event = null in order to avoid switching to the state once again. We also write the client’s message to $request.query. Then we create a new session ($reactions.newSession) with the client’s message already stored.

\n
\n\n
state: reset\n    event!: someEvent  \n    script:\n        $reactions.newSession({message: \"some text\", data: $request.data});
\n

Here, the script switched to a state triggered by the newChatStarted event that will be saved to $request.event. We create a new session, replacing the text. However, we keep the original event. Events are primary triggers for the platform, so we will get into an endless loop in this script.

\n

To avoid this, override the $request.event = null event.

","frontmatter":{"title":"","description":null},"headings":[{"value":"Session lifetime control"}]}},"pageContext":{"slug":"/docs/en/JS_API/session_lifetime_control/","previous":{"fields":{"slug":"/docs/en/NLU_core/advanced_classifer_settings/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/en/JS_API/preload_js/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}