Integrando o GitHub com o Teams

Sobre a integração do GitHub com o Teams

A integração do GitHub com o Microsoft Teams oferece a você e às suas equipes visibilidade sobre seus projetos no GitHub diretamente nos canais do Teams. Você pode fazer triagem de problemas, colaborar em solicitações de pull e acompanhar as alterações sem sair do Teams.

Com a integração com o GitHub Teams, você pode:

Obtenha GitHub notificações nos canais do Teams.
Use comandos para executar ações em GitHub.
Confira visualizações ao compartilhar links para GitHub recursos.

Quando você concede acesso ao aplicativo GitHub em sua workspace do Teams, está concedendo a ele determinadas permissões. As permissões fornecidas são necessárias para que o aplicativo funcione corretamente e forneça os recursos esperados. Confira Permissões para GitHub no Teams.

Pré-requisitos

Para usar a integração do Teams GitHub, você precisa:

Uma GitHub conta.
Um workspace do Teams no qual você tem permissão para instalar aplicativos.

Instalando a integração do GitHub com o Teams no GitHub Enterprise Server

Para integrar GitHub Enterprise Server ao Microsoft Teams, primeiro você precisa configurar a integração de chat em sua instância e registrar um aplicativo no Microsoft Azure.

Registrar o aplicativo e provisionar o bot do Teams

No Console de Gerenciamento da sua instância do GitHub Enterprise Server, abra a página de Integração de chat e marque a caixa de seleção Habilitar GitHub integração de chat do.
Em "Selecionar cliente de chat", selecione Microsoft Teams e siga o link para registrar um aplicativo no Microsoft Azure.
Em Azure, configure os detalhes do registro do aplicativo:
- Insira o nome do registro do aplicativo.
- Defina os tipos de conta com suporte para vários locatários do Entra ID e Permitir todos os locatários.
Clique em Registrar.
Registre a ID do aplicativo (cliente) e a ID do locatário exibidas.
Em Certificados &segredos, crie um novo segredo do cliente.
Registre o valor do código secreto do cliente exibido.
Retorne ao Console de Gerenciamento e à página de Integração de chat na sua instância do GitHub Enterprise Server.
Clique em Deploy para Azure e siga os prompts para provisionar o bot do Teams no Microsoft Azure.
Em Azure, selecione o grupo Subscription e Resource para que o bot Azure seja implantado.
Insira a ID do aplicativo (cliente) e a ID do locatário que você registrou anteriormente, na configuração do bot do Teams.
Dependendo da configuração de rede para GitHub Enterprise Server:
- Se sua instância estiver acessível na Internet pública, marque a caixa de seleção Acrescentar '_msteams' ao caminho.
- Se sua instância não estiver acessível na Internet pública e exigir um proxy:
  - Verifique se a caixa de seleção Acrescentar '_msteams' ao caminho não está selecionada.
  - No campo Nome do Host da Instância do GHES , insira a URL que encaminhará o tráfego para sua instância.
Clique na guia Revisar + criar e clique em Criar para salvar as configurações e começar a provisionar o aplicativo.
Aguarde até que o bot do Teams seja provisionado no Azure.

Configurar GitHub Enterprise Server e instalar o aplicativo no Teams

Retorne ao Console de Gerenciamento e à página de Integração de chat na sua instância do GitHub Enterprise Server.
Insira o ID do cliente Microsoft, o segredo do cliente Microsoft e a ID do locatário Microsoft usando os detalhes do aplicativo que você registrou anteriormente.
Opcionalmente, se sua GitHub Enterprise Server instância não estiver acessível na Internet pública e exigir um proxy, insira a URL que encaminhará o tráfego para sua instância no campo URL do Ponto de Extremidade Público .
Clique em Salvar configurações do cliente.
Clique em Gerar manifesto para baixar o manifesto de integração para uso posterior.
Clique em Salvar configurações para aplicar as alterações à sua instância.
Faça logon no cliente do Teams e abra o Centro de administração do Teams.
Vá para aplicativos > do TeamsGerenciar aplicativos e clique em Carregar para carregar o manifesto de integração baixado em uma etapa anterior. Para obter mais informações, consulte Carregar seu aplicativo no Teams.
Instale seu aplicativo no Teams e execute @GHE signin para conectar sua GitHub conta.

Leitura adicional

          [AUTOTITLE](/integrations/how-tos/teams/use-github-in-teams) – Aprenda como usar a integração do GitHub com o Teams.

        [AUTOTITLE](/integrations/how-tos/teams/customize-notifications) – Saiba como personalizar suas GitHub notificações no Teams.