Slack

How to connect your Slack workspace with Village Labs.

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 Village 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 Village Labs app to your public Slack channels. Note that the Village Labs 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 Village account rep.

Optional Step 2: Adding Slack to specific Private Channels

Our default Slack connection will only add the Village Labs 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 Village Labs 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 Village Labs platform. Please ensure you do not add the Village Labs 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 Village Labs app to

3. There are two ways to add the Village Labs 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 'Village Labs' 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 Village Labs and add it.

         1. Note: be sure that you are adding your organization's Village Labs App. Your app will have a green circle next to 'Village Labs App'. If you are in a shared Slack channel with the Village Labs team, you may also see an 'Village Labs 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 Village Labs App.

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

4. Repeat for other channels you want to add Village Labs to.