GitHub para Slack

O GitHub reúne equipes de desenvolvedores de software para escrever códigos e gerenciar projetos. Quando você conectar o GitHub ao Slack, poderá receber notificações sobre todos os tipos de eventos no(s) canal(is) do Slack de sua escolha. Conecte duas das suas ferramentas mais importantes e fique por dentro do trabalho usando o Slack. 🛠

Decidir qual app usar

  • GitHub para Slack: você tem o plano Developer, Team ou Business do GitHub? Esse app foi feito para você!
  • Github Notifications (versão antiga): esse app é compatível com o GitHub Enterprise.


Instalar o app

GitHub para Slack 

GitHub Notifications (versão antiga)

Com o app GitHub, você pode visualizar links de repositórios públicos no Slack, configurar notificações com comandos de barra e ficar atualizado facilmente sobre as atividades do projeto.


Instalar o app

  1. Acesse slack.github.com e clique em Adicionar ao Slack.
  2. Verifique as permissões que precisam ser acessadas pelo app e clique em Continuar para permitir.
  3. Selecione os canais que o app pode acessar: todos os canais públicos, canais específicos ou nenhum. 

Depois da instalação, o app GitHub enviará uma mensagem direta para ajudá-lo a concluir a configuração e mostrar como funciona o comando de barra /github.

Dica: use o comando de barra /github subscribe owner/repo para se inscrever nas suas configurações anteriores. 


Personalize as notificações

O app GitHub facilita personalizar o que é postado no Slack. É possível se inscrever em atividades relevantes para todo o canal e cancelar a inscrição em outros tipos de atividades que não são tão úteis. Algumas atividades notificarão você no Slack por padrão, enquanto outras não farão isso:

Recursos ativados por padrão

  • issues
  • pulls
  • statuses
  • confirmações
  • deployments
  • Público

Recursos não ativados por padrão

  • reviews
  • comments
  • branches
  • commits:all

 

É possível usar esses comandos de barra para personalizar as notificações

  • /github subscribe owner/repo [recurso]
  • /github unsubscribe owner/repo [recurso]


Observação sobre o app GitHub 

Se você usar outros apps no Slack, talvez observe algumas alterações no modo como o GitHub é instalado. Esse app específico funciona no nível de workspace, não no nível de membro. Isso é bom! Veja o porquê:

  • O app não será desconectado caso o instalador original saia do workspace. 
  • É possível adicionar o app GitHub a canais específicos. Faça sua escolha durante a instalação ou use /invite @github para adicionar o app a qualquer canal mais tarde.

💡 Saiba mais sobre o futuro dos apps do Slack no Blog da plataforma Slack. Se você for um desenvolvedor, saiba sobre o desenvolvimento da nova geração de apps do Slack e participe da visualização do desenvolvedor!

 

Se você usar a opção do GitHub no local, o GitHub Enterprise, será preciso instalar o app GitHub Notifications (versão antiga). 


Instalar o app

  1. Acesse GitHub no Diretório de apps do Slack. 
  2. Clique em Instalar.
  3. Selecione um canal onde os eventos do GitHub serão postados ou clique em criar um novo canal.
  4. Clique em Adicionar integração com o GitHub
  5. Clique em Autenticar a conta do GitHub.
  6. Escolha os repositórios sobre os quais quer receber notificações do Slack. 
  7. Escolha os eventos do GitHub que você quer postar no Slack.
  8. Se preferir, é possível personalizar como as postagens do GitHub aparecem no Slack escolhendo um ícone e nome exibido.
  9. Quando terminar, clique em Salvar integração.


Entenda as permissões 

O Slack solicitará permissão para acessar alguns repositórios do GitHub na primeira vez que conectar o app. Precisamos de acesso de leitura e gravação a todos os dados de repositórios públicos e privados: código, problemas, solicitações de pull, wikis, configurações, chaves de implantação, além de webhooks e serviços.

Sabemos que é bastante. O Slack só é capaz de acessar a lista completa dos seus repositórios privados e públicos com o escopo de "repositório" do GitHub, que também fornece todas as permissões listadas acima.

Observação: o Slack apenas usará essas permissões para ler dados de repositório (para obter uma lista de repositórios públicos e privados) e para configurar os webhooks no GitHub.


Como mudar para um modo não autorizado

É possível optar por configurar o app no modo não autorizado. Para isso, siga as etapas de 1 a 4 da seção anterior e depois faça o seguinte:

  1. Na página de configuração do Slack, clique em alternar para o modo não autorizado.
  2. Na conta do GitHub, acesse o repositório que você quer monitorar. Clique em Configurações no painel de navegação direito.
  3. Clique em Webhooks e serviços no painel de navegação esquerdo e pressione Adicionar webhook.
  4. Na janela do Diretório de apps do Slack, clique em copiar URL
  5. Ao retornar à sua conta do GitHub, cole o URL em URL de carga.
  6. No Tipo de conteúdo, certifique-se de que application/json esteja selecionado.
  7. Confirme que a Verificação SSL está ativada.
  8. Clique em Adicionar webhook.
  9. Retorne à página e configuração do Slack e clique em Salvar integração.


Adicione uma nova organização do GitHub

Quando você entrar em uma nova organização do GitHub, será preciso permitir que o Slack tenha acesso a ela. Depois de fazer isso, a nova organização será exibida em seu app existente. Veja como configurar:

  1. Visite as configurações do GitHub: github.com/settings.
  2. Em Authorized OAuth Apps, clique em Slack.
  3. Em Acesso da organização, clique em Conceder acesso ao lado da nova organização.

A nova organização e seus repositórios serão exibidos na página do app GitHub no Slack: my.slack.com/apps/manage.

Dúvidas? Entre em contato a qualquer hora. Estamos aqui para ajudar você!

Artigos relacionados

Artigos lidos recentemente