# Chat history and resumption **Chat History** is a core feature available in all AIsuru widgets that lets users access, manage, and resume all their past conversations with your Agent. This turns interactions from isolated exchanges into a continuous, persistent conversational experience. ### How to access chat history In any AIsuru widget, users can easily access their personal history: 1. **Find the chat icon** in the widget toolbar; 2. **Click the icon** to open the dedicated history page; 3. **Immediately see** all their past conversations with the Agent. 💡 **Important note**: Chat history is always available, even in the Agent's "Try" mode, with no additional configuration needed from the Agent creator. ### Chat history interface #### Header and main controls The history page has a clean and functional interface: * **Chat history**: the main section title to orient the user; * **Download chat**: a button to download the currently viewed conversation as a .txt file; * **Filters:** * **Time filter:** to organize and search by conversation date: "All", "Today", "Yesterday", "Last 7 days", and "Last 30 days"; * **Minimum messages filter:** to filter chats by minimum message count: "Any", "2", "3", "5", "10", "15", "20", and custom. #### Viewing conversations Each conversation in the list is presented clearly and informatively: **Smart automatic title** * **Automatic generation**: the title is created automatically from the user's first message; * **Smart truncation**: if the message is too long, it's cut with "..." to keep it readable; * **Instant recognition**: helps users quickly identify their conversations. **Precise timestamp** * **Full date and time**: each conversation shows when it started (e.g. "Jan 21, 2025, 3:34 PM"); * **Message and media count:** shows the number of messages and media exchanged; * **Chronological ordering**: conversations are sorted from most recent to oldest; * **Temporal reference**: helps users put their interactions in context. ### Resuming conversations #### Full view Clicking on any conversation in the list: * **Detailed view**: opens the full conversation with all messages exchanged; * **Preserved context**: all session data is kept; * **Familiar interface**: the conversation appears in the same format as the original widget. #### Continuation functionality The true power of chat history lies in the ability to resume: * **"RESUME" button**: prominent and easy to access; * **Seamless continuity**: clicking "RESUME" takes the user back to exactly where they left off; * **Context retention**: the Agent remembers everything from the previous conversation; * **Environment restoration**: the chat resumes in the original widget/layout with all configurations. ### Strategic benefits #### For end users * **No more frustration**: important information is never lost; * **Continuity of experience**: conversations that develop over time; * **Historical reference**: ability to review past advice and information received; * **Temporal flexibility**: freedom to pause and resume whenever convenient. #### For Agent creators * **Increased engagement**: users are more likely to return; * **Deeper conversations**: ability to build lasting relationships; * **Reduced repetition**: the Agent doesn't have to start from scratch; * **Better understanding of users**: interaction history for optimization. ### Technical aspects and privacy #### Data management * **User isolation**: each user only sees their own conversations; * **Guaranteed persistence**: conversations remain available even after closing the browser; * **Secure identification**: account-based association system; * **Automatic management**: no action required from the Agent creator. #### Integration with sessionID Chat history is closely tied to AIsuru's session management system: * **Unique sessionIDs**: each conversation has a unique identifier; * **Technical restoration**: when resuming a chat, the original sessionID is restored; * **API compatibility**: works seamlessly with advanced integrations. ### Best Practices #### To maximize effectiveness 1. **End with openings**: close conversations with questions or suggestions for the future; 2. **Temporal references**: configure the Agent to reference past conversations when appropriate; 3. **Logical progression**: structure content to create conversational paths that develop over time; 4. **Ongoing testing**: regularly test the resumption experience to make sure it works smoothly. #### UX considerations * **Onboarding**: explain to users how to access their history during early interactions; * **Reminders**: periodically remind users that this feature is available; * **Feedback**: collect user feedback on the usefulness of the history to optimize the experience. Chat history and resumption represent a qualitative leap in the user experience with AIsuru Agents, turning sporadic interactions into lasting and productive relationships. Make the most of it to create conversational experiences that grow and improve over time! 🚀 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aisuru.com/en/sharing/advanced/chat-history-and-resumption.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.