Skip to main content
Slack connects to Athena in three ways. None of them asks you to create an app from a manifest or paste a Bot User OAuth Token into Athena, and Athena does not index your Slack channels.
Agent Slack apps and Athena for Slack are self-serve. Connecting your own Slack account is in early access: until it opens to every member, only Athena Intelligence staff (and members who already hold a Slack connection) see the Slack card. Contact us at team@athenaintel.com if you need it.

​
Agent Slack apps: talk to an agent in Slack

Each agent that enables Slack gets its own Slack app and bot user, so your team can mention that agent in a channel and get its answer in the thread. Setup lives on the agent’s Slack section in Athena.
1

Connect your Slack workspace (workspace admin, once)

At api.slack.com/apps, open Your App Configuration Tokens and generate a token for the Slack workspace. In Athena, open an agent’s Slack section, paste the access token (xoxe…) and refresh token (xoxe-1-…), and confirm Connect workspace Slack. Athena stores the pair encrypted and rotates it automatically; it is used only to create and update your agents’ Slack apps.
2

Create and install the agent's bot

Choose a bot name and icon, click Create this Slack bot, then Install this Slack bot. Slack opens to authorize the bot; once authorized it is live immediately, without publishing the agent.
3

Choose where it replies

Add the channels the bot replies in, or switch on Enable all channels. Invite the bot to a channel like any Slack app, then mention it by its bot name to start a thread.
Conversation behavior in Slack is described on the Channels page. Athena for Slack is one workspace-level app. An Olympus workspace owner or administrator installs it from Workspace Settings › Integrations › Athena for Slack; the card is shown when your deployment has the app configured. Once installed:
  • Athena links posted in Slack unfurl as cards for members who can open the asset. Whether titles appear in previews is a switch on the card.
  • An owner who posts a link is privately offered to share the asset with channel members who cannot open it.
  • Approval requests can be delivered as Slack direct messages with Approve and Reject buttons; the decision is recorded under the Slack member’s Athena account.

​
Your own Slack account: Athena reads and sends as you

Once this connection opens to members (see the note above), each member connects their own Slack account, so Athena reads Slack as them and sends only what they approve. The connection is personal: nobody else in your workspace can use it.
1

Connect your Slack account

On the Integrations page, find Slack under Communication and Click Connect on the Slack card, then Connect Slack in its details. Slack’s consent screen opens; choose the Slack workspace and approve. If your Slack workspace restricts app installs, Slack first asks you to request approval from your Slack administrator.
2

Work with Slack in a session

Athena reads the channels, private channels, DMs and group DMs you can see, live from Slack when you ask; it does not sync your messages into Athena. It asks for your approval before it sends a message or adds a reaction, except for a note to your own Slack DM that mentions nobody and has no links.
3

Add more Slack workspaces

Click Connect another Slack workspace for each additional Slack workspace. Each one becomes its own connection.