Slack

Slack does double duty in Sonora. Installing the Sonora app gives your team a Sonora bot they can DM or @-mention from any channel — chat without leaving Slack. The same install also lets Sonora ingest selected internal channels so customer conversations from your team’s Slack become part of every answer Sonora gives.

Both behaviors come from a single OAuth install. You can use one without the other.

What syncs from connected channels

When you enable channel ingestion on specific channels, Sonora imports:

• Channel messages
• Threaded replies
• Channel metadata (name, purpose, members)
• Slack user profiles for attribution

Channels not explicitly enabled are never read. Sonora does not message customers, post in channels, or join external (shared with another org) channels.

Prerequisites

• Sonora permission to manage integrations
• Slack workspace admin access — or the ability to request app approval if your workspace requires it

Install

1. In Sonora: Settings → Integrations → Slack → Configure.
2. Click Add to Slack.
3. Slack prompts you to choose a workspace and review permissions. Confirm and click Allow.
4. You’ll be redirected back to Sonora, and the Slack card switches to “Installed”.

If your workspace requires admin approval for new apps, the install will pause until an admin approves Sonora — restart from the same card after approval.

Chat with Sonora in Slack

Once installed, anyone with a Sonora account can chat with the bot:

• Direct message the Sonora bot — same chat experience as the web app.
• @mention the bot in any channel where it’s been added. Replies are visible to the channel, useful for sharing results with the team.

For private channels, invite the bot to the channel before mentioning it. The bot won’t activate in channels shared with external organizations.

Sync conversations

Channel sync is configured separately from the Slack bot:

1. Open the Slack card and go to Channel Ingestion.
2. Search and select the channels you want Sonora to read.
3. Open Actions → Enable on the channels you’ve selected.
4. Toggle Enable automatic syncing and pick a schedule.
5. Save.

Public channels are joined by Sonora automatically when enabled. Private channels need the Sonora bot invited in Slack first; once it’s a member, enabling the channel works.

Disconnect

From Settings → Integrations, click Disconnect on the Slack card. The bot is removed from the workspace and any future syncs stop. If you want to fully scrub Sonora from the Slack side, also remove the app at Slack → Apps → Sonora → Configuration → Remove app.

Troubleshooting

“App approval required” — Workspace admins have to allow new apps. Ask an admin to approve Sonora, then restart the install from Sonora.

No channels appear when configuring sync — Confirm the bot is installed in the right workspace, the channels aren’t archived, and that private channels have the bot as a member.

A channel shows “Needs join” — For private channels, invite the Sonora bot in Slack. For public channels, retry — Sonora joins automatically but Slack briefly returns this state during the join.

Authorization errors — Reopen the Slack card, click Configure, and re-authorize. If the workspace install was deleted in Slack, run Add to Slack again from Sonora.