Summary
A "Session" is a place to collaborate in Planhat OS, just with Planhat AI, or with colleagues
Before you write your first message, you pick a mode: "Ask Planhat", "Group session", "On record" or "Secret session". The mode sets two things at once: who can see the Session, and whether Planhat AI replies to everything or only when @-mentioned
Your Sessions sit in the sidebar, most recently active first, where you can rename, favorite, close, leave or delete them
Who is this article for?
Planhat Users using Planhat OS
Anyone else who would like to learn about Sessions
Article contents
What is a Session?
A "Session" is where collaboration takes place within Planhat OS - a series of messages between you, your colleagues and/or Planhat AI. You can use Sessions to brainstorm ideas with Planhat, coordinate across colleagues, or automate processes.
Modes
Each Session is one of 4 modes:
Mode | Who can see it; further details | Example use cases |
Ask Planhat |
|
|
Group session |
|
|
On record |
|
|
Secret session |
|
|
Each mode shows a one-line description in the picker, so you can see what you're choosing before you select one. (The mode can also be changed later.)
How to start a Session
Select "New Session" in the OS sidebar. You'll see a chat box with the mode picker
Click on the mode picker and choose one of the four modes
Each one shows a one-line description
"Group session" and "Secret session" ask you to select people (Users, also sometimes called Team Members); the placeholder reads "Add people to start a session"
"On record" asks you for a record; the placeholder reads "Pick a record to start a session"
"Ask Planhat" is the default - this is just you and Planhat AI
Write your first message and send it. The Session is created at that point. Planhat will automatically give the Session a human-readable name (although you can also customize the name). The icon shows you the mode
Click the image to view it enlarged
🚀 Tips
If you start a Session from a record - for example from the Company - the mode and the record is already filled in for you
Use "Ask Planhat" as your thinking space. Planhat AI replies to everything in this case, so you don't need to @-mention it, and nothing you try out here is visible to anyone else
Start a new Session per question, not per day. One Session per topic, clearly titled, is far easier to come back to than one long Session covering e.g. six topics
How to change a Session mode/participants
The mode is a starting point, not a permanent setting. At the top of an open Session you can:
Change the mode
Change who the participants are
Change which record it's connected to. Changing this asks you to confirm, because participants who don't have access to the new record will lose access to the Session
Changing the mode
The screenshots below show examples of clicking on the name of the Session in the top left of the Session to open a menu where you can change the mode, either by linking to a record, or by selecting "Convert to Secret Session" or "Convert to Group Session".
Note that if your Session is an "Ask Planhat" / "only me and Planhat" Session, the conversion options are nested under "Share...".
Changing participants
The next couple of screenshots show how you can click on the User icon(s) in the top right of a Session to add/remove participants.
Note that if your Session is an "Ask Planhat" / "only me and Planhat" Session, you will need to share/convert the Session before you see the option to add participants.
Where you can find Sessions
Once a Session exists, you'll find it in at least two (in some cases, three) places:
In the bottom left of Planhat OS, in the sidebar
The default is that it's shown as "Recent" (like in the example screenshot below), with the most recently active Session at the top
You can also change the sorting/grouping here, so there would be different wording in the sidebar in that case - we discuss this more below
The "Recents" screen
Mouse over "Recents" (or equivalent) and click on "Show all" to open it
Sessions linked to a record (e.g. a particular Company) also appear on that record, in its "Feed" widget (planned to be renamed to "Sessions")
Managing Sessions in the sidebar
Right-click a Session in the sidebar - or select its "..." menu (by mousing over a Session name and clicking on the ellipsis that appears) - for these actions:
"Add to Favorites" / "Remove from Favorites" - this pins (bookmarks) the Session in the "Favorites" section of your sidebar
See our separate article on Favorites
"Rename" - edits the Session title in place
To save, press enter (return), or click away from the box
"Copy link" - copies a direct link to the Session
"Mark as unread" - flags the Session so it shows as unread, without moving it
Useful for something you've read but haven't dealt with
Sessions are marked read automatically once you've opened them
"Close" - removes the Session from your sidebar
Nothing is deleted, and nobody else is affected
See Tip box below
"Leave chat"- removes you from the participants list, and tells the other participants that you've left
It asks you to confirm first
This option is only available for some Sessions. You can't leave a Session that's just between you and Planhat AI. The option also doesn't appear for other Session modes if you're the person who created the Session. If you created it, your only exit is "Delete".
See Tip box below
"Delete" - deletes the Session for everyone
It asks you to confirm, and it can't be undone
The "Delete" option is only available if you created the Session, or if you're a chat admin
See Tip box below
🚀 Tip
"Close" only affects your own sidebar. The Session itself is untouched, the other people in it see no change, and it returns to your sidebar as soon as anyone @-mentions you in it or you write in it yourself. Use "Close" freely for tidying up
Use "Leave chat" when you want out of a Session that's still running
Use "Delete" only when the whole Session should stop existing
Group by
The sidebar's "Group by" button gives you three ways to organize the Sessions list. To access these options, mouse over "Recent" (or equivalent) in the sidebar, and click on the slider icon.
"None" - one list under "Recent", most recent first
"Date" - buckets by "Today", "Yesterday", "This week", "This month" and "Older"
"Type" - splits into "Group chats" and "Personal chats"
Frequently asked questions (FAQs)
Q: What's the difference between closing, leaving and deleting a Session?
A: Closing removes the Session from your own sidebar and changes nothing for anyone else. Leaving removes you from the participants list and tells the others you've left. Deleting removes the Session for everyone, and can't be undone
Q: I closed a Session by mistake. How do I get it back?
A: It comes back to your sidebar the next time someone @-mentions you in it, or you write in it yourself
Q: Why doesn't Planhat AI reply to my message?
A: In "Group session", "On record" and "Secret session" modes, Planhat only replies when it's @-mentioned - type
@and choose "Planhat". In "Ask Planhat" mode, Planhat replies to every message
Q: Can other people read my Sessions?
A: It depends on the mode. "Ask Planhat" and "Secret session" Sessions are private to the people in them. "Group session" and "On record" Sessions are discoverable, which means colleagues and Agents in your organization can find and read them
Q: Why can't I leave a specific Session?
A: You created it. The creator can't leave their own Session - use "Delete" if it should stop existing for everyone


















