How to reset sessions¶

This guide explains how to end a current chatbot session and start a new one.

When a session is reset:

• The current session is marked as completed.
• A new session is started with a fresh history.

Before you begin¶

• Confirm which channel your chatbot uses — this determines which reset options are available.
• Resets can be triggered manually or automatically.

Manual reset of a session¶

Participant reset manually from messaging channel¶

1. As a participant, view the conversation in the messaging channel.
2. Send /reset (case-insensitive) as a text command.
3. Continue chatting to start a fresh session.

This command is available on all channels except Web and Slack.

Participant reset manually from the web chat page¶

1. As a participant, view the OCS's web chat page.
2. Click the "End chat and give feedback" button.
3. Confirm that you want to end the chat.
4. Continue chatting to start a fresh session.

User reset manually from the OCS Admin UI¶

When viewing the session detail on the Chatbot Review page, an OCS user with permission to manage sessions has two options:

• End Session — ends the current session. This does not start a new one.
• New Session — ends the current session and starts a new one. This option is only available for non-Web channels.

Reset sessions automatically¶

For details on how to end sessions from a chatbot see Ending Sessions from a Chatbot

Reset automatically via API¶

Use this when your integration controls when conversations should restart.

• When using the Trigger Bot Message API, you can set "start_new_session": true, which will end the current session and start a new one before messaging the participant.

Related concepts¶

• Chat Sessions
• Session Status