Connect Slack

Connecting Slack installs the Cyborg app into your Slack workspace. One install covers everyone. You can link a Slack channel to a Cyborg channel so the two are the same conversation. Each person can also connect their own Slack account so agents can work in Slack as them.

This is Cyborg7’s own Slack app. It is not brokered through Composio, and it needs no machine connected to Cyborg7, so it works from the web app alone.

Requirements

• You can install apps into the Slack workspace (Slack asks an admin to approve if you cannot).
• You are an owner, admin or member of the Cyborg7 workspace you want to connect it to.

Connect Slack

1. Open Settings → Integrations, find Slack, and click Connect (it reads Manage once connected). The page is titled Slack: “Mirror Slack channels into Cyborg channels, both ways.”
2. Under Connect workspace, click Connect workspace.
3. In Slack, pick the workspace to install into, review the requested permissions, and choose Allow.
4. You return to Cyborg7 and the workspace is listed under Connected workspaces.

To install into another Slack workspace, click Add another workspace. Each install appears as its own connection.

Link a channel

1. On the Slack page, find Link a channel: “A Slack channel can feed one Cyborg channel.”
2. Choose the Slack workspace (Choose workspace…), the Cyborg channel (Choose channel…) and the Slack channel (Choose Slack channel…), then confirm.
3. Cyborg adds itself to a public Slack channel on its own. For a private Slack channel, invite it first in Slack with /invite @Cyborg, because Slack doesn’t let an app add itself to a private channel.

Messages then flow both ways. The link appears under Channel links. A Slack channel can be linked to one Cyborg channel at a time. Linking it somewhere else asks you to confirm, in a dialog titled Replace the existing bridge (or Re-link this channel).

Your Slack account

Under Your Slack account each person can connect their own Slack account, separate from the workspace install. Agents then act in Slack as you when you ask them to: read the channels you’re in, send messages from your account, and work through your direct messages. The card shows Connected as your Slack identity and what agents can do with the connection. Use Reconnect to re-approve or Disconnect to remove it (a dialog titled Disconnect your Slack account asks you to confirm).

Let an agent answer as you

The same card has Let an agent answer as you. Pick an agent and it reads the conversations it covers and replies as you, with your name and picture and nothing reviewed before it is sent. Choose Where it answers:

• every conversation you’re in, or
• Only these conversations, which you pick one by one.

Picking nobody turns it off. An optional note at the end of each reply tells people an agent wrote it. Removing a conversation stops it there at once, and disconnecting your Slack account ends all of it.

Workspace settings

Under Workspace settings on the Slack page:

• Slack channel placement: people are placed into the Cyborg channels that mirror the Slack channels they’re already in.
• Let agents message people in your Slack: agents can send a direct message to anyone in the connected Slack workspace, including people who don’t use Cyborg. The first message says who it is from, and anyone can reply STOP to never be messaged again.
• Match your team to Slack: agents reach people in Slack by email address. Confirm the matches here when someone uses a different address in Slack.

Each channel link also has a switch that lets people from an outside company in a shared Slack channel ask your agents questions. They cannot make an agent run commands and cannot see your other channels. Channel privacy lists private Slack channels that mirror into Cyborg channels the whole workspace can read.

Test the link

Link a channel, then post in it from Slack and check the message arrives in the Cyborg7 channel. Reply from Cyborg7 and check it lands back in Slack.

Troubleshooting

• Cyborg7 never answers in a Slack channel: the app has to be in the channel. Run /invite @Cyborg there. Slack does not let an app read or post in a private channel it has not joined.
• A connection needs reconnecting (the row shows Reconnect, or “Slack ended this connection”, or “Couldn’t check this connection”): Slack granted fewer permissions than Cyborg needs today, or the connection was ended in Slack. Click Reconnect on that connection and approve the app again. Your channel links are untouched.
• Messages reach Cyborg7 but replies don’t come back: check the channel is still listed under Channel links. Linking that Slack channel somewhere else ends the earlier link.
• Slack won’t let you install: your Slack workspace requires admin approval for apps. Slack shows a request button on the install screen, and an admin approves it there.