GitHub App

The GitHub app enhances developer collaboration by seamlessly integrating GitHub and Rocket.Chat. This app enables users to perform various tasks, such as searching and sharing issues and pull requests, subscribing to repository events, creating new issues, reviewing and merging pull requests, and more directly from the Rocket.Chat workspace.

Install GitHub app

To install the GitHub app in your workspace, follow these steps:

  1. Navigate to Administration > Apps > Marketplace.

  2. Search for the GitHub app.

  3. Click Install and accept the needed permissions to install.

  4. On the GitHub App Info screen, navigate to Details > API and note the GET github-app-callback URL.

Create the GitHub OAuth app

GitHub OAuth apps allow your workspace users to easily authenticate their GitHub accounts on the GitHub app. The OAuth app provides access to GitHub data, such as user profiles and repository information, and helps integrate GitHub functionalities. To manage your GitHub PRs, you will need to create an OAuth app and authenticate yourself.

To create a GitHub OAuth app, follow these steps:

  1. Log in to your GitHub account.

  2. Click your avatar from the menu bar.

  3. Select Settings and navigate to Developer settings > OAuth Apps.

  4. Click New OAuth App to create a new app.

  5. Fill in the required information.

    • Application name: Set the application name.

    • Homepage URL: Fill in the URL of your GitHub application homepage.

    • Application description: Add a description of the app.

    • Authorization callback URL: Paste the GET github-app-callback URL you copied from the GitHub App. For example, https://test-workspace.rocket.chat/api/apps/public/826f0d95-9e25-48a6-a781-a32f147230a5/github-app-callback

  6. Click Register Application.

  7. After registering the app, click Generate a new client secret to create a new client secret for the app.

  8. Copy the Client ID and the newly created Client Secret. You'll need them to configure the Rocket.Chat GitHub app.

Configure the GitHub app

To configure the GitHub app in your Rocket.Chat workspace, follow these steps:

  1. On the GitHub App Info screen, go to the Settings tab.

  2. Paste the Client ID and Client Secret you copied earlier in github-app-oauth-client-id and github-app-oauth-client-secret respectively.

  3. Click Save Changes.

After installing and configuring the app, you can proceed to explore Using GitHub App.