# Notificações

> Como o Messajo avisa a sua equipe: sino, e-mail, quem recebe cada aviso, regras da organização, preferências de cada pessoa e banners.

O Messajo avisa a sua equipe quando algo precisa de atenção: uma conexão caiu, um template foi reprovado, um destino foi pausado, uma campanha parou. Cada aviso aparece no **sino** do painel e, quando o tipo pede, também chega por **e-mail**.

## Sino e página

O sino fica no topo do painel e mostra o número de avisos não lidos e os 20 mais recentes. Em cada aviso você pode marcar como lido ou não lido e limpar. **Ver todas** abre a página `Notificações`, com paginação, filtros por grupo, nível e leitura, seleção em massa e **Limpar todas**. O painel atualiza a cada 30 segundos e quando a aba volta ao foco. O seletor de organização mostra quantos avisos não lidos cada organização tem.

## Canais e níveis

- **Canais:** sino (`inbox`) e e-mail (`email`).
- **Níveis:** crítico (precisa de ação agora), atenção e informativo.

O texto do aviso sai no idioma de quem recebe.

## Quem recebe

A decisão tem quatro camadas, nesta ordem:

1. **Padrão do tipo**, por papel (tabela abaixo).
2. **Regra da organização** em `Configurações › Avisos`: dono e admin ligam ou desligam sino e e-mail por tipo e por papel.
3. **Preferência de cada pessoa** em `Minha conta › Avisos`: por organização, tipo e canal. Dá para voltar ao padrão.
4. **Avisos obrigatórios** não mudam por regra nem por preferência: segurança da conta (troca de senha, 2FA, e-mail, papel), exclusão da organização e pronto do export de dados chegam sempre.

## Tipos de aviso

| Tipo | Grupo | Nível | Quem recebe por padrão | Obrigatório |
|---|---|---|---|---|
| `connection.disconnected` | `connection` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.needs_reconnect` | `connection` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.restricted` | `connection` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.unrestricted` | `connection` | informativo | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.banned` | `connection` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.reinstated` | `connection` | informativo | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.scheduled_for_disable` | `connection` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.quality_changed` | `connection` | atenção | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.messaging_limit_changed` | `connection` | informativo | Dono: sino; Admin: sino |  |
| `connection.display_name_reviewed` | `connection` | informativo | Dono: sino + e-mail; Admin: sino + e-mail |  |
| `connection.account_review` | `connection` | atenção | Dono: sino + e-mail; Admin: sino + e-mail |  |
| `connection.account_alert` | `connection` | atenção | Dono: sino + e-mail; Admin: sino + e-mail |  |
| `connection.capability_changed` (ainda sem emissor) | `connection` | informativo | Dono: sino; Admin: sino |  |
| `connection.coex_unlinked` | `connection` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `connection.history_sync_stalled` | `connection` | atenção | Dono: sino; Admin: sino |  |
| `connection.token_expiring` | `connection` | atenção | Dono: sino + e-mail; Admin: sino + e-mail |  |
| `connection.page_role_lost` | `connection` | crítico | Dono: sino + e-mail; Admin: sino + e-mail |  |
| `connection.pin_required` | `connection` | atenção | Dono: sino + e-mail; Admin: sino + e-mail |  |
| `connection.created` | `connection` | informativo | Dono: sino; Admin: sino |  |
| `connection.reconnected` | `connection` | informativo | Dono: sino; Admin: sino |  |
| `template.approved` | `template` | informativo | Dono: sino; Admin: sino; Dev: sino |  |
| `template.rejected` | `template` | atenção | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino + e-mail |  |
| `template.paused` | `template` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino + e-mail |  |
| `template.disabled` | `template` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino + e-mail |  |
| `template.quality_changed` (ainda sem emissor) | `template` | atenção | Dono: sino; Admin: sino; Dev: sino |  |
| `template.category_changed` (ainda sem emissor) | `template` | atenção | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino + e-mail |  |
| `template.components_changed` (ainda sem emissor) | `template` | informativo | Dono: sino; Admin: sino; Dev: sino |  |
| `destination.paused` | `delivery` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino + e-mail |  |
| `destination.failure_rate_high` (ainda sem emissor) | `delivery` | atenção | Dono: sino; Admin: sino; Dev: sino |  |
| `destination.secret_rotated` | `delivery` | informativo | Dono: sino; Admin: sino |  |
| `flow.endpoint_unhealthy` | `flow` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino + e-mail |  |
| `flow.status_changed` | `flow` | informativo | Dono: sino; Admin: sino; Dev: sino |  |
| `campaign.completed` | `campaign` | informativo | Dono: sino; Admin: sino; Dev: sino |  |
| `campaign.auto_paused` | `campaign` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino + e-mail; quem o aviso cita: sino + e-mail |  |
| `campaign.paused_spend_cap` (ainda sem emissor) | `campaign` | crítico | Dono: sino + e-mail; Admin: sino + e-mail; Dev: sino |  |
| `cost.threshold_reached` (ainda sem emissor) | `cost` | atenção | Dono: sino + e-mail; Admin: sino + e-mail |  |
| `cost.reconciliation_diff` (ainda sem emissor) | `cost` | informativo | Dono: sino; Admin: sino |  |
| `group.suspended` | `groups_commerce` | atenção | Dono: sino; Admin: sino; Dev: sino |  |
| `order.received` | `groups_commerce` | informativo | ninguém |  |
| `publication.failed` | `publication` | atenção | Dono: sino; Admin: sino; Dev: sino |  |
| `org.standing_changed` (ainda sem emissor) | `org` | crítico | Dono: sino + e-mail; Admin: sino; Dev: sino; Leitura: sino | sim |
| `org.deletion_scheduled` | `org` | crítico | Dono: sino + e-mail; Admin: sino + e-mail | sim |
| `org.deletion_canceled` | `org` | informativo | Dono: sino + e-mail; Admin: sino + e-mail | sim |
| `billing.payment_failed` | `org` | crítico | Dono: sino + e-mail | sim |
| `billing.deletion_warning` | `org` | atenção | Dono: sino + e-mail | sim |
| `org.member_joined` | `org` | informativo | Dono: sino; Admin: sino |  |
| `org.member_left` | `org` | informativo | Dono: sino; Admin: sino |  |
| `org.api_keys_orphaned` | `org` | atenção | Dono: sino + e-mail; Admin: sino + e-mail |  |
| `org.api_key_expiring` | `org` | atenção | Dono: sino + e-mail; Admin: sino + e-mail; quem o aviso cita: sino + e-mail |  |
| `org.data_export_ready` | `org` | informativo | quem o aviso cita: sino + e-mail | sim |
| `org.retention_purged` (ainda sem emissor) | `org` | informativo | Dono: sino; Admin: sino |  |
| `security.password_changed` | `security` | crítico | quem o aviso cita: sino + e-mail | sim |
| `security.two_factor_changed` | `security` | crítico | quem o aviso cita: sino + e-mail | sim |
| `security.two_factor_reset` | `security` | crítico | quem o aviso cita: sino + e-mail | sim |
| `security.email_changed` | `security` | crítico | quem o aviso cita: sino + e-mail | sim |
| `security.new_device_login` (ainda sem emissor) | `security` | crítico | quem o aviso cita: sino + e-mail | sim |
| `security.role_changed` | `security` | crítico | quem o aviso cita: sino + e-mail | sim |
| `security.removed_from_org` | `security` | crítico | quem o aviso cita: sino + e-mail | sim |
| `instance.meta_signature_failing` (ainda sem emissor) | `instance` | crítico | quem o aviso cita: sino + e-mail | sim |
| `instance.queue_stalled` (ainda sem emissor) | `instance` | crítico | quem o aviso cita: sino + e-mail | sim |
| `instance.media_storage_down` (ainda sem emissor) | `instance` | crítico | quem o aviso cita: sino + e-mail | sim |
| `instance.rate_card_sync_failed` | `instance` | crítico | super-admins da instância: sino + e-mail | sim |

Os tipos marcados como "ainda sem emissor" já existem no catálogo e na matriz, mas nenhum evento os dispara nesta versão.

## Banners

Banner é **estado**, não aviso: aparece no topo do painel enquanto a condição vale e some sozinho quando ela passa. Hoje existem três: conexões que precisam de atenção (fora de `active`), exclusão da organização em andamento e conexões desconectadas por falta de pagamento depois que a organização volta ao normal (`connections_reconnect`, pede reconectar).

## Retenção e anti-spam

Os avisos ficam **90 dias**; depois um job diário apaga. Para não encher o sino, um mesmo assunto (por exemplo, a mesma conexão caindo pelo mesmo motivo) não repete aviso por **6 horas**.
