← All guides
Integrations

Use Saemi from Slack

Install the Saemi Slack app, mention @Saemi in any channel, and get answers from your warehouse with a link back to the full chat.

Last updated: 2026-06-14

Once installed in your Slack workspace, the Saemi bot answers data questions in any channel it's invited to. The answer arrives in-thread; a "View on web" link opens the full Saemi chat with the chart, SQL, and verified-knowledge trail.

Install the bot

  1. In Saemi, open /accounts/connector/
  2. Click Slack → Connect via Slack workspace OAuth
  3. Slack asks you to confirm the workspace + scopes
  4. After authorization, the connector shows Personal account connected · your-workspace (https://your-workspace.slack.com)

Only a Slack workspace admin can install the bot for the whole workspace. After install, any member of that Saemi workspace can use it.

Ask Saemi in a channel

  1. Invite the bot to the channel: /invite @Saemi
  2. Mention with a question:

@Saemi what's our W2 retention by acquisition channel last week?

  1. Saemi reacts with 👀 to acknowledge, then posts a short answer in-thread within 30-90 seconds

The reply is a compressed TL;DR + 2-4 bullet findings, optimized for Slack's narrow column. A 🔗 View on web link opens the full answer (chart, SQL, table, citations) in your browser.

Continue the conversation in-thread

Reply in the same thread to ask follow-ups — Saemi keeps the thread's context, so you can ask "filter by US only" or "show the last quarter" without restating the original question.

Privacy + scope

Saemi only reads messages where it's explicitly mentioned. It does NOT scan channel history, log messages, or train on your conversations. Channel content is sent to the LLM only when needed to answer the mention.

The bot has these scopes (visible in Slack's OAuth confirmation):

  • app_mentions:read — receive @Saemi events
  • chat:write — post replies + the placeholder "Working on it…"
  • reactions:write — the 👀 acknowledgement
  • channels:history, groups:history — thread context (only for channels the bot is in)
  • users:read, users:read.email — match Slack users to Saemi accounts
  • team:read — workspace name + URL for the connector display

Per-user personal connection

Beyond the workspace bot, you can also connect your personal Slack account so Saemi's chat surface can search your DMs and private channels with your own permissions. This is opt-in per-user — same OAuth flow, same /accounts/connector/ page.

Troubleshooting

"Bot didn't reply" — confirm the bot is invited to the channel (/invite @Saemi). Channels the bot isn't in don't generate mention events.

"This Slack workspace is already connected to a different Saemi workspace" — one Slack workspace can map to only one Saemi workspace. Disconnect on the existing side first.

"Workspace bot connected, but mentions aren't received" — usually a webhook delivery hiccup. Re-disconnect and reconnect from /accounts/connector/ to refresh the install.

Where the workspace URL comes from

The connector page shows your Slack subdomain (e.g., https://saemi-lgn6105.slack.com). That's pulled via Slack's team.info API on first OAuth. If you re-install after the bot scopes change, the value refreshes.