Slack

Each sub-agent can be connected to a Slack bot, allowing it to receive messages and respond directly inside your Slack workspace.

Overview

Connecting Slack takes about three minutes:

1. Open the Add Messaging Account dialog in your agent - it generates a unique manifest for you
2. Create a Slack app using that manifest (scopes, events, and webhook URL are pre-configured)
3. Install the app to your workspace and paste two credentials back into the dialog

We're working on making this even easier with a dedicated Jeanette Slack app, which will remove these manual steps entirely. It's currently pending Slack's review.

---

Step 1 - Open the dialog and copy the manifest

In the Jeanette dashboard, open your agent and go to the Messaging tab.

Click Add Messaging Account → Slack. The dialog generates a unique manifest that already contains your agent's webhook URL, all required scopes, and event subscriptions. Click the copy icon to copy it.

---

Step 2 - Create the Slack app

Go to api.slack.com/apps and click Create New App.

When prompted, choose From a manifest rather than "From scratch". Select your workspace, then paste the manifest you copied into the JSON tab.

You can change the "name" and "display_name" fields to match your agent's name if you like.

Click Next, review the summary, then click Create. The app is now fully configured - scopes, events, and webhook URL are all set.

---

Step 3 - Install the app and paste your credentials

After creating the app you'll land on the app's Basic Information page. You need two values from here:

Signing Secret On the Basic Information page, under App Credentials, click Show next to Signing Secret and copy it.

Bot Token In the left sidebar, click OAuth & Permissions (under Features). Click Install to Workspace and allow the permissions. Once installed, the Bot User OAuth Token (starting with xoxb-) appears at the top of that page. Copy it.

Paste both values into the dialog and click Connect. That's it - your agent is now connected to Slack.

---

Using the bot

Once connected, your agent will respond to:

• Direct messages - message the bot directly in Slack
• Channel mentions - mention the bot in any channel it has been added to (@YourBotName)

Your agent can also proactively post messages to any public channel without needing to be invited - for example as part of a scheduled task:

"Every morning at 9am, draft a new blog post, add it to Notion, then post the link in #marketing for me to review."

To add the bot to a private channel, type /invite @YourBotName in that channel.

---

Troubleshooting

"Slack rejected the token" - Make sure you copied the Bot User OAuth Token (starts with xoxb-), not the User OAuth Token or the App-level token.

Bot doesn't respond - Check that:

• The app is installed to the workspace (OAuth & Permissions → Install to Workspace)
• Event Subscriptions shows a green tick next to the Request URL
• The bot has been added to the channel you're messaging in (for channel messages)