The Slack integration allows you to receive project notifications in your Slack workspace. This integration currently supports notifications for:
- Suggested Edits: when someone suggests new edits to your project.
- Discussions/Support Forums: when someone asks a question in your project's Support Forums.
If your project has API Metrics enabled, you will also be able to access powerful insights about your API usage (top users, recent logs, etc.) via slash commands and a weekly summary message. You will be able to choose which channel the project notifications get sent to. At the same time, slash commands will be available for use in any channel.
To connect your ReadMe project to your Slack workspace, go to your Project Integrations on ReadMe (Configuration > Integrations), and click the Add to Slack button:
You'll be redirected to a Slack authorization page where you can select which channel/DM in your workspace that you'd like to send notifications and the weekly API Metrics summary to. Once you've authorized Slack, you will be redirected back to the ReadMe Integrations page, where you can configure your notifications by clicking Manage Slack Notifications.
A modal will pop up where you can configure which notifications you would like to receive. By default, all notifications and the API Metrics weekly summary are enabled.
Tip: Send different notifications to different channels
You can add as many Slack integrations to your workspace as you think makes sense for your workflow, making it easy to send notifications to #channel-1 for Suggested Edits, #channel-2 for Support Forum posts, @owlbert for everything, and so on. Just click the Add to Slack button for every new integration you wish to set up!
If you no longer wish to receive any or all ReadMe messages in your Slack workspace, you can do one of the following:
- To temporarily disable incoming messages, navigate to the Manage Slack Notifications modal and uncheck any or all of the notifications you wish to disable.
- To permanently disable incoming messages and slash commands, open the Manage Slack Notifications modal and click the Manage Configuration in Slack for the channel/DM you wish to disable. You'll be taken to the Slack Authorizations page, where you can disable any of the integrations you've configured, or revoke access for the ReadMe Slack integration completely. (And if you change your mind, just follow the steps above on setting up a new notification!)
Why am I still seeing the settings for a Slack configuration even though I've disabled it?
Immediately upon removal of an integration in the Slack Authorizations page (if you followed option two above), you may still see it in the Manage Slack Notifications modal. Don't worry! We will no longer send you notifications to that channel/DM (seriously — we literally couldn't if we tried!). The next time we attempt to use the integration, Slack will inform us that access has been revoked and we'll remove it from our system.
Updated 4 months ago