Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Configurar notificações

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

Neste artigo

Esse documento ajudou você?

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.

Opções de entrega de notificação

Você tem três opções básicas para a entrega de notificação:

  • a caixa de entrada de notificações em GitHub
  • a caixa de entrada de notificações em GitHub para dispositivos móveis, que sincroniza com a caixa de entrada em GitHub
  • um cliente de e-mail que usa um endereço de e-mail verificado, que também pode sincronizar com a caixa de entrada de GitHub e GitHub para dispositivos móveis

Para usar a caixa de entrada de notificações no GitHub e no GitHub para dispositivos móveis, você precisa habilitar notificações web e móveis nas suas configurações de notificação. Para obter mais informações, consulte "Escolhendo suas configurações de notificação".

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 essa sincronização, seu cliente de e-mail deve ser capaz de ver imagens de 'notifications@github.com'.

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

A caixa de entrada de notificações em GitHub e GitHub para dispositivos móveis inclui opções de triagem projetadas especificamente para o seu fluxo de notificações de GitHub e inclui 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 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

Além disso, a caixa de entrada de notificações em GitHub para dispositivos móveis permite que você faça triagem de notificações no modo escuro e receba notificações push para menções diretas. Para obter mais informações, consulte "Habilitar notificações push com GitHub para celular" ou "GitHub para celular".

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. Suas notificações na caixa de entrada só serão mantidas por 5 meses, 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 ver os repositórios que você está inspecionando, consulte https://github.com/watching. Para obter mais informações, consulte "Gerenciando assinaturas e notificações do GitHub".

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 participando, você pode escolher se deseja receber notificações por e-mail ou através da caixa de entrada em GitHub e GitHub para dispositivos móveis.

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 permite assistir ou participar de notificações da web e móvel, 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 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. 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.

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 essa sincronização, o cliente de e-mail deve ser capaz de visualizar imagens de 'notifications@github. om'.

Se estiver usando o Gmail, você poderá clicar em um botão junto ao e-mail de notificação para acessar o problema ou a pull request original que gerou a notificação.

Botões no Gmail

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 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, também é possível enviar notificações para diferentes endereços de e-mail para repositórios específicos. Por exemplo, você pode enviar notificações para um repositório público específico para um endereço de e-mail pessoal verificado. 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 “Escolhendo para onde as notificações de e-mail de sua organização serão enviadas".

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

Se uma organização da qual você é integrante restringe as notificações de e-mail para um domínio de e-mail aprovado, você precisará verificar um endereço de e-mail nesse domínio para receber notificações sobre a atividade na organização. Para obter mais informações, consulte "Restringir notificações de e-mail a um domínio aprovado."

Filtrar notificações de e-mail

Cada notificação de e-mail que o GitHub 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 ou determinados tipos de notificação do GitHub.

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 contêm as seguintes informações de header:

HeaderInformações
Endereço do remetenteEste endereço será sempre 'notifications@github. om'.
Campo ToEsse campo conecta-se diretamente ao thread. Se você responder ao e-mail, será adicionado um novo comentário à conversa.
Endereço de CcO GitHub 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 é @noreply.github.com. 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>.github.com.
campo X-GitHub-SeverityNotificações de e-mail para Alertas GitHub 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 GitHub Dependabot. 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.

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.

Se uma organização da qual você é integrante restringe as notificações de e-mail para um domínio de e-mail aprovado, você precisará verificar um endereço de e-mail nesse domínio para receber notificações sobre a atividade na organização. Para obter mais informações, consulte "Restringir notificações de e-mail a um domínio aprovado."

  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 seus endereços de e-mail verificados. Para obter mais informações, consulte "verificar o seu endereço de e-mail".

  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 Alertas GitHub Dependabot

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

Por padrão, você receberá Alertas GitHub Dependabot:

  • by email, an email is sent every time a vulnerability is found (Email each time a vulnerability is found option)
  • in the user interface, as warnings in your repository's file and code views (UI alerts option)
  • on the command line, as warnings that are displayed as callbacks when you push to repositories with vulnerabilities (Command Line option)
  • in your inbox, as web notifications (Web option) You can customize the way you are notified about

Alertas GitHub Dependabot. For example, you can receive a weekly digest email summarizing alerts for up to 10 of your repositories using the Email a digest summary of vulnerabilities and Weekly security email digest options.

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 GitHub Dependabot, consulte "Configurar notificações para dependências vulneráveis".

Opções de notificação GitHub Actions

Escolha como você deseja receber atualizações de execução de fluxo de trabalho para repositórios que você está inspecionando que estão configurados com o GitHub Actions. Você também pode optar por receber apenas notificações de execução de fluxo de trabalho falha.

Opções de alertas Dependabot

Habilitando notificações push com GitHub para dispositivos móveis

Quando você instalar GitHub para dispositivos móveis, você será automaticamente incluído em notificações da web. Você poderá então ativar notificações push para menções diretas no app.

Você só pode receber notificações de pushes para repositórios no GitHub para dispositivos móveis neste momento.

Habilitando notificações push com GitHub para iOS

  1. Acima de "Home", clique na foto do seu perfil.
  2. Para ver suas configurações, clique em .
    Ícone de configurações para GitHub para iOS
  3. Para atualizar suas configurações de notificação, clique em Notificações push.
  4. Para ativar as notificações push para menções diretas, use a alternância Menções Diretas.

Habilitando notificações push com GitHub para Android

  1. Acima de "Home", clique na foto do seu perfil.
  2. Para ver suas configurações, clique em .
    Ícone de configurações para GitHub para iOS
  3. Para ativar as notificações push para menções diretas, use a alternância Menções Diretas.

Esse documento ajudou você?

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.