Connect an agent to Slack
Connect an agent to Slack, and your team can mention it in a channel or send it a direct message. The agent answers in a thread, right where your team already works.
You set this up in two places: Agenta, where you name the assistant and get its app manifest, and Slack, where you create the app from that manifest.
Before you start
You need:
- An agent in Agenta that you want your team to use in Slack. It can be shared with the project or private. Only the owner of a private agent can connect it. See Share agents and chats.
- Permission to create and install apps in your Slack workspace.
Slack conversations with the agent are chats in Agenta, including direct messages. For an agent that is shared with the project, everyone in the project can read these chats and send to them in Agenta. They have no owner. For a private agent, new chats belong to the agent's owner. Only the owner, and the people the owner shares a chat with, can see them. When you pick the agent, Agenta shows this notice with your project's name. For a project named Acme support: "For a shared agent, everyone in Acme support can read its Slack conversations in Agenta, including direct messages. For a private agent, new conversations are private to its owner." Chats that already exist keep who can see them, and the owner can share a private chat.
Everyone in the Slack channel can talk to the agent, also when the agent is private. When someone sends a message to one of these chats in Agenta, the agent's answer also goes to the Slack thread.
1. Name the assistant in Agenta
- Open the agent's chat and click Publish.
- Next to Slack, click Add.
- Choose to use your own Slack app.
- Fill in how the assistant shows up in Slack:
- Name: the display name, such as
Outreach drafter. - Handle: what people type to mention it, such as
@outreachdrafter. Use letters, numbers, periods, hyphens, and underscores. - Description: one short sentence on what it does.
- Name: the display name, such as
2. Create the Slack app from the manifest
- In the Create app step, click Copy to copy the manifest. Agenta fills it with the name, handle, and description you entered.
- Click Open Slack app settings.
- In Slack, click Create New App, then choose From a manifest.
- Select your workspace, paste the manifest, and click Next.
- Review what the app can do, then click Create and Install to install it to your workspace.
3. Paste the app's credentials into Agenta
Copy three values from the app's settings in Slack:
| Agenta field | Where to find it in Slack |
|---|---|
| App ID | Basic Information. It starts with A. Do not use the Client ID. |
| Signing Secret | Basic Information |
| Bot User OAuth Token | Install App |
Paste them into the Connect step in Agenta, then click Connect app. Agenta checks the values with Slack before it saves them. After saving, they stay masked.
4. Choose where the assistant answers
After it connects, the Slack panel shows the app as Live. Under Answers in, choose where the assistant responds:
- Direct messages: anyone in the workspace can send it a direct message.
- Channels: it replies in a thread when someone mentions it in a channel.
To add the assistant to a channel, invite it there from Slack (for example, /invite @outreachdrafter). The channel then appears under Channels it's in. In the video, the assistant is added to an #outreach channel with channel replies turned on.
To answer in some channels only, open Advanced and set Channels it answers in to Only these channels, then check the channels. A channel you leave unchecked stays in the list, marked Off. A channel the assistant joins later stays off until you check it. Group DMs count as channels.
Choose who can message it
Under Access, Who can message it is Everyone by default. Choose Specific people to limit the assistant to a list. Search people by name, or type a full email. The list applies to this agent only, in direct messages and in channels.
When someone who is not on the list mentions the assistant or sends it a direct message, they get one short private note, at most once a day. The same happens when someone mentions it in a channel it does not answer in, or sends it a direct message while Direct messages is off. Only the owner of a private agent can change these settings.
5. Mention the agent in Slack
In the channel, mention the agent and ask for what you need. For example:
@Outreachdrafter Find the five newest contacts added to HubSpot this week. Research their companies and draft a personalized welcome email for each, signed John. Show me the research and drafts for review before sending.
The agent reacts with 👀 when it picks up your request. Open the thread to follow its response. When it has finished, the 👀 changes to ✅.
Anyone in the channel can mention the agent the same way to ask questions, request drafts, and review the results together in the thread.
Manage the connection
Open the agent's Publish panel and click Slack to come back to the connection. From there you can:
- Turn Direct messages and Channels on or off.
- See the channels the assistant is in, and add several at once with Add channel.
- Choose who can message it under Access.
- Update the app credentials under Access.
- Add another workspace or another Slack app.
- Disconnect the app.
Changes save automatically.
If the agent becomes private
When the owner makes a connected agent private, the agent keeps answering in Slack through the connections the owner made. A connection that another member made stops answering; the owner can connect the agent again. New Slack chats with it are private to the owner. Chats that already exist keep who can see them.
If a connection is off, open it in Channels and click Turn on.
Other channels
You can publish the same agent to Telegram and WhatsApp from the same Publish panel. See Connect a WhatsApp number to an agent.