Skip to Content
annotyDocs

Slack

Get each comment as a message in a Slack channel, and reply, resolve or send it to a coding agent from there.

Each comment becomes one message in the channel you pick. Replies and status changes go in that message's thread, so the channel stays quiet. Slack comes with Pro and Team. A message shows:

  • who wrote the comment, and a link to the page
  • the comment quoted
  • its status and pin number
  • its project and feedback session
  • buttons to act on it

Connect a channel

  1. In the dashboard, open the project → Integrations → Add → Slack channel.

  2. The first time, click Add to Slack and allow it on Slack's page. You come back to the project, ready to pick a channel.

  3. Type to find the channel, then pick its events. Every comment event is ticked to start with.

  4. Open the channel's ⋯ menu → Send test message to check it arrives.

Any public channel works without inviting Annoty. Slack keeps private channels from apps until someone invites them, so type /invite @Annoty in a private channel first, then click Refresh channels.

A channel gets every feedback session in the project unless you pick some when you add it. Turn notifications off on a feedback session to keep it out of project-wide channels.

Annoty can post in your workspace and list its channels. It can't read messages, in any channel.

Act from a message

  • Reply opens a form. The reviewer sees your reply on their page, with the Team badge. Typing in the Slack thread stays in Slack: the reviewer never sees it.
  • Resolve and Reopen change the comment everywhere, and the message shows who did it.
  • Send to starts one of the project's coding agents on the comment, with one button per agent, after you confirm. The thread says who sent it, with a link to the run when there is one.
  • Open in Annoty opens the feedback session in the dashboard, showing the comment's page.

The first time you click a button, Annoty asks you to link your Slack account to your Annoty account. Check that the page names your own Slack account before you confirm: whoever uses it can then reply, resolve and start agents as you, with your role. Unlink it under Account → Connected apps.

Only people in the workspace that connected Annoty can act from a message. That leaves out partners in a Slack Connect channel. Members with no Annoty account can read the messages but not use the buttons.

Unticking an event only removes its line from the thread. A status change always updates the message, so it never offers Resolve on a resolved comment.

Page links in a message open the page for review, so anyone in the channel can use them. Pick a channel the way you'd pick who to send the link to.

See what a channel is connected to

Type /annoty in a channel. Only you see the answer: the channel's projects, their active feedback sessions and how many comments are open, each linking to the dashboard.

When a message doesn't arrive

The channel shows Failing next to its name when Slack turned a message down, with the reason on hover. Annoty tries a failed message again for about a day. If the channel was archived or Annoty was removed from the workspace, it turns off and says what to do. Add to Slack again turns channels back on after a removal.

Manage workspaces

Settings → Integrations lists the Slack workspaces your organization connected, with how many channels each has and who connected it. Connect another one there with Add to Slack. To disconnect one, open its ⋯ menu → Disconnect: its channels stay listed on their projects, turned off, until you connect it again.

Deleting a comment in Annoty doesn't delete its Slack message.

On this page