Slack

Note: The following Slack integration is in beta. If you'd like to be included in this, contact support@split.io.

The Slack integration allows teams to stay up to date on changes they care about in Split. By combining Split's rollout capabilities with Slack, you can:

• Keep your team notified about feature flag and segment changes
• Subscribe to the changes you care about by filtering notifications by Split project, environment, type (e.g., feature flag and segment), and action (e.g., create, update, delete)

With this integration, as a Slack user, you can subscribe channels to notifications based on filters that they set. Once these filters are set up by that user, any Slack user in that channel can see any event that exists that meets the filter criteria in that channel. In addition, you can see notifications relevant to you, specifically in the Split Slack App on the messages tab.

Note: If you are having trouble completing the integration, contact support@split.io.

Setting up in Split

To start, first set up in Split by doing the following:

1. Click the user's initials at the bottom of the left navigation pane and click Admin settings.
2. Click Integrations and navigate to the Marketplace tab.
3. Locate Slack App in the integrations list and click Add.
4. Click Save.

5. Navigate back to the newly created integration. The token and Add to Slack button display.

6. Click Add to Slack button. This takes you into the Slack OAuth flow.

7. In the Slack authorization page, you see a page with the message explaining the permissions required by the Split Slack app. Click the Allow button. You’re prompted to open Slack.

The Slack installation flow is complete and Slack is now open with a new app installed.

Setting up in Slack

To set up in Slack, do the following:

1. When you open Slack, a welcome message indicating that you successfully installed the Split app on the Slack workspace appears in the App’s home section:

2. Click the Configure button. The Configure Split App modal appears.

3. Enter the Split token that you generated when you set up on the Split side and click the Submit button. Slack displays the following:

Using Split commands

You can interact with the Slack app to initiate initial configuration, subscription management, and help documentation using the following commands:

• /split configure
• /split subscribe
• /split subscriptions
• /split help

Using the configure command

Note: Only admins have access to the Split token that is needed to enter in the configure modal.

Use the /split configure command to display the Configure Split app modal. When you enter your Split token and submit it here, this links the Slack app with your Split account. Note that you only need to use this command if you didn’t previously click the Configure button in the welcome message.

Note: If there is a problem with the token validation, an error message displays when you click the Submit button.

Create a channel subscription

Use the /split subscribe command to create a channel subscription, which subscribes your Slack channel to Split notifications. The Channel menu list is pre-selected with the current channel. However, a user can select a different channel if desired. Optionally select your desired filter criteria and click Submit to create the channel subscription.

Note: If you select a private channel, you get an error message indicating that the channel is private.

Managing subscriptions

The /split subscriptions command lists out the available subscriptions within the current channel, displaying a filter summary for each, and allows you to edit and delete subscriptions.

Edit a subscription

To make a change to a subscription, click the Edit button next to the desired subscription. The Edit Subscription modal displays pre-populated with the subscription’s filter criteria. Make the desired changes and click the Submit button. You get a message indicating that the subscription is updated.

Delete a subscription

Delete a subscription by clicking the Delete button next to a given subscription. You’re prompted with a confirmation message indicating that notification matching the subscription will be removed. Click the Confirm button to finish deleting the subscription.

Split/Slack webhook integration

Slack makes it easy to communicate with your team and keep your colleagues up to date on changes in Split. By combining Split's rollout capabilities with Slack, you can keep your team notified as new feature flags are enabled, as well as which rollouts are modified and by which of your teammates. If you are having trouble completing the integration, contact support@split.io.

Setting up in Slack

1. Go to the Incoming Webhooks page in the Slack App Directory here. Make sure you're signed into Slack.

2. On this page, if you're an Owner of your Slack Workspace, click the Add Configuration button and proceed to step 3.

2a. If you're not an Owner, click the Request to Install button and ask your Slack Workspace Owner to follow the rest of the steps in this doc.

3. Select a channel where you would like the notifications from Split displayed and click the Add Incoming WebHooks integration button.

4. On the Setup Instructions page, copy the Webhook URL.

Setting up in Split

1. Go to Admin Settings and click Integrations.

2. Click Add next to Slack.

3. Paste the Webhook URL you copied in step 4 and click Save.

Split notifications should now be flowing into Slack. If you have any issues with this integration, contact support@split.io.