Connecting Slack

Connect a Slack workspace to your HelpGuides project to post a message when articles are published, let your team search and ask questions without leaving Slack, and get a ping when an AI agent finishes a review comment.

Connect your workspace

  1. Open your project and click Settings, then the Integrations tab.
  2. Under Slack, click Add to Slack.
  3. In Slack, choose your workspace and allow access.
  4. You return to the Integrations tab, which now shows Connected and your workspace name.
Integrations tab with the Add to Slack button
Settings, Integrations tab
One project per workspace

Slash commands and mentions answer from the project the workspace is connected to, so connect each Slack workspace to one HelpGuides project.

Choose a notification channel

  1. In Slack, invite the HelpGuides app to the channel you want to use: /invite @HelpGuides
  2. Back in HelpGuides, pick the channel from Notification Channel. Channels the app hasn't joined yet are marked (invite bot first).
  3. Turn Notify on updates and Notify on Cowork updates on or off.
  4. Click Save Slack Settings.

Nothing is posted until you choose a channel.

What gets posted

MessageWhen it's postedSetting
Article publishedThe first time an article is published. It includes the title, author, a short description and the featured image.Always on once a channel is chosen
Article updatedA published article is saved again and its previous update was more than a day ago. Quick edits right after publishing don't each post a message.Notify on updates (off by default)
Review comment resolvedA review comment is marked resolved, by an AI agent or by someone clicking Resolve. It shows the comment and the resolution notes, so someone can check the draft before publishing.Notify on Cowork updates (on by default)

Dismissed review comments never post a message.

Search from Slack with /helpguides

Type /helpguides followed by what you're looking for. Slack shows Searching…, then posts the top 3 matching published articles in the channel. The slash command lists articles only; it doesn't write an answer.

/helpguides reset a password

Ask a question with @HelpGuides

Mention the app in a channel it has joined and ask your question. It replies in a thread with Thinking…, then replaces that with an answer written from your published articles and links to up to 3 sources. If your articles don't cover the question, it says so.

@HelpGuides how do I add a custom domain?

Answers work the same way as AI answers on your help site: only published articles are used.

Disconnect Slack

On the Integrations tab, click Disconnect and confirm. The project stops posting notifications and answering questions in Slack. You can reconnect at any time with Add to Slack.

Chat alerts

The Chat messenger uses this same Slack connection to alert your team about new and escalated conversations. See Chat Notifications and Teams.