A GitHub integração do Slack permite que você conecte sua GitHub conta ao GitHub aplicativo no Slack. Uma vez conectado, você pode usar comandos de barra invertida para interagir com GitHub, receber notificações sobre a atividade do repositório e colaborar com sua equipe diretamente pelo Slack.
Conectando sua GitHub conta ao GitHub aplicativo no Slack
Observação
Antes de conectar suas contas, um administrador do workspace do Slack deve ter instalado o GitHub aplicativo. Confira Integrando GitHub ao Slack.
- No Slack, inicie uma mensagem direta com o GitHub aplicativo.
- A mensagem direta será preenchida previamente com uma mensagem de boas-vindas e um link para conectar sua GitHub conta. Siga as instruções na tela do Slack e no GitHub navegador para autenticar e autorizar a conexão.
Depois que sua GitHub conta estiver conectada, o Slack mostrará uma lista de comandos e recursos disponíveis que você pode usar.
Usando comandos Slash para interagir com GitHub no Slack
Para usar um comando de barra, digite /github seguido pelo comando que você deseja executar no campo de entrada da mensagem de qualquer canal do Slack ou mensagem direta em que o GitHub aplicativo está presente. Para convidar o aplicativo para um canal, digite /invite @github no canal.
| Command | Description |
|---|---|
/github help | Exibe uma lista de comandos essenciais e suas descrições. |
/github subscribe owner/repo | Assina o canal para notificações do repositório especificado. |
/github unsubscribe owner/repo | Cancela a assinatura do canal de notificações do repositório especificado. |
/github subscribe list | Lista todos os repositórios aos quais o canal está inscrito. |
/github open owner/repo | Abre um problema no repositório especificado. Você será solicitado a fornecer um título e uma descrição para o problema. |
/github close [issue link] | Fecha a questão especificada como concluída. |
/github close [issue link] reason:"not planned" | Fecha o problema especificado com um motivo. Substitua "not planned" por seu motivo. |
/github reopen [issue link] | Reabra o problema especificado. |
/github signin | Reinicia o processo "Conectar sua GitHub conta". |
/github signout | Desconecta a conta GitHub do seu usuário Slack. |
Observação
Ao inscrever um canal em um repositório, o canal receberá notificações para todos os eventos open, close e reopen em solicitações de pull e problemas nesse repositório. O canal também receberá notificações de quaisquer eventos push diretamente na ramificação padrão do repositório.
Iniciando agente de nuvem Copilot sessões no Slack
O GitHub aplicativo também se integra ao agente de nuvem Copilot Slack. Você pode usar essa funcionalidade para invocar agente de nuvem Copilot em threads em que discussões importantes estão ocorrendo e solicitar que ela faça alterações com base no contexto dessas discussões. Consulte: Integrando Copilot agente de nuvem ao Slack.
Menções no Slack
Ao assinar um repositório no Slack, você será mencionado em notificações para eventos de repositório nos quais você foi referenciado. Por exemplo, se você for atribuído a uma tarefa ou mencionado em um comentário, você verá seu nome na notificação do Slack.
As menções exigem que você esteja conectado à sua GitHub conta pelo aplicativo GitHub no Slack. Isso permite GitHub mapear sua identidade do Slack para sua GitHub identidade. Consulte Como conectar sua GitHub conta ao GitHub aplicativo no Slack.
Observação
Se você tiver vários espaços de trabalho do Slack em que usa o aplicativo, as GitHub menções funcionarão apenas no espaço de trabalho em que você se conectou ao aplicativo GitHub mais recentemente. Se você entrar no seu GitHub aplicativo em um espaço de trabalho diferente, as menções deixarão de funcionar no espaço de trabalho anterior.
Veja a seguir os cenários nos quais você será mencionado:
- Você foi designado para uma tarefa.
- Sua revisão foi solicitada em um pull request.
- Você é mencionado em uma solicitação pull, descrição do problema, comentário ou discussão.
- Sua avaliação é solicitada em relação a uma implementação.
- Você recebe um lembrete agendado para uma solicitação de revisão de pull.
Você pode ver um resumo de suas GitHub menções na visualização "Menções" no Slack. Para obter mais informações, consulte Notificações de triagem na guia Atividade na documentação do Slack.
Encadeamento de conversas
As notificações para cada problema ou solicitação de pull são agrupadas em um thread no Slack. A mensagem principal sempre exibe o status mais recente da issue ou solicitação de pull, juntamente com outros metadados como título, descrição, responsáveis, revisores, rótulos e verificações. O threading ajuda a manter as conversas organizadas, facilitando o acompanhamento de atualizações e discussões relacionadas a um problema específico ou solicitação de pull. Quando o estado de um problema ou solicitação de pull é alterado, a resposta associada é postada no thread e no canal, para que todos no canal estejam cientes da atualização.
Você pode desativar o agrupamento por tópicos para notificações de problemas e solicitações de pull em canais individuais.
- No canal do Slack em que você deseja desabilitar o threading, digite
/github settings. - No menu de configurações, à direita de "Desativar o agrupamento para notificações de Pull Request e Issue", clique em Desativar.
Você, ou qualquer outro membro do canal, pode habilitar novamente o encadeamento a qualquer momento, seguindo as mesmas etapas e clicando em Habilitar no menu de configurações.
Transmitindo comentários e revisões para o canal do Slack
Por padrão, comentários e revisões só serão exibidos em seu thread relacionado. Se quiser que os membros do canal os vejam em vez de apenas aqueles que são participantes do problema, você poderá aceitar a transmissão com os seguintes comandos:
-
Para a transmissão de comentários, use
/github subscribe owner/repo comments:"channel" -
Para revisar a transmissão, use
/github subscribe owner/repo reviews:"channel"
Desenrolando links para GitHub atividades no Slack
Visualizações de links fornecem contexto adicional ao compartilhar links para atividades GitHub no Slack. As prévias de links são mostradas no Slack para as seguintes GitHub atividades:
- Solicitações de pull
- Problemas
- Comentários vinculados diretamente
- Blocos de código com números de linha
- Organizações, repositórios e usuários
As visualizações de links não serão mostradas se qualquer uma das seguintes condições forem atendidas:
- As visualizações de link estão desabilitadas no seu espaço de trabalho do Slack. Consulte links de compartilhamento e defina preferências de visualização na documentação do Slack.
- O mesmo link já foi compartilhado no canal nos últimos 30 minutos.
- Três ou mais links são compartilhados na mesma mensagem.
- O repositório é privado e o usuário que compartilhou o link:
- Não conectou sua GitHub conta ao aplicativo GitHub no Slack.
- Foi solicitado que não fossem exibidas pré-visualizações de links quando solicitado.
- O GitHub aplicativo não está no canal em que o link é compartilhado. Consulte Uso de comandos de barra para interagir com o GitHub no Slack.
Agendando lembretes para revisões de pull requests
Você pode agendar lembretes para revisões de pull requests no Slack. Os lembretes podem ser enviados diretamente em uma mensagem direta pelo aplicativo GitHub ou para um canal onde o aplicativo GitHub está presente. Por exemplo, você pode agendar para receber um lembrete em uma mensagem direta todos os dias úteis às 10h, incluindo todas as pendências abertas que estão atribuídas a você.
Você pode configurar lembretes agendados para si mesmo, sua equipe ou toda a sua organização. Para obter mais informações, consulte:
-
[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-user-account/managing-your-membership-in-organizations/managing-your-scheduled-reminders) -
[AUTOTITLE](/organizations/organizing-members-into-teams/managing-scheduled-reminders-for-your-team) -
[AUTOTITLE](/organizations/managing-organization-settings/managing-scheduled-reminders-for-your-organization)
Leitura adicional
-
[AUTOTITLE](/integrations/how-tos/slack/customize-notifications) – Saiba como personalizar suas GitHub notificações no Slack para atender às suas necessidades. -
[AUTOTITLE](/integrations/tutorials/slack) – Crie habilidades e conhecimento sobre a integração do GitHub Slack por meio de exemplos e atividades práticas.