# Notificações

URL: /triar/notificacoes

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 | Email |
| --- | --- | --- |
| **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 [#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 [#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".

<Figure src="/images/notifications-list.png" alt="Lista de notificações com atribuições e uma menção não lidas" caption="Atribuições e menções não lidas." />

## Emails de notificação [#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 [#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 [#para-quem-administra-a-instância]

O canal depende de duas variáveis do server:

- `MIRA_RESEND_API_KEY`: chave da API do [Resend](https://resend.com). Sem ela o canal fica desligado e as notificações aparecem só no sino.
- `MIRA_EMAIL_FROM`: remetente, como `mira@exemplo.com` ou `Mira <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.

## Próximos passos [#próximos-passos]

- [Comentários](/triar/comentarios)
- [Resumo e digest](/triar/resumo)
