Slack
Sprig’s Slack integration allows customers to receive notifications about Sprig studies in their desired Slack workspace channels. Some highlights about the integration include:
- Per study configuration of Slack channels
- Three notification types: Study Connected, Study Responses, Study Completed
- Public and Private channels access
- Default catch-all Slack configuration
Before getting started
- The Sprig Slack integration is available to all plans.
- Only a Sprig Admin, Developer, or Editor role can enable the Slack integration in Sprig, while in Slack, channel creation and application integration are determined by your Slack administrator.
- You may need to add your Slack administrator to the Sprig account so that they can install the integration. If you have added more than one product in Sprig, you may configure separate Slack channels for each product.
Once you have the right Slack channels available and have verified the permissions for integrating Slack, you can map specific studies to specific Slack channels, or send all your study notifications to a single Slack channel for a given environment. Listed below are some general recommendations:
- Study-level channels: a channel with a working group or stakeholders who are interested in responses for a specific study
- Default channel for all study notifications: a channel with your whole product team or stakeholders to see when any study is connected to Slack, completed, or receives a response. This is set at an environment level.
Connecting Sprig with Slack
There are three ways to grant Sprig authorization to your Slack Workspace.
Method 1: Integrations > Slack
-
In the Sprig app, navigate to the Slack Integrations page (Integrations > Collaboration > Slack) and click the Connect button.
-
Slack will ask for permission to connect with Sprig. Please make sure you have the intended workspace selected and then click Allow.
- Sprig will request the following bot scopes:
channels:read
,chat:write
,team:read
,chat:write.public
- If you’d like Sprig to send notifications to a private channel, toggling “Private channel access”, will also request the
groups:read
andgroup:write
scopes. - For more information on Slack Oauth2 scopes, please feel free to refer to the Slack documentation.
- Sprig will request the following bot scopes:
- Once authorized, you will be redirected to the Slack Integration page. To turn on study-level notifications, navigate to an in-progress study’s Connect tab to choose a channel.
Method 2: Study launch modal
- Once a study is launched, click Connect on the launch modal’s Slack banner.
- Slack will ask for permission to connect with Sprig. Please make sure you have the intended workspace selected, then click Allow.
- Once authorized, you will be redirected to the Connect tab for your recently launched study. From here, you can set one or more Slack channels to receive response notifications.
Method 3: Results page
- For any in-progress study, navigate to the study’s results page and click on the Connect tab. From here, click Connect.
- Slack will ask for permission to connect with Sprig. Please make sure you have the intended workspace selected, then click Allow.
- Once authorized, you will be redirected back to the Connect tab for your recently launched study. From here, you can set one or more Slack channels to receive response notifications.
Connect to private Slack channels
The Sprig bot must be invited to any private Slack channel that you wish to receive notifications.
- In Slack, navigate to the private channel and click on the channel name to Get channel details.
- In the modal that appears, select the Integrations tab, and click Add an App.
- Sprig should be listed in the In your workspace section. Click Add to invite the Sprig bot to your private channel.
- In Sprig, you will now see your private channel as an option in the Select Channel dropdown. Private channels are denoted with a lock icon.
- Note: If you have trouble connecting private Slack channels, your Slack connection may not have Private Channel Access enabled. This setting must be enabled prior to connecting your Slack workspace to Sprig. In order to fix this, on the Slack Integrations page, you must disconnect Slack, toggle on Private Channel Access, and re-connect Slack.
Notification settings
Default Channel (Optional)
You can set a Default channel for all study notifications. This channel will receive a notification when any study is connected to Slack, completed, or receives a response. This is set at an environment level. If you do not wish to receive messages across all studies, leave it as Not Set.
User Emails (Optional)
You can include a respondent’s email address in study response notifications by toggling it on under Notification Settings. The email address is populated from visitor attributes. This is set at an environment level.
Disconnecting Slack
To remove the Slack integration, click the Disconnect button on the Slack Integration page, and on the modal, choose whether to save your channel settings and click Disconnect. This will remove the Sprig App from your workspace and stop all Sprig notifications from being sent to Slack.
For more information, visit the Sprig Privacy Policy.
Updated about 2 months ago