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.

Step 1. Slack OAuth Connection

We use OAuth to connect to Slack.

1. Login to the Coworker Network admin using Google Single Sign-on: https://app.villagelabs.net/

2. Navigate to the Network Manager https://app.villagelabs.net/networks/{network-name}/management

3. In the side menu, go to 'Data' > 'Slack Integration'

4. Follow the steps to activate the Slack connection. Note: if you 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.

5. Please also share your Slack Workspace ID with the Village team. The easiest way to find your Workspace ID is to open the Slack web app (eg. open Slack in a browser) and copy the ID in the browser after 'client/'. It will look something like "TXXXXXXXXX"

6. See below for an optional step to connect to Slack Private Channels

Connecting to Slack will default to adding the Coworker app to your public Slack channels. Note that the Coworker app will never read private 1:1 messages.

If you would like the Slack app to only join specified channels rather than defaulting to joining public channels, please reach out to your Coworker account rep.

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 Village Labs app to, follow the below steps.

Note: adding the Coworker app to private Slack channels means the content of these channels will be summarized as part of Individual, Team, and Topic Reporting and available to all members of your organization who have access to the Coworker platform. Please ensure you do not add the Coworker app to any private channels that contain sensitive information that you do not wish to share with your broader organization.

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.