# Slack (/integrations/slack)

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 [#connect-a-channel]

<Steps>

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.

</Steps>

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 [#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](/agents/send-to-agent/) 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 [#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 [#when-a-message-doesnt-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 [#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.
