Slack integration
Last updated .
What does the MergeSafe Slack integration do?
It posts MergeSafe’s updates to a Slack channel you choose, and lets linked members answer them with exact commands in the thread.
- Review updates (off until you turn them on): when a pull request’s review starts and how it ended, with its score. A pull request’s reviews share one thread.
- Sentry errors: each analyzed error from the Sentry integration is posted with its most likely cause, and, unless you turn it off, the file and function.
- Commands in the thread: reply
fix [ref]to ask for a fix of that error, andconfirm merge [number]to merge the fix pull request that thread opened. Commands must be typed exactly. - Approving more issue cards: when the day’s free issue cards are used, an Admin replies
confirm 50 more issuesorconfirm 100 more issues(addevery dayfor a standing daily approval). See How reviews are charged. - Billing alerts (off until you choose a channel): low balance, monthly spending limit and failed auto-refill, with amounts.
- Review digest (off until you choose daily or weekly): a summary of reviews in the channel.
How do I install it?
You need a MergeSafe organization with the GitHub App installed, and you must be its Admin. In Slack you need permission to add apps to the workspace.
- Sign in at app.mergesafe.ai with GitHub and open your organization’s Integrations page.
- Click Connect Slack on the Slack card.
- Slack opens its install page for MergeSafe. Pick your workspace and click Allow.
- Slack sends you back to the app. Under Channel, choose the public channel MergeSafe posts to. MergeSafe joins it.
- Turn on Post reviews in channel if you want review updates, choose a billing alerts channel and a digest if you want them, and click Save changes.
Only the Admin who started the install, still signed in, can finish it.
Who can run commands?
Only a Slack member an Admin linked on the Slack card, whose GitHub login has write access to the repository. Add one per line under Members: their Slack member ID (in their Slack profile, Copy member ID), then their GitHub login. Delete a line to unlink them. Commands from anyone else are refused.
What permissions does it request, and why?
- chat:write: to post updates and answer commands.
- channels:read: to list your public channels so you can choose one.
- channels:join: to join the channel you choose.
- channels:history and app_mentions:read: to receive replies in the threads MergeSafe posted, where commands are typed.
- reactions:write: to react to a command so you know it was received.
Public channels only. MergeSafe can’t read private channels or direct messages.
What data does it keep?
- Your workspace’s name and ID, and the bot token Slack issues, encrypted.
- The channels you chose and your settings.
- The member links an Admin added (Slack member ID and GitHub login).
Credentials are always redacted from what MergeSafe posts. See our privacy policy and what data MergeSafe keeps.
How do I remove it?
On the Slack card in app.mergesafe.ai, click Disconnect: MergeSafe revokes its token at Slack and deletes the connection and the member links. Your saved settings (review posts, billing alerts channel, digest) stay saved for when you reconnect; a billing alerts channel only applies again in the same workspace. You can also remove the app from your workspace in Slack; MergeSafe stops posting once Slack revokes its access.
What does it cost?
The Slack integration is free. Reviews, Sentry analyses and fixes are charged as usual from your organization’s prepaid balance; see How reviews are charged.
Where do I get help?
Email support@mergesafe.ai, or see the FAQ.