The Slack Integration (with Slack Actions)

When you enable the Shortcut to Slack integration in your Slack Workspace:

  • Any Shortcut Story link you post in any channel in your Slack Workspace will unfurl with Story details (except for the story description).

  • You can use a Slack Action to create a Story from any message in any of your Channels in your Slack Workspace

  • You can broadcast Shortcut Story comments and Story additions from specific Projects or Teams to a designated Slack channel (story descriptions do unfurl for these)

  • Receive @-mention notifications as Slack DMs

Note: In order to enable or update this integration, you must be an Admin in Shortcut. 

Adding Slack Integrations

Click the Settings gear in the top right corner, navigate to Integrations, and select Slack. Only one Shortcut Workspace can be associated with a Slack Workspace at a time.


Slack_Authentication.png

 

Click on the Add to Slack button next to the Project you'd like to associate with a Slack channel. You will be redirected to Slack to authorize and select the channel where the Project's notifications will be posted.

 

Connect_Clubhouse_Project_to_Slack_Channel.png

 

You should now be all set up! 

Shortcut Comments and Story Activity 

Shortcut comments and Story additions will now drop into the selected channel attributed to the Shortcut Bot.

 

Example_of_a_Clubhouse_Comment_Notification_in_Slack.pngExample_of_a_New_Clubhouse_Story_Notication_in_Slack.png 

Updating the Slack Integration

If you've already installed the Slack integration but are using an older version of it, you'll see a blue alert message inviting you to re-authorize the Slack integration in Shortcut. Click on "To enable them, we need your authorization" to update the integration to the latest version available.

Screen_Shot_2020-04-08_at_12.19.03_PM.png

You'll be asked to review the permissions Shortcut and Slack will need to work together (you can see a longer explanation of each permission by clicking on the arrow next to it). Once you're ready, click Authorize.

New_Authorizations_for_the_Slack_Integration_in_Clubhouse.png

 

After you've authorized the permissions, you'll be taken back to the Slack integration page in Shortcut, where you'll see a green "Slack integration saved" success message.

Additional Features

Create Shortcut Story from Slack Message

In addition to notifications about Shortcut comments and Story additions, you can also create a Shortcut Story from within Slack using the Actions feature and see Story link unfurling in channels when the Slack integration is installed. Stories created from within Slack do unfurl to show the description, unlike Stories that were simply pasted in Slack.

Personal Slack Notifications

Personal Slack notifications allow you to receive a notification from the "Shortcut" app if you (or a Team you're a part of) are @-mentioned within a Shortcut story description or comment, or Epic description or comment. These personal Slack messages can be responded to in-thread to push a comment to the Story in Shortcut (and emoji reacts work, too 👍). You can't currently @-mention yourself for Slack notifications.

To enable these, you'll first need to make sure you've followed the above instructions for updating your Integration. 

Head to your Shortcut Settings once your Slack Integration has been updated and look for Notification Settings. Look for the section that now shows Slack Notifications: 
Screen_Shot_2020-04-09_at_10.23.35_AM.png

Hit "Sign in with Slack" to authorize the newest version of the code if you have not upgraded the Slack integration yet. 

Once the integration has been updated, you should now see the ability to toggle these personal Slack notifications on and off as you please:

Screen_Shot_2020-04-09_at_10.23.20_AM.png

All set! Now, you'll be able to ask a colleague to @mention you (or a Team you're in) to test this out. Enjoy!