All docs

Notes, mentions and following

Pull a teammate in with an @mention in a private note, follow conversations you care about, and see who did what in the thread.

Updated . 3 min read.

Desk keeps your team in step without anyone chasing anyone: private notes can pull a teammate in, followers hear about what happens next, and the thread itself records what each person did.

Mention a teammate

In the Internal note tab, type @ and a picker lists your teammates. Keep typing to narrow it, use the arrow keys and press Enter (or click) to insert the full name. When you add the note, the person you named gets an email and a phone notification with a link to the conversation, and the name is highlighted in the note.

  • Only teammates who can open the conversation can be mentioned. In a workspace with restricted projects, that means people with access to the conversation's project.
  • Writing the name yourself works too: @Ben Builder, a first name that is unique in your team (@ben), or an email address.
  • You are never notified about your own mention.
  • Mentions only work in private notes. Nothing in a customer reply is treated as a mention, and the customer never sees notes.

Whoever you mention starts following the conversation automatically.

Follow a conversation

Click Follow above the thread to be told when something happens, even if the conversation is not assigned to you. Click Following to stop. The Details section in the right column lists everyone who follows.

Followers hear about:

  • a teammate's reply or private note,
  • the customer writing back,
  • a teammate resolving or reopening the conversation.

You are never notified about something you did yourself, and you do not get a second message for a note that already mentioned you.

Some people follow without clicking:

Who Why
The assignee The conversation is theirs. They hear about teammates' notes and replies, and when it is resolved or reopened.
Anyone who replies or adds a note They are taking part. They also hear when the customer writes back.
Anyone mentioned in a note They were pulled in.

People who leave the workspace, or lose access to the conversation's project, stop receiving these messages.

You choose which of these reach you, and by email or push, under Desk settings → Notifications (see Desk notifications). The notification choices in the mobile app still apply on top: turning off the conversation-assigned alert there also quiets follower updates, and the mention alert is shared with response mentions.

See what happened

Every change an agent makes leaves a quiet line in the thread: assigning or unassigning, resolving, reopening, snoozing, spam, a new priority, an added or removed label. The line names who did it and when. Lines also appear when a reply deadline is missed and when a snooze ends.

These lines are for your team only. They never reach the customer, and they do not count as a reply or interrupt a reply you are writing.

From the API and MCP

  • Post a note with mentions (a list of teammate ids) - or just write @Name in the text - using POST /desk/threads/{thread}/messages with "mode": "note", or the MCP tool reply_desk_thread with internal: true.
  • Follow with POST /desk/threads/{thread}/followers, stop with DELETE /desk/threads/{thread}/followers, list with GET /desk/threads/{thread}/followers; the MCP tools are follow_desk_thread and unfollow_desk_thread.

Next