A integração GitHub para Slack permite que você conecte sua conta GitHub ao aplicativo GitHub no Slack. Depois de conectado, você pode usar comandos de barra para interagir com GitHub, receber notificações sobre a atividade do repositório e colaborar com sua equipe diretamente no Slack.
Conectando sua conta GitHub ao aplicativo GitHub no Slack
Observação
Antes de conectar suas contas, um administrador do workspace do Slack deve ter instalado o aplicativo GitHub . Confira Integrando o GitHub ao Slack.
- No Slack, inicie uma mensagem direta com o aplicativo GitHub .
- A mensagem direta será preenchida previamente com uma mensagem de boas-vindas e um link para conectar sua conta GitHub . Siga as instruções na tela no Slack e, em GitHub no seu navegador, para autenticar e autorizar a conexão.
Depois que sua conta GitHub estiver conectada, o Slack mostrará uma lista de comandos e recursos disponíveis que você pode usar.
Usando comandos de barra 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 aplicativo GitHub 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. |
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 sessões Agente de codificação do Copilot no Slack
O aplicativo GitHub também integra Agente de codificação do Copilot ao Slack. Você pode usar essa funcionalidade para invocar Agente de codificação do Copilot em tópicos onde discussões importantes estão ocorrendo e pedir que ele faça alterações com base no contexto dessas discussões. Consulte: Integrando o agente de codificação do Copilot 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 conta GitHub por meio do aplicativo GitHub no Slack. Isso permite que GitHub mapeie sua identidade do Slack para sua identidade GitHub . Consulte Conectar sua conta GitHub ao aplicativo GitHub no Slack.
Observação
Se você tiver vários espaços de trabalho do Slack em que usa o aplicativo GitHub, as menções só funcionarão no espaço de trabalho em que você entrou no aplicativo GitHub mais recentemente. Se você fizer login no aplicativo GitHub 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 das suas menções GitHub no modo de exibiçã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"
Desdobrando links para atividades do GitHub no Slack
As visualizações de link fornecem contexto adicional ao compartilhar links para as atividades GitHub no Slack. As pré-visualizações de links são exibidas no Slack para as seguintes atividades GitHub:
- 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 conta GitHub ao aplicativo GitHub no Slack.
- Foi solicitado que não fossem exibidas pré-visualizações de links quando solicitado.
- O aplicativo GitHub não está no canal em que o link é compartilhado. Consulte Usar 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. Lembretes podem ser enviados diretamente em uma mensagem direta com o aplicativo GitHub ou para um canal em que 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 notificações GitHub no Slack para atender às suas necessidades. -
[AUTOTITLE](/integrations/tutorials/slack) - Crie habilidades e conhecimento sobre a integração GitHub Slack por meio de exemplos e atividades práticas.