Slack

Connect a Slack workspace so your processes can post to it and act on the messages they send. metamorphOS sends messages to channels, edits them, reacts to them, and resolves the channels and people needed to address them.

What you can do

• Messages: post a message to a channel (by channel or #name), reply in a thread, and edit a message you posted earlier.
• Reactions: add an emoji reaction to a message.
• Channels: list the channels the app can see, filtered by type and whether they are archived.
• People: find a workspace member by email address.
• Links: get a stable, shareable link to a message.

Before you start

You need a Slack workspace and permission to create a Slack app in it (a workspace owner or admin, or an account with app-management access). The app is yours: it lives in your workspace, and metamorphOS acts through it.

Set up Slack

1. Create a Slack app. Go to https://api.slack.com/apps  and choose Create New App → From scratch. Give it a name (for example, metamorphOS) and pick the workspace to build it in.

2. Grant the bot scopes. Open OAuth & Permissions and, under Scopes → Bot Token Scopes, add all six. Slack only issues the scopes present here when you connect, so a missing one fails the matching function later.

   Scope	Used for
   chat:write	post and edit messages
   chat:write.public	post to public channels the app has not been invited to
   channels:read	list public channels
   groups:read	list private channels
   users:read.email	find a member by email
   reactions:write	add emoji reactions

3. Set the redirect URL. Still under OAuth & Permissions → Redirect URLs, add the callback URL that metamorphOS shows when you add the account, then save.

4. Copy the credentials. Under Basic Information → App Credentials, note the Client ID and the Client Secret. You enter both in metamorphOS.

You do not install the app from the Slack dashboard. The connect flow in the next section installs it to the workspace when you approve.

Connect in metamorphOS

Activate the Slack connector from the marketplace and add an account. Enter the app’s Client ID and Client Secret, then start the connect flow: metamorphOS sends you to Slack to approve the six permissions, Slack installs the app to the workspace, and metamorphOS stores the resulting token for you. There is no token to copy by hand. Each account can point at a different workspace.

Good to know

• This connector is outbound only: it acts in Slack but does not receive Slack events, so it cannot trigger a process when something happens in Slack.
• Posting to a private channel needs the app invited to that channel first (/invite @<app name> in the channel). Public channels need no invite.
• When Slack rejects a request (for example, the channel was not found, the app is not in the channel, or a rate limit was hit), metamorphOS treats it as a failure rather than a silent success.
• Field coverage is still expanding, so some fields Slack returns may not be available yet.