Slack Integration

Setting up and using the Slack integration

Updated over a week ago

To hook up your Slack account to your Status Hero team, visit the Team Settings - Integrations page, open the “Slack” panel, and click on the “Add to Slack button”.

Status Hero will only connect with the people in your Slack account who are also Status Hero team members - it does this by matching email addresses. It won't connect everyone in your Slack workspace unless you add them all to Status Hero.

You can add other people from your Slack account to Status Hero by clicking on the “Add members from Slack” button on the Team members page.

Once connected, the friendly @statushero bot will take care of checking in your team and collecting daily goals. (You can always tweak reminder times, time zones, check-in questions, frequency, and other settings.)

Whenever someone on your team checks in, their update is neatly formatted and broadcast to the #channel of your choice in Slack.

A check-in summary is also delivered to your #channel, along with a Dashboard button to take you to Status Hero and drill down into individual goals and productivity metrics:

A convenient /checkin command is available in Slack to everyone on the team. They can use it to check in at any time or to see a summary of updates and metrics from the whole team.

Customizing your broadcast settings

To customize how your team will receive update broadcasts from Status Hero in Slack, open the "Slack" panel on the Team Settings - Integrations page.

By default, Status Hero will broadcast check-ins individually as they are published, and a summary report at the team summary time. However, you can enable the publication of a report's check-ins to a single thread by enabling "Broadcast check-ins into a summary thread" in the Slack settings in Status Hero.

When this option is enabled, the summary report is published as the anchor message of the thread, and is continuously updated as check-ins are published to the thread.

Troubleshooting

Resetting your connection

If your Slack connection isn't working properly, try removing and adding the connection back again. None of your existing data will be affected.

To do that, visit the integrations page in the team settings and click open the Slack panel. At the bottom of the panel, click or tap on the "Remove Slack connection" link. When the page reloads, click open the panel again and click or tap on the "Add to Slack" button.

Team members unable to receive Slack notifications

Status Hero uses the email addresses stored in your team settings to sync with Slack users. If someone is unable to receive Slack notifications or can't use the /checkin command in Slack, it's usually because their email address in Status Hero doesn't match the email address they use to log in to Slack. You can change the email address in Status Hero or add a secondary email address to fix the issue.

Using private channels

If you configure Status Hero to use a private channel, we also recommend giving the Status Hero read access to the channel rather than just the default broadcast-only access. This way the bot can use a threaded summary for each day and update check-ins when they are edited. Here's how to do that.

Selecting a DM or group DM as the configured channel

During the authorization process, Slack will allow you to select a DM or group DM as a broadcast channel. We don't recommend doing that, because the Status Hero bot won't be able to update edited check-ins or roll-up check-ins into a single report thread. If you're using a DM channel, you can switch to a public or private channel without losing any data. Here's how.

Switching channels

If you'd like to switch the channel Status Hero is broadcasting to, just remove the Slack connection and add Slack again to reset it. None of your data will be affected. Here's an overview for that if you need it.

Did this answer your question?