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 Custom Field Values 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 Integration:

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.

Click on the Add to Slack button to install the Shortcut app to the Slack Workspace of your choice. Once authorized, you'll be redirected back to the Slack integration page where you can link a Team or Custom Field Value to a Slack channel.

Now all you'll need to do is select a channel for notifications to be posted in.

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.

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.

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.

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: 

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:

Connect a Team or Custom Field Value with a Slack Channel

Connecting a Team or Custom Field Value with a Slack Channel is a great way to ensure your squad stays up to date with what is happening in Shortcut. 

To set this up go to the profile icon in Shortcut and then Integrations. From the Slack integration page scroll down to Link Team/Link a Field Value to Slack Channel. Here you can Link a Team or Value and then Select a Slack Channel. Now you will get updates on comments and Story additions from specific Teams or Values to designated Slack channels.

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!

Updated July 11, 2023 18:51