Using the Slack Integration
- Setting Up the Slack Integration
- Connecting your User Account to Slack
- Configuring Webhooks
- Disconnecting your Slack Account from HelpDocs
You can manage your HelpDocs articles and get notifications from Slack. Members of your Slack team can connect up their HelpDocs accounts and start sending /commands. Plus, your whole team can enjoy HelpDocs notifications in a Slack channel of your choice.
Setting Up the Slack Integration
Connecting your Team to Slack
Before you can start using the HelpDocs Slack integration you'll need to add our Slack app to your team.
- In your HelpDocs dashboard, head to Settings > Integrations
- In the Slack card, hit Add to Slack
- We'll redirect you to Slack to grant us access to your team
- Log into Slack if you aren't already logged in
- If you have multiple Slack teams, choose the one you want to connect to HelpDocs
- Review the permissions
- Incoming Webhooks let us post notifications in to a Slack channel of your choice. You can customize these later.
- Commands lets us add /commands to your team so you can interact with your docs
- Identity lets us identify your teammates so we can show the right docs to the right people
- Choose a channel for us to post notifications (incoming webhooks) to
- Click the Authorize button to return to HelpDocs
Connecting your User Account to Slack
You can connect your Slack and HelpDocs accounts in the HelpDocs dashboard manually. Or just follow the instructions the first time you use a /command.
- In HelpDocs, head to your Profile by clicking your avatar in the navigation bar
- Under Slack, click Sign In with Slack
- We'll redirect you to Slack
- Login to Slack if you aren't already logged in
- Choose the correct Slack team (if prompted)
- Click Authorize to return to HelpDocs
Now you can use /commands in Slack to create and search for articles. Your permissions there will mirror your HelpDocs permissions.
HelpDocs can send notifications into a Slack channel of your choice through Incoming Webhooks.
You can choose which notifications you'd like to receive so your team's not bombarded with data you don't find useful.
- Head to Settings > Integrations
- In the Slack card, click Show Webhooks
- Check the events you'd like to receive in Slack
- Hit Save
Disconnecting your Slack Account from HelpDocs
If you don't wanna use the Slack integration anymore you can easily revoke our access. I promise we won't take it personally 😢
- Head to your HelpDocs Profile by clicking your avatar in the navigation bar
- Under Slack, hit the link to revoke access
Using the Slack Integration
When you connect the Slack integration we add two /commands to your team: /hd and /hdprivate. The former lets you interact with your Public docs (the ones you write in the Articles tab). The latter lets you work with Private docs.
On either command you can add help to get a list of all the things you can do.
|/hd||search [query]||Search your Public articles for [query]|
|create [title]||Create a new Public article called [title]|
|/hdprivate||search [query]||Search your Private articles for [query]|
|create [title]||Create a new Private article called [title]|