Integrations 53 pages
On this page

Integrations

Connect Slack

Install the Cyborg Slack app once for the workspace, mirror channels both ways, and let agents work in Slack as you.

Connecting Slack installs the Cyborg app into your Slack workspace. One install covers everyone. You can sync a Slack channel with 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 Cyborg’s own Slack app. It is not brokered through Composio, and it needs no machine connected to Cyborg, 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 Cyborg workspace you want to connect it to.

Connect Slack

  1. Open Settings → Channel sync and choose Slack. Before Slack is connected the page is titled Slack: “Bring Slack channels into Cyborg and keep both sides in sync.”
  2. Click Connect Slack.
  3. In Slack, pick the workspace to install into, review the requested permissions, and choose Allow.
  4. You return to the Slack sync page (“Mirror Slack channels into Cyborg channels, both ways.”), and the workspace shows on the Connected workspaces card.

To install into another Slack workspace, open the ⋯ menu on the Connected workspaces card and choose Connect another Slack workspace. Each install is its own connection, and the card lets you switch between them.

Sync a channel

The Channels tab on the Slack sync page lists the Slack channels Cyborg’s app can see. Each row has a Sync switch.

  1. Find the channel (use Search channels or the filter: All, Synced, Not synced, Needs attention).
  2. Leave Include recent history ticked to copy the channel’s recent messages in when it starts syncing (the last 30 days, up to 1,000 messages). Untick it to bring only new messages.
  3. Turn on Sync. The status reads Syncing…, then In sync.

To sync several at once, tick their rows (the header checkbox picks every row shown) and click Sync N in the bar that appears, where N is the number of channels picked. The same bar has Import history (copy the recent history of channels that already sync), Stop syncing and Clear.

When a channel starts syncing, Cyborg puts it in a Cyborg channel, first match wins:

  • the Cyborg channel this Slack channel was linked to before, if it still exists;
  • a public Cyborg channel with the same name, for a public Slack channel;
  • otherwise a new Cyborg channel with the same name and the same privacy (public or private).

From then on messages flow both ways.

  • Private channels: Slack doesn’t let an app add itself to a private channel. Run /invite @Cyborg in the channel in Slack first; the row shows that command with a copy button until the app is in. Only people who are in a private Slack channel can sync it, so connect your own Slack account (see below) to show you’re in it.
  • Who can sync: only workspace owners and admins choose which channels sync. Members see the channels already mirrored and can show or hide each one with In your sidebar.
  • Plan: syncing a channel and importing history need Pro. On Free, existing links are kept, and Stop syncing still works.
  • Turning Sync off stops the mirror. The Cyborg channel and every message already in it stay. Turning Sync back on later continues in that same channel.

Pair channels by hand

Open Channel links… from the ⋯ menu on the Connected workspaces card (or the link icon next to the channel list) to pair a Slack channel with a Cyborg channel you choose. This is the only way to link a Slack Connect channel: the Channels tab hides Slack Connect and archived channels.

  1. Under Link a channel (“A Slack channel can feed one Cyborg channel.”), choose the Slack workspace (Choose workspace…), the Cyborg channel (Choose channel…) and the Slack channel (Choose Slack channel…).
  2. Click Link channel. Cyborg adds itself to a public Slack channel on its own; for a private one, run /invite @Cyborg in Slack first.

Every link is listed under Bridges. A Slack channel can be linked to one Cyborg channel at a time. If the pick would end an existing link, the button reads Replace bridge and a dialog titled Replace the existing bridge (or Re-link this channel) asks you to confirm.

Your Slack account

On the Your Slack identity card 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. Its ⋯ menu has Reconnect to re-approve, Account & auto-reply… (the Your Slack account panel, which also lists what agents can do with the connection) and Disconnect to remove it (a dialog titled Disconnect your Slack account asks you to confirm).

Let an agent answer as you

The Account & auto-reply… panel 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

The ⋯ menu on the Connected workspaces card opens these panels. Workspace settings… has:

  • 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.

Owners and admins also get:

  • 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.
  • Channel privacy…: lists private Slack channels that mirror into Cyborg channels the whole workspace can read.

In Channel links…, each link to a shared Slack channel also has a switch that lets people from an outside company ask your agents questions. They cannot make an agent run commands and cannot see your other channels.

Turn on Sync for a channel and wait for it to read In sync. Then post in it from Slack and check the message arrives in the Cyborg channel. Reply from Cyborg and check it lands back in Slack.

Troubleshooting

  • Cyborg 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 synced channels are untouched.
  • Messages reach Cyborg but replies don’t come back: check the channel’s row in the Channels tab still reads In sync (or that it is still listed under Bridges in 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.