Notificações

O Archyl avisa você de duas formas, e cada uma responde a uma pergunta diferente.

  • A caixa de entrada, atrás do sino no cabeçalho do aplicativo, reúne o que espera por você ou o que responde a algo que você fez. Ela está ativa para todos e não exige configuração.
  • As notificações por e-mail informam sobre as mudanças de arquitetura em toda a sua organização. Elas ficam desativadas até você ativá-las.

Para um resumo recorrente enviado a uma equipe inteira, veja o resumo da equipe. Para enviar eventos aos seus próprios sistemas, veja os webhooks.

A caixa de entrada

A caixa de entrada aberta sob o sino, com três notificações

O sino fica na extremidade direita do cabeçalho, em todas as páginas. O número sobre ele é a sua contagem de notificações não lidas.

Clique no sino para abrir a caixa de entrada. Cada linha mostra:

  • uma frase dizendo quem fez o quê;
  • um trecho: a pergunta feita por um agente, o comentário deixado por um revisor, a resposta que alguém escreveu;
  • o projeto e há quanto tempo aconteceu.

As linhas não lidas têm um ponto. Clicar em uma linha a marca como lida e abre a página a que ela se refere. Para limpar linhas sem abri-las, passe o mouse sobre uma delas e clique em Marcar como lida, ou use Marcar tudo como lido no topo do painel.

O que envia uma notificação

A caixa de entrada não é um feed de atividade. Uma notificação só é criada quando algo fica bloqueado até você agir, ou quando responde a algo que você iniciou.

As execuções gerenciadas de agentes notificam a pessoa que iniciou a execução.

O que aconteceu O que você fica sabendo
O agente faz uma pergunta ou propõe um plano para aprovação Um agente aguarda sua resposta
A execução terminou Sua execução de agente terminou
A execução falhou Sua execução de agente falhou, com o erro

Uma execução cancelada por alguém não envia nada.

As solicitações de mudança de arquitetura notificam os revisores e, depois, o autor.

O que aconteceu Quem é avisado
Uma solicitação de mudança é aberta Todas as pessoas que podem editar o projeto, exceto o autor
Um revisor a aprova, pede alterações ou a revisa com um comentário O autor
Ela é mesclada ou fechada O autor

As discussões notificam sobre respostas. Uma resposta chega à pessoa que iniciou a discussão e a todas as que já responderam nela.

As menções avisam as pessoas que você nomeia. Digite @ em um comentário, uma decisão, uma página de documentação, uma solicitação de mudança ou uma revisão para escolher uma pessoa ou uma equipe; todos os nomeados são avisados, e uma equipe alcança seus membros que podem abrir o projeto. Só é possível mencionar quem pode abrir o projeto. Veja Menções, citações e links.

O recurso Seguir avisa você sobre o que você segue: alterações em um elemento, uma decisão ou um projeto, novos comentários neles e solicitações de mudança que os afetam. Os proprietários seguem seus elementos automaticamente. Veja Seguir.

As tarefas avisam o responsável quando um comentário é transformado em tarefa para ele, e a pessoa que criou uma tarefa quando outra pessoa a conclui. Veja Tarefas.

Você nunca é notificado sobre as suas próprias ações.

A aba A fazer

Ao lado de Notificações, a aba A fazer lista as tarefas atribuídas a você, começando pelas de prazo mais próximo. O número na aba é a sua contagem de tarefas abertas. Marque uma tarefa para concluí-la, ou clique nela para abrir a discussão.

Como ela se comporta

  • Uma caixa de entrada por organização. Se você pertence a várias, o sino mostra a da organização em que você está trabalhando.
  • O seu idioma. A frase de cada linha segue o idioma da sua interface. Os trechos permanecem no idioma em que foram escritos.
  • Atualização. A contagem de não lidas é atualizada a cada 30 segundos e quando você volta para a aba, então uma nova notificação pode levar até meio minuto para aparecer.

Limites atuais

  • Uma solicitação de mudança aberta por um agente pelo servidor MCP ainda não notifica os revisores.
  • Você não pode desativar um tipo específico de notificação.
  • Menções, itens seguidos e tarefas notificam só na caixa de entrada, não por e-mail.

Notificações por e-mail

As notificações por e-mail cobrem o quadro geral: cada mudança rastreada na sua organização, como um sistema criado, um ADR atualizado, uma release implantada ou uma solicitação de mudança mesclada. Cada pessoa escolhe se quer recebê-las.

Para ativá-las:

  1. Abra o seu perfil pelo menu do usuário.
  2. Vá para a aba Notificações.
  3. Ative Notificações por email.
  4. Se quiser, restrinja o que você recebe:
    • Tipos de eventos: deixe vazio para receber todos os eventos, ou escolha os que interessam a você.
    • Projetos: deixe vazio para cobrir todos os projetos, ou escolha alguns específicos.
  5. Clique em Salvar.

Assim como a caixa de entrada, as notificações por e-mail ignoram as suas próprias ações: você não recebe e-mail sobre uma mudança que você mesmo fez.

Qual devo usar?

Você quer Use
Saber quando um agente, uma revisão ou uma resposta espera por você A caixa de entrada
Acompanhar cada mudança feita em determinados projetos As notificações por e-mail, filtradas por esses projetos
Dar a uma equipe um resumo regular sem que ninguém precise fazer login O resumo da equipe
Publicar mudanças em um canal ou acionar a sua própria automação Os webhooks
Fazer perguntas sobre a arquitetura pelo chat Os bots do Slack e Teams