Skip to main content
Integrations
3 min read

Installing the Slack app

OAuth flow, scopes, channel picker, and troubleshooting.

Last updated May 12, 2026

What the Slack app does

Once installed, the AI Domination Slack app:

  • Posts a daily digest of audits and pending approvals to a channel of your choice.
  • Pings reviewers when a draft is assigned to them.
  • Alerts on negative-sentiment mentions and prompt-rank drops.
  • Lets you approve / reject drafts inline from Slack via interactive buttons.

Installing

  1. Open Settings → Integrations → Slack → Install app.
  2. You're redirected to Slack's OAuth consent screen.
  3. Pick the workspace you want to connect.
  4. Review the scopes (full list below).
  5. Click Allow.
  6. You're returned to AI Domination. The integration is live.

Scopes we request

Scope What it lets us do
channels:read Show you a list of channels in the picker.
chat:write Post messages in channels we're invited to.
chat:write.public Post in channels without joining (where allowed by workspace policy).
users:read Match Slack users to AI Domination team members for assignment notifications.
commands Register slash commands.
im:write Send DMs (for personal notifications).

We do not request channels:history or any read scope on message content. We can't see what's in your channels — only post to them.

Channel setup

After install, pick a default channel for digest posts:

  1. Settings → Integrations → Slack → Channel.
  2. The dropdown lists every public channel we have visibility into.
  3. Pick one and click Save.

For private channels, invite the AI Domination bot to the channel first, then refresh the channel picker.

Per-event channel routing

Different event types can route to different channels. Settings → Integrations → Slack → Routing:

Event Default channel
Daily digest #content-team
Approval requests Direct message to reviewer
Mention alerts #brand-monitoring
Audit complete #content-team
Publish success (off by default — too noisy)
Publish failure #engineering or #content-team

Slash commands

Three slash commands available in any channel where the bot is present:

  • /aid status — workspace summary: pending approvals, last audit, scores.
  • /aid audit [company] — kick off an on-demand audit. Returns when the audit completes.
  • /aid mentions [count] — list the most recent N mentions.

Inline approve / reject

When a draft is submitted for review, the reviewer gets a DM with:

  • The draft title and category.
  • A 200-character excerpt.
  • Three buttons: Open in browser, Approve, Request revisions.

Approve from Slack is the same as approving in-app — it's audit-logged identically. Request-revisions from Slack opens a modal where you type the notes, and the draft moves to Revisions Requested.

Troubleshooting

  • The app didn't post. Check the channel exists, the bot is invited (if private), and the workspace token hasn't been revoked. Settings → Integrations → Slack → Test post.
  • Slash commands not appearing. Slack caches command lists. Type / in a channel; if you don't see /aid, try /aid help. If still nothing, reinstall.
  • OAuth failed mid-install. Slack workspace policies may block new app installs without admin approval. Ask your Slack admin to approve the AI Domination app, then retry.

Uninstalling

Settings → Integrations → Slack → Disconnect, OR in Slack: Apps → AI Domination → Remove. Either route revokes the token and clears the channel mapping.

Was this article helpful?

Related docs

Installing the Slack app · AI Domination