Skip to main content

GitHub pull request management

Learn how to get started with pull request management solution for GitHub.

Install GitHub pull request management from app directory and start using it by connecting your GitHub and Slack accounts.

Get started as a user

If you are invited to this app as a user, proceed to Get started as a user section to learn how to connect your GitHub account.

Features​

Review your GitHub pull requests through ephemeral Slack channels, notify your team about commits to the main branch.

Use cases​

How to get started​

Step 1. Install GitHub pull request management​

Visit GitHub pull request management in app directory and click Install button at top right corner.

Install GitHub pull request management

Step 2. Connect to GitHub and Slack​

After installing the app, you'll be prompted to connect your Slack workspace and GitHub account.

Connections for GitHub pull request management

Complete GitHub connection

  1. Click Connect near GitHub connection and proceed to authentication in GitHub via OAuth2.
  2. You will be asked to sign in to your GitHub account if you haven't already.
  3. Click Authorize Actioner. You’ll be redirected to Actioner upon successful authorization.

Complete Slack connection​

If you have not connected your Slack workspace, you can click Connect near Slack connection.

Slack connection

You can also add your Slack workspace by navigating to Workspace settings page from left menu and then switching to Slack workspace tab.

If you do not see Workspace settings page, contact with your workspace admin.

Step 3. Complete setup​

Setup GitHub pull request management

  1. Run Subscribe to GitHub events. This workflow creates a webhook on GitHub to subscribe to the pull request events from a selected repository.

    Note that you must have the permission to create a webhook in your selected repo to be able to subscribe to its events.

    • Enter the owner of your repository.
    • Select your repository.
Tip

Re-run Subscribe to workflow runs multiple times if you want to subscribe events from multiple repositories.

  1. Run Set PR update channel. This workflow creates a channel on Slack with a given prefix. (#-github-master-pushes) Anyone who joins this channel will receive an onboarding message from Actioner to explain how to connect GitHub.

    Also, when a commit is pushed to the master branch, a message will be sent to this channel to notify your team.

Step 4. Invite your team​

By default Everyone in your Actioner workspace is added to your app as Runner.

To grant app admin permission to a user, go to the Permissions tab of your app and add users or groups via + Add permission button. If you can't find the users you want to add, ensure they have been invited to your Actioner workspace.

Permissions for GitHub pull request management

Get started as a user​

If you are invited to this app as a user, you need to complete GitHub connection. This connection is required for you to take actions on GitHub notifications and to run workflows from Actioner shortcut in Slack.

  1. Navigate to GitHub connection, click Connect and proceed to authentication in GitHub via OAuth2.
  2. You will be asked to sign in to your GitHub account if you haven't already.
  3. Click Connect app. You’ll be redirected to Actioner upon successful authorization.

How to customize this app​

Pull request or merge request reviews with a different tool​

If you are using Bitbucket or GitLab, you can install Actioner apps that work in Slack with your version control tool.

Update emoji to send Slack messages as comments to GitHub PR requests​

To use another emoji to add comments to the GitHub oull request,

  1. Go to Workflows tab of your app and find the workflow named Add comment to pull request with pin emoji.
  2. Navigate to the trigger event and update the emoji on Trigger conditions.

Add a new repo to this app​

If your team is working on multiple repos, you can add all of them by running Subscribe to GitHub events.

  1. In Slack, call Actioner from shortcuts, or simply type /actioner and navigate to Subscribe to GitHub events workflow.
  2. Select the repo that you want to add.
  3. If you are not seeing your repo, the admin of your organization might need to allow Actioner app for subscribing to GitHub events. Try re-connecting to GitHub and request organization access from your admin.
Note

You do not need add the repositories that this app previously subscribed to their events.