Notificações
Quando o Mira avisa você e onde ver os avisos.
O Mira avisa você no sino do dashboard e, se a instância tiver o canal ligado, também por email. Cinco eventos geram aviso:
| Aviso | Quando | |
|---|---|---|
| Menção | Alguém menciona você com @ num comentário | Imediato |
| Atribuição | Alguém atribui um report a você | Imediato |
| Comentário | Alguém comenta num report que você acompanha | Agrupado |
| Mudança de status | Alguém muda o status de um report que você acompanha | Agrupado |
| Ticket vinculado | Um ticket do Jira ou do GitHub é vinculado a um report que você acompanha | Agrupado |
Atribuir um report a si mesmo, limpar o responsável ou repetir a atribuição não gera aviso. Quem perde o acesso ao projeto, ou tem a conta desativada, deixa de receber avisos dele.
Quem recebe
Menção e atribuição vão para a pessoa mencionada ou atribuída. Comentário, mudança de status e ticket vinculado vão para quem acompanha o report. Você acompanha um report quando é:
- o autor do report;
- o responsável;
- alguém que já comentou nele ou foi mencionado nele.
Não há botão de seguir. Quem faz a ação nunca recebe o aviso dela: se você comenta, o aviso vai para os outros.
Ver os avisos
O botão Notificações, na barra lateral, mostra um badge com a quantidade de avisos não lidos. Um + indica que há mais uma página. O badge se atualiza a cada 30 segundos.
Abra a lista e clique numa notificação: ela fica lida e o report abre. Sem nada pendente, a lista diz "Tudo em dia".
Emails de notificação
Todo aviso aparece no sino. O email é um canal a mais e não substitui o sino.
- Menção e atribuição saem na hora.
- Comentário, mudança de status e ticket vinculado esperam cerca de 5 minutos. Os avisos do mesmo report nesse intervalo chegam num email só. Uma menção ou atribuição nesse período sai na hora, num email à parte, e não antecipa os avisos que esperam.
O email traz quem agiu, o tipo do evento, o título e o número do report, um trecho de cerca de 200 caracteres do comentário e o botão Abrir report, que leva ao Mira. Segredos que apareçam no trecho são mascarados. O email nunca leva evidências, console, rede nem screenshots. O idioma é o padrão da instância.
O Mira só envia emails de eventos novos. Avisos anteriores à ativação do canal ficam apenas no sino.
Desativar os emails
Abra o menu do perfil, na barra lateral, e desligue Notificações por email. A preferência vale para todos os projetos, e quem já tinha conta começa com ela ligada. Os avisos continuam no sino.
Todo email também tem o link Desativar os emails de notificação. Ele abre uma página de confirmação que funciona sem login, e o botão Desativar emails aplica a mudança. Clientes de email que mostram a opção de cancelar a inscrição usam o mesmo caminho pelos cabeçalhos List-Unsubscribe, com um clique. Para religar, use o menu do perfil.
Para quem administra a instância
O canal depende de duas variáveis do server:
MIRA_RESEND_API_KEY: chave da API do Resend. Sem ela o canal fica desligado e as notificações aparecem só no sino.MIRA_EMAIL_FROM: remetente, comomira@exemplo.comouMira <mira@exemplo.com>. É obrigatório quando a chave existe, e o server não inicia sem ele.
O domínio do remetente precisa estar verificado no Resend, senão o Resend recusa o envio. Os links dos emails usam MIRA_PUBLIC_URL, então ela deve apontar para o endereço que as pessoas abrem. O Mira repete o envio até 3 vezes quando o Resend responde com erro de limite ou de servidor. Outros erros marcam a entrega como falha, sem nova tentativa, e não afetam o comentário, a atribuição ou o sino.
O Mira ainda não trata devolução (bounce) nem reclamação de spam. Acompanhe esses casos no painel do Resend.