# Integrando o GitHub com o Teams

Configure a integração GitHub com o Teams para melhorar a colaboração e simplificar os fluxos de trabalho.

## 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](/pt/enterprise-server@3.22/integrations/reference/teams-permissions).

## 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

1. 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**.
2. Em "Selecionar cliente de chat", selecione **Microsoft Teams** e siga o link para registrar um aplicativo no Microsoft Azure.
3. 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**.
4. Clique em **Registrar**.
5. Registre a ID do aplicativo (cliente) e a ID do locatário exibidas.
6. Em **Certificados \&segredos**, crie um novo segredo do cliente.
7. Registre o valor do código secreto do cliente exibido.
8. Retorne ao Console de Gerenciamento e à página de **Integração de chat** na sua instância do GitHub Enterprise Server.
9. Clique em **Deploy para Azure** e siga os prompts para provisionar o bot do Teams no Microsoft Azure.
10. Em Azure, selecione o grupo **Subscription** e **Resource** para que o bot Azure seja implantado.
11. Insira a ID do aplicativo (cliente) e a ID do locatário que você registrou anteriormente, na configuração do bot do Teams.
12. 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.
13. Clique na guia **Revisar + criar** e clique em **Criar** para salvar as configurações e começar a provisionar o aplicativo.
14. Aguarde até que o bot do Teams seja provisionado no Azure.

### Configurar GitHub Enterprise Server e instalar o aplicativo no Teams

1. Retorne ao Console de Gerenciamento e à página de **Integração de chat** na sua instância do GitHub Enterprise Server.
2. 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.
3. 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** .
4. Clique em **Salvar configurações do cliente**.
5. Clique **em Gerar manifesto** para baixar o manifesto de integração para uso posterior.
6. Clique em **Salvar configurações** para aplicar as alterações à sua instância.
7. Faça logon no cliente do Teams e abra o Centro de administração do Teams.
8. Vá para **aplicativos** >  do Teams**Gerenciar 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](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/apps-upload#upload-your-app).
9. 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.
  ```
* [Personalizando notificações para GitHub no Teams](/pt/enterprise-server@3.22/integrations/how-tos/teams/customize-notifications) – Saiba como personalizar suas GitHub notificações no Teams.