Slack

How to connect your Slack workspace with Coworker.

Note: if you have are a member of multiple Slack Workspaces, it is very important that you connect to the right Workspace. You will see a dropdown in the top right of screen when making the Slack connection that allows you to specify the Workspace you are connecting to. Please ensure you have the right Workspace connected.

How to add the Slack app

Step 1: Slack OAuth Connection

We use OAuth to connect your Slack workspace to the Coworker Slack app.

1. Go to the Coworker Connector page. If you're setting up a new Coworker Workspace, we will provide you with this direct link. If you have existing Coworker Workspace and you're an Admin, click on your profile in the bottom left > Data > Data Sources

2. Click Connect Slack app and follow the OAuth connection steps. Note: if you have multiple Slack accounts, it is very important that you connect to the right account for your company or organization.

Note: The Coworker Slack App will be added to your public Slack channels. If you do not want this to happen, you must select 'Advanced Settings' and uncheck the join public channels option

1. You'll see a success message confirming the connection has been made.

Optional Step 2: Adding Slack to specific Private Channels

Our default Slack connection will only add the Coworker app to public Slack channels.

Some companies use Private channels for non-sensitive information (eg. to gate access for some channels to particular people for logistical reasons, even if the content is non-sensitive)

If there are particular private, but non-sensitive, Slack channels that you want to add the Coworker app to, follow the below steps.

1. Open the Slack app

2. Click on the private channel you want to add the Coworker app to

3. There are two ways to add the Coworker app:

   1. Using the Channel Settings

      1. Click on the Chevron to the right of the Channel name:

      2. Click the 'Integrations' tab

      3. Go to Apps, 'Add an App'

      4. Search 'Coworker' and click 'Add'

   2. Using Invite Commands

      1. Use the invite and remove commands: in the private channel's chat input, type the command "/invite" and select the 'Invite App' option.

      2. Next, search and select Coworker and add it.

         1. Note: be sure that you are adding your organization's Coworker App. Your app will have a green circle next to 'Coworker App'. If you are in a shared Slack channel with the Coworker team, you may also see an 'Coworker App' when you use an invite command that has a green square next to it. Do not add this app as it is not your organization's Coworker App.

      3. To remove the Coworker app from a private channel, type the command "/remove" and then type @Coworker - this will remove the app from the channel until it is re-invited

4. Repeat for other channels you want to add Coworker to.