Esta versão do GitHub Enterprise foi descontinuada em 2021-06-09. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Configurar notificações

Escolha o tipo de atividade no GitHub Enterprise Server do qual você deseja receber notificações e a forma como deseja que essas atualizações sejam entregues.

Observação: GitHub para dispositivos móveis está atualmente em beta para GitHub Enterprise Server 3.0 e sujeito a alteração.

Opções de entrega de notificação

Você pode receber notificações de atividades em GitHub Enterprise Server nos locais a seguir.

  • Caixa de entrada de notificações na interface web de GitHub Enterprise Server
  • Um cliente de e-mail que usa um endereço de e-mail verificado que também pode sincronizar com a caixa de entrada em GitHub Enterprise Server

Dica: se você receber notificações da web e por e-mail, você pode sincronizar automaticamente o status lido ou não lido da notificação para que as notificações da web sejam automaticamente marcadas como lidas depois de ler a notificação de e-mail correspondente. Para habilitar esta sincronização, o cliente de e-mail deve poder ver imagens de o endereço de e-mail no-reply para sua instância do GitHub Enterprise Server, configurado pelo administrador do seu site.

Benefícios da caixa de entrada de notificações

A caixa de entrada de notificações em GitHub Enterprise Server inclui opções de triagem projetadas especificamente para o seu fluxo de notificações de GitHub Enterprise Server incluindo opções para:

  • Fazer triagem de várias notificações ao mesmo tempo.
  • Marcar as notificações concluídas como Concluído e removê-las da sua caixa de entrada. Para ver todas as suas notificações marcadas como Concluído, use a consulta is:done.
  • Salvar uma notificação para revisar mais tarde. As notificações salvas são sinalizadas na sua caixa de entrada e mantidas indefinidamente. Para visualizar todas as suas notificações salvas, use a consulta is:saved.
  • Cancelar inscrição e remover uma notificação da sua caixa de entrada.
  • Visualizar o problema, a pull request ou uma discussão em equipe onde a notificação se origina no GitHub Enterprise Server de dentro da caixa de entrada de notificações.
  • Ver uma das últimas razões pelas quais você está recebendo uma notificação de sua caixa de entrada com uma etiqueta razões.
  • Criar filtros personalizados para focar em notificações diferentes quando quiser.
  • Notificações em grupo em sua caixa de entrada por repositório ou data para obter uma visão geral rápida com menos comutação de contexto

Benefícios da utilização de um cliente de e-mail para notificações

Um benefício de usar um cliente de e-mail é que todas as suas notificações podem ser mantidas indefinidamente, dependendo da capacidade de armazenamento do seu cliente de e-mail. As suas notificações na caixa de entrada só são mantidas por 5 meses em GitHub a menos que você as tenha marcado como Salvas. As notificações Saved (Salvas) são mantidas indefinidamente. Para obter mais informações sobre a política de retenção da sua caixa de entrada, consulte "Sobre notificações".

O envio de notificações para o cliente de e-mail também permite que você personalize sua caixa de entrada de acordo com as configurações do cliente de e-mail que pode incluir etiquetas personalizadas ou codificadas por cores.

As notificações de e-mail também permitem flexibilidade com os tipos de notificações que você recebe e permitem que você escolha diferentes endereços de e-mail para atualizações. Por exemplo, você pode enviar determinadas notificações para um repositório para um endereço de e-mail pessoal verificado. Para obter mais informações, sobre suas opções de personalização de e-mail, consulte "Personalizando suas notificações de e-mail."

Sobre notificações de participação e inspeção

Quando você inspeciona um repositório, você assina atualizações de atividade nesse repositório. Da mesma forma, quando você inspeciona as discussões de uma equipe específica, você está inscrito em todas as atualizações de conversa na página daquela equipe. Para obter mais informações, consulte "Sobre discussões de equipe".

Para ver repositórios que você está inspecionando, acesse a sua página de inspeção. Para obter mais informações, consulte "Gerenciando assinaturas e notificações do GitHub".

Configurar notificações

É possível configurar as notificações para um repositório na página do repositório ou na página de inspeção. Você pode optar por receber apenas notificações de versões em um repositório ou ignorar todas as notificações de um repositório.

Para obter mais informações, consulte "Definir as suas configurações de inspeção para um repositório individual" abaixo.

Participar de conversas

A qualquer momento que você comentar em uma conversa ou quando alguém @mencionar seu nome de usuário, você estará participando de uma conversa. Por padrão, você é inscrito automaticamente em uma conversa ao participar dela. Você pode cancelar manualmente a inscrição de uma conversa que você participou, clicando em Cancelar inscrição no problema ou na pull request ou através da opção Cancelar inscrição na caixa de entrada de notificações.

Para conversas que você está inspecionando ou das quais você está participando, você pode escolher se deseja receber notificações por e-mail ou por meio da caixa de entrada em GitHub Enterprise Server.

Opções de notificações de participação e inspeção

Por exemplo:

  • Se você não quiser que as notificações sejam enviadas para o seu e-mail, desmarque e-mail para participar e inspecionar as notificações.
  • Se quiser receber notificações por e-mail quando você participou de uma conversa, então selecione e-mail abaixo de "Participar".

Se você não habilitar notificações de inspeção ou participação para a web, a sua caixa de entrada de notificações não terá nenhuma atualização.

Personalizando suas notificações por e-mail

Após habilitar as notificações de e-mail, o GitHub Enterprise Server enviará notificações a você como e-mails em diversas partes que contêm cópias do conteúdo em HTML e texto sem formatação. O conteúdo da notificação de e-mail inclui markdown, @menção, emojis, links por hash e muito mais, que aparecem no conteúdo original do GitHub Enterprise Server. Se você quiser ver apenas o texto do e-mail, configure o cliente de e-mail para exibir apenas a cópia do texto sem formatação.

Observação: Você só receberá notificações por e-mail se o suporte a e-mails de saída estiver habilitado em sua instância do GitHub Enterprise Server. Para mais informações, entre em contato com o administrador do site.

Dica: se você receber notificações da web e por e-mail, você pode sincronizar automaticamente o status lido ou não lido da notificação para que as notificações da web sejam automaticamente marcadas como lidas depois de ler a notificação de e-mail correspondente. Para habilitar esta sincronização, o cliente de e-mail deve poder ver imagens de o endereço de e-mail no-reply para sua instância do GitHub Enterprise Server, configurado pelo administrador do seu site.

Escolha um endereço de e-mail padrão para enviar atualizações de conversas que você está participando ou inspecionando. Você também pode especificar qual atividade no GitHub Enterprise Server você deseja receber atualizações usando seu endereço de e-mail padrão. Por exemplo, escolha se você quer atualizações do seu e-mail padrão de:

  • Comentários em problemas ou pull requests.
  • Revisões de pull request.
  • Pushes de pull request.
  • Suas próprias atualizações, como quando você abre, comenta ou encerra um problema ou uma pull request.

Dependendo da organização proprietária do repositório, você também pode enviar notificações para diferentes endereços de e-mail. Sua organização pode exigir que o endereço de e-mail seja verificado para um domínio específico. Para obter mais informações, consulte "Escolher onde as notificações de e-mail da sua organização são enviadas".

Você também pode enviar notificações de um repositório específico para um endereço de e-mail. Para obter mais informações, consulte "Sobre notificações de email para push no seu repositório".

Você receberá e-mails de notificação apenas se tiver optado por receber notificações por e-mail nas configurações de notificação.

Filtrar notificações de e-mail

Cada notificação de e-mail que o GitHub Enterprise Server envia contém informações de header. As informações de header em cada e-mail são consistentes, de modo que é possível usá-las no cliente de e-mail para filtrar ou encaminhar todas as notificações do GitHub Enterprise Server ou determinados tipos de notificação do GitHub Enterprise Server.

Se você acredita que está recebendo notificações que não pertencem a você, examine os headers X-GitHub-Recipient e X-GitHub-Recipient-Address. Estes headers mostram quem é o destinatário pretendido. Dependendo de sua configuração de e-mail, você pode receber notificações destinadas a outro usuário.

As notificações de e-mail do GitHub Enterprise Server contêm as seguintes informações de header:

HeaderInformações
Endereço do remetenteEste endereço será sempre 'endereço de e-mail de não responda configurado pelo administrador do site'.
Campo ToEste campo conecta-se diretamente à corrente. Se você responder ao e-mail, você adicionará um novo comentário na conversa.
Endereço de CcO GitHub Enterprise Server colocará você em cópia (Cc) se você estiver inscrito para uma conversa. O segundo endereço de e-mail de Cc corresponde ao motivo da notificação. O sufixo para esses motivos de notificação é com base no endereço de e-mail do tipo no-reply configurado pelo seu administrador do site. Os possíveis motivos de notificação são:
  • 'assign': você foi atribuído a um problema ou uma pull request.
  • 'author': você criou um problema ou uma pull request.
  • 'comment': você comentou um problema ou uma pull request.
  • 'manual': houve uma atualização em um problema ou uma pull request para o(a) qual você assinou manualmente.
  • 'mention': você foi mencionado em um problema ou uma pull request.
  • 'push': alguém fez commit em uma pull request que você assinou.
  • 'review_requested': você ou uma equipe da qual faz você faz parte foi solicitado para revisar uma pull request.
  • 'security_alert': o GitHub detectou uma vulnerabilidade em um repositório para o qual você recebe alertas de segurança.
  • 'state_change': um problema ou uma pull request que você assinou foi fechado(a) ou aberto(a).
  • 'subscribed': houve uma atualização em um repositório que você está inspecionando.
  • 'team_mention': uma equipe a qual você pertence foi mencionada em um problema ou uma pull request.
  • 'your_activity': você abriu, comentou ou fechou um problema ou uma pull request.
campo mailing listEsse campo identifica o nome do repositório e seu proprietário. O formato desse endereço é sempre <nome do repositório>.<proprietário do repositório>.[hostname].
campo X-GitHub-SeverityNotificações de e-mail para Alertas do Dependabot que afetam um ou mais repositórios incluem o campo do cabeçalho X-GitHub-Severity. Você pode usar o valor do campo de cabeçalho X-GitHub-Severity para filtrar notificações de e-mail para alertas de segurança. Os níveis possíveis de gravidade são:
  • low
  • moderate
  • high
  • critical
Para obter mais informações, consulte "Sobre alertas para dependências vulneráveis"

Escolhendo suas configurações de notificação

  1. No canto superior direito de qualquer página, clique em . Notificação indicando qualquer mensagem não lida
  2. Na barra lateral esquerda, na lista de repositórios, use a caixa de seleção "Gerenciar notificações" para clicar em Configurações de notificação. Gerenciar as opções do menu suspenso notificações
  3. Na página de configurações de notificações, escolha como receber notificações quando:

Inspeção automática

Por padrão, sempre que você obtiver acesso a um novo repositório, você começará a inspecionar aquele repositório automaticamente. Sempre que você entrar em uma nova equipe, você será automaticamente inscrito em atualizações e receberá notificações quando essa equipe for @mencionada. Se você não quiser ser automaticamente inscrito, você pode desmarcar as opções de inspeção automática.

Opções de inspeção automática

Se "Inspecionar repositórios automaticamente" estiver desativado, então você não inspecionará automaticamente seus próprios repositórios. É necessário navegar na página do seu repositório e escolher a opção de inspeção.

Configurando as configurações de inspeção para um repositório individual

É possível escolher se deseja inspecionar ou não inspecionar um repositório individual. Você também pode optar por ser notificado apenas de novas versões, ou ignorar completamente um repositório individual.

  1. No GitHub Enterprise Server, navegue até a página principal do repositório.

  2. No canto superior direito, clique no menu suspenso "Inspecionar" para selecionar uma opção de inspeção.

    Opções de inspeção em um menu suspenso para repositórios

Escolhendo para onde as notificações de e-mail da sua organização são enviadas

Se pertencer a uma organização, você poderá escolher a conta de e-mail em que deseja receber as notificações da atividade da organização. Por exemplo, se pertencer a uma organização para fins de trabalho, talvez você queira receber as notificações no seu endereço de e-mail profissional, e não no endereço pessoal.

Você receberá e-mails de notificação apenas se tiver optado por receber notificações por e-mail nas configurações de notificação.

  1. No canto superior direito de qualquer página, clique em . Notificação indicando qualquer mensagem não lida
  2. Na barra lateral esquerda, na lista de repositórios, use a caixa de seleção "Gerenciar notificações" para clicar em Configurações de notificação. Gerenciar as opções do menu suspenso notificações
  3. Em "Default notification email" (E-mail padrão de notificação), selecione o endereço de e-mail em que você quer receber as notificações.
    Menu suspenso de endereço de e-mail padrão de notificação
  4. Clique em Salvar.

Personalizar rotas de e-mail por organização

Se você for integrante de mais de uma organização, você poderá configurar cada uma para enviar notificações a qualquer um de o e-mail que você adicionou à sua conta de GitHub Enterprise Server.

  1. No canto superior direito de qualquer página, clique em . Notificação indicando qualquer mensagem não lida
  2. Na barra lateral esquerda, na lista de repositórios, use a caixa de seleção "Gerenciar notificações" para clicar em Configurações de notificação. Gerenciar as opções do menu suspenso notificações
  3. Na lista em "Custom routing" (Encaminhamento personalizado), localize o nome da sua organização.
    Lista de organizações e endereços de e-mail
  4. Clique em Edit (Editar) ao lado do endereço de e-mail que você pretende alterar. Editar endereços de e-mail da organização
  5. Selecione um dos seus endereços de e-mail verificados e clique em Save (Salvar).
    Alterar o endereço de e-mail por organização

Opções de notificação de alerta de segurança

You can choose the delivery method for notifications about security alerts on repositories that you are watching, as well as the frequency at which the notifications are sent to you.

Por padrão, se o administrador do site configurou o e-mail para notificações na sua instância, você receberá alertas de segurança:

  • por e-mail, um e-mail é enviado toda vez que uma vulnerabilidade é encontrada (opção de Enviar e-mail toda vez que uma vulnerabilidade é encontrada)
  • na interface do usuário, como avisos nos arquivos e visualizações de código do seu repositório (opção de alertas da interface do usuário)
  • na linha de comando, como avisos que são exibidos como retornos de chamada quando você faz push para repositórios com vulnerabilidades (opção de Linha de Comando)
  • na sua caixa de entrada, como notificações da web (opção de Web)

Você pode personalizar a forma como você é notificado sobre alertas de segurança. Por exemplo, você pode receber um e-mail semanal com o resumo dos alertas de até 10 de seus repositórios usando as opções Enviar e-mail com o resumo das vulnerabilidades e Resumo semanal por e-mail sobre segurança.

Para mais informações sobre os métodos de entrega de notificação disponíveis para você e aconselhamento sobre como otimizar as notificações para alertas de segurança, consulte "Configurar notificações para dependências vulneráveis".