Integrating GitHub with Teams

Set up the GitHub integration with Teams to improve collaboration and streamline workflows.

In this article

About the GitHub integration for Teams

The GitHub integration for Microsoft Teams gives you and your teams visibility into your GitHub projects directly in Teams channels. You can triage issues, collaborate on pull requests, and keep track of changes without leaving Teams.

With the GitHub integration for Teams, you can:

  • Get GitHub notifications in Teams channels.
  • Use commands to take actions on GitHub.
  • See previews when sharing links to GitHub resources.

When you grant the GitHub app access to your Teams workspace, you are granting it certain permissions. The permissions provided are necessary for the app to function correctly and provide the features you expect. See Permissions for GitHub in Teams.

Prerequisites

To use the GitHub integration for Teams, you need:

  • A GitHub account.
  • A Teams workspace where you have permission to install apps.

Installing the GitHub integration for Teams on GitHub Enterprise Server

  1. In the management console for your GitHub Enterprise Server instance, open "Chat integrations" and enable GitHub Chat Integration.
  2. Select the Microsoft Teams tab and follow the link to register an app in Microsoft Azure.
  3. Record the application (client) ID and tenant ID, then create a client secret.
  4. Back in the management console, choose Deploy to Azure and follow the prompts to provision the Teams bot.
  5. Enter the app ID, tenant ID, and client secret in the Teams configuration, then save the settings.
  6. Download the generated manifest and upload it to Teams. For more information, see Upload your app to Teams.
  7. Install the app in Teams and run @GitHub Notifications signin to connect your GitHub account.

Note

If your GitHub Enterprise Server instance is not reachable from the public internet, provide the proxy URL when configuring the Teams bot in Azure.

Further reading