# Notificaciones

> Cómo Messajo avisa a tu equipo: campana, correo, quién recibe cada aviso, reglas de la organización, preferencias de cada persona y banners.

Messajo avisa a tu equipo cuando algo necesita atención: una conexión se cayó, una plantilla fue rechazada, un destino se pausó, una campaña se detuvo. Cada aviso aparece en la **campana** del panel y, cuando el tipo lo pide, también llega por **correo**.

## Campana y página

La campana está en la parte superior del panel y muestra los avisos sin leer y los 20 más recientes. En cada aviso puedes marcarlo como leído o no leído y limpiarlo. **Ver todas** abre la página `Notificaciones`, con paginación, filtros por grupo, nivel y lectura, selección masiva y **Limpiar todas**. El panel se actualiza cada 30 segundos y cuando la pestaña vuelve al foco. El selector de organización muestra cuántos avisos sin leer tiene cada organización.

## Canales y niveles

- **Canales:** campana (`inbox`) y correo (`email`).
- **Niveles:** crítico (requiere acción ahora), atención e informativo.

El texto del aviso sale en el idioma de quien lo recibe.

## Quién recibe

La decisión tiene cuatro capas, en este orden:

1. **Valor por defecto del tipo**, por rol (tabla abajo).
2. **Regla de la organización** en `Configuración › Avisos`: dueño y admin activan o desactivan campana y correo por tipo y por rol.
3. **Preferencia de cada persona** en `Mi cuenta › Avisos`: por organización, tipo y canal. Se puede volver al valor por defecto.
4. **Avisos obligatorios** no cambian por regla ni preferencia: seguridad de la cuenta (contraseña, 2FA, correo, rol), eliminación de la organización y export de datos listo llegan siempre.

## Tipos de aviso

| Tipo | Grupo | Nivel | Quién recibe por defecto | Obligatorio |
|---|---|---|---|---|
| `connection.disconnected` | `connection` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.needs_reconnect` | `connection` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.restricted` | `connection` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.unrestricted` | `connection` | informativo | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.banned` | `connection` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.reinstated` | `connection` | informativo | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.scheduled_for_disable` | `connection` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.quality_changed` | `connection` | atención | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.messaging_limit_changed` | `connection` | informativo | Dueño: campana; Admin: campana |  |
| `connection.display_name_reviewed` | `connection` | informativo | Dueño: campana + correo; Admin: campana + correo |  |
| `connection.account_review` | `connection` | atención | Dueño: campana + correo; Admin: campana + correo |  |
| `connection.account_alert` | `connection` | atención | Dueño: campana + correo; Admin: campana + correo |  |
| `connection.capability_changed` (aún sin emisor) | `connection` | informativo | Dueño: campana; Admin: campana |  |
| `connection.coex_unlinked` | `connection` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `connection.history_sync_stalled` | `connection` | atención | Dueño: campana; Admin: campana |  |
| `connection.token_expiring` | `connection` | atención | Dueño: campana + correo; Admin: campana + correo |  |
| `connection.page_role_lost` | `connection` | crítico | Dueño: campana + correo; Admin: campana + correo |  |
| `connection.pin_required` | `connection` | atención | Dueño: campana + correo; Admin: campana + correo |  |
| `connection.created` | `connection` | informativo | Dueño: campana; Admin: campana |  |
| `connection.reconnected` | `connection` | informativo | Dueño: campana; Admin: campana |  |
| `template.approved` | `template` | informativo | Dueño: campana; Admin: campana; Dev: campana |  |
| `template.rejected` | `template` | atención | Dueño: campana + correo; Admin: campana + correo; Dev: campana + correo |  |
| `template.paused` | `template` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana + correo |  |
| `template.disabled` | `template` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana + correo |  |
| `template.quality_changed` (aún sin emisor) | `template` | atención | Dueño: campana; Admin: campana; Dev: campana |  |
| `template.category_changed` (aún sin emisor) | `template` | atención | Dueño: campana + correo; Admin: campana + correo; Dev: campana + correo |  |
| `template.components_changed` (aún sin emisor) | `template` | informativo | Dueño: campana; Admin: campana; Dev: campana |  |
| `destination.paused` | `delivery` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana + correo |  |
| `destination.failure_rate_high` (aún sin emisor) | `delivery` | atención | Dueño: campana; Admin: campana; Dev: campana |  |
| `destination.secret_rotated` | `delivery` | informativo | Dueño: campana; Admin: campana |  |
| `flow.endpoint_unhealthy` | `flow` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana + correo |  |
| `flow.status_changed` | `flow` | informativo | Dueño: campana; Admin: campana; Dev: campana |  |
| `campaign.completed` | `campaign` | informativo | Dueño: campana; Admin: campana; Dev: campana |  |
| `campaign.auto_paused` | `campaign` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana + correo; la persona citada: campana + correo |  |
| `campaign.paused_spend_cap` (aún sin emisor) | `campaign` | crítico | Dueño: campana + correo; Admin: campana + correo; Dev: campana |  |
| `cost.threshold_reached` (aún sin emisor) | `cost` | atención | Dueño: campana + correo; Admin: campana + correo |  |
| `cost.reconciliation_diff` (aún sin emisor) | `cost` | informativo | Dueño: campana; Admin: campana |  |
| `group.suspended` | `groups_commerce` | atención | Dueño: campana; Admin: campana; Dev: campana |  |
| `order.received` | `groups_commerce` | informativo | nadie |  |
| `publication.failed` | `publication` | atención | Dueño: campana; Admin: campana; Dev: campana |  |
| `org.standing_changed` (aún sin emisor) | `org` | crítico | Dueño: campana + correo; Admin: campana; Dev: campana; Lectura: campana | sí |
| `org.deletion_scheduled` | `org` | crítico | Dueño: campana + correo; Admin: campana + correo | sí |
| `org.deletion_canceled` | `org` | informativo | Dueño: campana + correo; Admin: campana + correo | sí |
| `billing.payment_failed` | `org` | crítico | Dueño: campana + correo | sí |
| `billing.deletion_warning` | `org` | atención | Dueño: campana + correo | sí |
| `org.member_joined` | `org` | informativo | Dueño: campana; Admin: campana |  |
| `org.member_left` | `org` | informativo | Dueño: campana; Admin: campana |  |
| `org.api_keys_orphaned` | `org` | atención | Dueño: campana + correo; Admin: campana + correo |  |
| `org.api_key_expiring` | `org` | atención | Dueño: campana + correo; Admin: campana + correo; la persona citada: campana + correo |  |
| `org.data_export_ready` | `org` | informativo | la persona citada: campana + correo | sí |
| `org.retention_purged` (aún sin emisor) | `org` | informativo | Dueño: campana; Admin: campana |  |
| `security.password_changed` | `security` | crítico | la persona citada: campana + correo | sí |
| `security.two_factor_changed` | `security` | crítico | la persona citada: campana + correo | sí |
| `security.two_factor_reset` | `security` | crítico | la persona citada: campana + correo | sí |
| `security.email_changed` | `security` | crítico | la persona citada: campana + correo | sí |
| `security.new_device_login` (aún sin emisor) | `security` | crítico | la persona citada: campana + correo | sí |
| `security.role_changed` | `security` | crítico | la persona citada: campana + correo | sí |
| `security.removed_from_org` | `security` | crítico | la persona citada: campana + correo | sí |
| `instance.meta_signature_failing` (aún sin emisor) | `instance` | crítico | la persona citada: campana + correo | sí |
| `instance.queue_stalled` (aún sin emisor) | `instance` | crítico | la persona citada: campana + correo | sí |
| `instance.media_storage_down` (aún sin emisor) | `instance` | crítico | la persona citada: campana + correo | sí |
| `instance.rate_card_sync_failed` | `instance` | crítico | super-admins de la instancia: campana + correo | sí |

Los tipos marcados "aún sin emisor" ya existen en el catálogo y en la matriz, pero ningún evento los dispara en esta versión.

## Banners

Un banner es **estado**, no un aviso: aparece arriba del panel mientras la condición se cumple y desaparece solo cuando termina. Hoy hay tres: conexiones que necesitan atención (fuera de `active`), eliminación de la organización en curso y conexiones desconectadas por falta de pago cuando la organización vuelve a la normalidad (`connections_reconnect`, pide reconectar).

## Retención y antispam

Los avisos se guardan **90 días**; luego un job diario los borra. Para no llenar la campana, un mismo asunto (por ejemplo, la misma conexión cayendo por el mismo motivo) no vuelve a avisar durante **6 horas**.
