Personalizando notificações para GitHub no Teams

Você pode personalizar suas notificações assinando atividades que são relevantes para o seu canal do Microsoft Teams e desinscrevendo-se de atividades menos úteis para o seu projeto.

Notificações habilitadas por padrão

As notificações a seguir são habilitadas por padrão, mas você pode desabilitar qualquer uma delas usando o comando @GitHub unsubscribe OWNER/REPO [FEATURE].

Notificações desabilitadas por padrão

As notificações a seguir são desabilitadas por padrão, mas você pode habilitar qualquer uma delas usando o comando @GitHub subscribe owner/repo [FEATURE].

Você pode assinar ou cancelar a assinatura de várias configurações ao mesmo tempo. Por exemplo:

• Para ativar a atividade de avaliações e comentários de solicitações pull, use @GitHub subscribe OWNER/REPO reviews comments.
• Para desativar a atividade de problemas e solicitações pull, use @GitHub unsubscribe OWNER/REPO issues pulls.

Filtrando notificações

Você pode personalizar ainda mais suas notificações com filtros de branch e etiqueta. Os filtros de ramificação permitem filtrar as notificações de confirmações com base nos nomes das ramificações, enquanto os filtros de rótulo permitem filtrar as notificações de problemas e solicitações pull com base nos rótulos aplicados a elas.

Filtros de ramificação para notificações de confirmação

Os filtros de ramificação permitem filtrar as notificações de confirmação com base nos nomes das ramificações. Por padrão, ao se inscrever no evento commits, você receberá notificações para sua ramificação padrão. No entanto, você pode optar por filtrar por uma ramificação específica, um padrão de ramificações ou todas as ramificações.

Você pode cancelar a assinatura do recurso commits usando @GitHub unsubscribe OWNER/REPO commits.

Filtros de rótulos para notificações de problemas e solicitações pull

Os filtros de rótulo permitem filtrar notificações com base em rótulos aplicados a problemas e solicitações de pull. Quando um filtro de rótulo é definido, somente notificações para eventos, incluindo o rótulo especificado, serão enviadas. Para obter mais informações sobre rótulos, consulte Gerenciar etiquetas e Filtrando e pesquisando problemas e pull requests.

Atualmente, só é possível ter um filtro de rótulo necessário por repositório. A tabela abaixo mostra quais tipos de evento são afetados por filtros de rótulo.

Criando filtros de rótulo

Para criar um filtro de rótulo, use o seguinte formato de comando:

@GitHub subscribe [OWNER/REPO] +label:"YOUR-LABEL"

@GitHub subscribe [OWNER/REPO] +label:"YOUR-LABEL"

Isso cria um filtro de rótulo obrigatório com o valor YOUR-LABEL. Os eventos de entrada que dão suporte a filtros são descartados, a menos que tenham esse rótulo.

Atualizando filtros de rótulo

Você pode atualizar um filtro de rótulo existente especificando um valor NEW-LABEL:

@GitHub subscribe [OWNER/REPO] +label:"NEW-LABEL"

@GitHub subscribe [OWNER/REPO] +label:"NEW-LABEL"

Isso substituirá o filtro "YOUR-LABEL" pelo filtro "NEW-LABEL".

Removendo filtros de rótulo

Você pode remover um filtro de rótulo existente usando o comando cancelar assinatura com a opção +label :

@GitHub unsubscribe [OWNER/REPO] +label:"NEW-LABEL"

@GitHub unsubscribe [OWNER/REPO] +label:"NEW-LABEL"

Isso removerá o filtro "NEW-LABEL" e o canal receberá todas as notificações para os eventos assinados sem nenhuma filtragem de rótulo.

Exibindo filtros de rótulo ativos

Para exibir os filtros de rótulo atualmente ativos para um canal, use o seguinte comando:

@GitHub subscribe list features

@GitHub subscribe list features

Filtros válidos

O aplicativo GitHub no Teams oferece suporte aos caracteres especiais mais comuns para filtros de rótulos, incluindo todos os emojis que o Teams e GitHub oferecem por padrão. Raramente, você pode encontrar um rótulo que contém um caractere especial que não tem suporte. Por exemplo, qualquer caractere multibyte não codificado como :foo:, ou rótulos usando o caractere , podem não funcionar conforme esperado.

GitHub Actions Notificações de fluxo de trabalho

Você pode assinar GitHub Actions as notificações de execução de fluxos de trabalho no seu canal ou app pessoal usando o recurso "workflows", no formato @GitHub subscribe OWNER/REPO workflows.

Quando você estiver inscrito em "fluxos de trabalho", a seguinte funcionalidade estará disponível:

• Você será notificado quando uma nova execução de fluxo de trabalho for disparada.
• Você pode acompanhar as notificações de aprovação como uma resposta no thread e aprovar as notificações diretamente do canal ou aplicativo pessoal.
• Depois que o fluxo de trabalho for concluído, você receberá uma atualização como uma resposta no thread para que possa ver o contexto completo e o histórico da execução do fluxo de trabalho.
• Se algo falhar, você pode optar por executar o workflow novamente no local e também pode habilitar logs de depuração, se necessário.

Filtros de notificação de fluxo de trabalho

Você pode filtrar notificações de fluxo de trabalho usando as seguintes opções:

Você pode configurar filtros de notificação de fluxo de trabalho com o seguinte formato:

@GitHub subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME" event:"WORKFLOW-EVENT" branch:"BRANCH-NAME" actor:"USERNAME"}

@GitHub subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME" event:"WORKFLOW-EVENT" branch:"BRANCH-NAME" actor:"USERNAME"}

Você também pode passar vários valores para cada filtro, separados por vírgulas. Por exemplo:

@GitHub subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME","ANOTHER-WORKFLOW-NAME" event:"WORKFLOW-EVENT","ANOTHER-WORKFLOW-EVENT" branch:"BRANCH-NAME","ANOTHER-BRANCH-NAME" actor:"USERNAME","ANOTHER-USERNAME"}

@GitHub subscribe OWNER/REPO workflows:{name:"YOUR-WORKFLOW-NAME","ANOTHER-WORKFLOW-NAME" event:"WORKFLOW-EVENT","ANOTHER-WORKFLOW-EVENT" branch:"BRANCH-NAME","ANOTHER-BRANCH-NAME" actor:"USERNAME","ANOTHER-USERNAME"}

Por padrão, quando você configura as notificações de fluxo de trabalho sem aplicar filtros, elas são configuradas para fluxos de trabalho disparados por meio de solicitações pull request direcionadas ao seu branch padrão. Você pode inserir uma ou várias entradas.

Você pode cancelar a assinatura de notificações de fluxo de trabalho usando o comando: @GitHub unsubscribe OWNER/REPO workflows.

Notificações de implantação

Você também pode configurar notificações de implantação separadas. Essas implantações podem ocorrer a partir de GitHub Actions ou de fontes externas por meio da API de implantações. Confira Pontos de extremidade da API REST para implantações.

Você pode assinar ou cancelar a assinatura de notificações de implantação usando os seguintes comandos:

@GitHub subscribe OWNER/REPO deployments
@GitHub unsubscribe OWNER/REPO deployments

@GitHub subscribe OWNER/REPO deployments
@GitHub unsubscribe OWNER/REPO deployments