The Slack Integration (with Slack Actions)

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

  • Any Clubhouse 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 Clubhouse Story comments and Story additions from a specific Project to a designated Slack channel (story descriptions do unfurl for these)

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

Adding Slack Integrations

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


1.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! 

Clubhouse Comments and Story Activity 

Clubhouse comments and Story additions will now drop into the selected channel attributed to the Clubhouse 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 Clubhouse. 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 Clubhouse 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 Clubhouse, where you'll see a green "Slack integration saved" success message.

Additional Features

Create Clubhouse Story from Slack Message

In addition to notifications about Clubhouse comments and Story additions, you can also create a Clubhouse 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 "Clubhouse" app if you (or a Group you're a part of) are @-mentioned within a Clubhouse 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 Clubhouse (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 Clubhouse 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 group you're in) to test this out. Enjoy!