Skip to main content

Staff Notes

A staff note is context you record beside a chat without replying to the member. Use it for the handover detail, the phone call you just made, or the reason you are waiting — the things the next person needs and the member should never receive.

Notes are never delivered, are never used as input to the Agent, and are not part of the transcript the member or the Agent sees.

Who can write and read notes​

Reading and writing notes requires the chats:admin scope and access to the chat. A private chat's notes stay visible to that chat's participants only. Members without chats:admin never see a note control, and their API calls for notes are refused.

Writing a note​

  1. Open the chat. (The switch is not available on a Manager chat.)
  2. Above the message box, switch Reply to Note.
  3. Type the note and send it.

The note appears in the transcript with a tinted "Staff note · Not sent" treatment, so nobody mistakes it for something the member received. Switching back to Reply returns you to normal messaging.

You can write a note while the AI is still handling the chat — notes do not interrupt it.

Notes are append-only​

There is no edit or delete for a note, and the API refuses PUT, PATCH and DELETE. If you need to correct one, write a new note.

If the staff member who wrote a note is later erased from the workspace, the note stays on the chat and its author shows as a former member.

Notes in exports​

A default chat export never contains notes. Members with chats:admin can include them through the API's includeStaffNotes=true mode; see Exporting Chats.