# Notifications

> How Messajo alerts your team: bell, email, who receives each notice, organization rules, per-person preferences and banners.

Messajo alerts your team when something needs attention: a connection dropped, a template was rejected, a destination was paused, a campaign stopped. Every notice shows up in the panel **bell** and, when the type asks for it, also arrives by **email**.

## Bell and page

The bell sits at the top of the panel and shows the unread count and the 20 most recent notices. On each notice you can mark it read or unread and clear it. **See all** opens the `Notifications` page, with pagination, filters by group, level and read state, bulk selection and **Clear all**. The panel refreshes every 30 seconds and when the tab regains focus. The organization switcher shows how many unread notices each organization has.

## Channels and levels

- **Channels:** bell (`inbox`) and email (`email`).
- **Levels:** critical (needs action now), warning and info.

The notice text is written in the recipient's language.

## Who receives it

The decision has four layers, in this order:

1. **Type default**, per role (table below).
2. **Organization rule** in `Settings › Notifications`: owners and admins turn the bell and email on or off per type and per role.
3. **Per-person preference** in `My account › Notifications`: per organization, type and channel. You can go back to the default.
4. **Locked notices** do not change by rule or preference: account security (password, 2FA, email, role changes), organization deletion and the data-export-ready notice always arrive.

## Notice types

| Type | Group | Level | Default recipients | Locked |
|---|---|---|---|---|
| `connection.disconnected` | `connection` | critical | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.needs_reconnect` | `connection` | critical | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.restricted` | `connection` | critical | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.unrestricted` | `connection` | info | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.banned` | `connection` | critical | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.reinstated` | `connection` | info | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.scheduled_for_disable` | `connection` | critical | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.quality_changed` | `connection` | warning | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.messaging_limit_changed` | `connection` | info | Owner: bell; Admin: bell |  |
| `connection.display_name_reviewed` | `connection` | info | Owner: bell + email; Admin: bell + email |  |
| `connection.account_review` | `connection` | warning | Owner: bell + email; Admin: bell + email |  |
| `connection.account_alert` | `connection` | warning | Owner: bell + email; Admin: bell + email |  |
| `connection.capability_changed` (no emitter yet) | `connection` | info | Owner: bell; Admin: bell |  |
| `connection.coex_unlinked` | `connection` | critical | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `connection.history_sync_stalled` | `connection` | warning | Owner: bell; Admin: bell |  |
| `connection.token_expiring` | `connection` | warning | Owner: bell + email; Admin: bell + email |  |
| `connection.page_role_lost` | `connection` | critical | Owner: bell + email; Admin: bell + email |  |
| `connection.pin_required` | `connection` | warning | Owner: bell + email; Admin: bell + email |  |
| `connection.created` | `connection` | info | Owner: bell; Admin: bell |  |
| `connection.reconnected` | `connection` | info | Owner: bell; Admin: bell |  |
| `template.approved` | `template` | info | Owner: bell; Admin: bell; Dev: bell |  |
| `template.rejected` | `template` | warning | Owner: bell + email; Admin: bell + email; Dev: bell + email |  |
| `template.paused` | `template` | critical | Owner: bell + email; Admin: bell + email; Dev: bell + email |  |
| `template.disabled` | `template` | critical | Owner: bell + email; Admin: bell + email; Dev: bell + email |  |
| `template.quality_changed` (no emitter yet) | `template` | warning | Owner: bell; Admin: bell; Dev: bell |  |
| `template.category_changed` (no emitter yet) | `template` | warning | Owner: bell + email; Admin: bell + email; Dev: bell + email |  |
| `template.components_changed` (no emitter yet) | `template` | info | Owner: bell; Admin: bell; Dev: bell |  |
| `destination.paused` | `delivery` | critical | Owner: bell + email; Admin: bell + email; Dev: bell + email |  |
| `destination.failure_rate_high` (no emitter yet) | `delivery` | warning | Owner: bell; Admin: bell; Dev: bell |  |
| `destination.secret_rotated` | `delivery` | info | Owner: bell; Admin: bell |  |
| `flow.endpoint_unhealthy` | `flow` | critical | Owner: bell + email; Admin: bell + email; Dev: bell + email |  |
| `flow.status_changed` | `flow` | info | Owner: bell; Admin: bell; Dev: bell |  |
| `campaign.completed` | `campaign` | info | Owner: bell; Admin: bell; Dev: bell |  |
| `campaign.auto_paused` | `campaign` | critical | Owner: bell + email; Admin: bell + email; Dev: bell + email; the person the notice names: bell + email |  |
| `campaign.paused_spend_cap` (no emitter yet) | `campaign` | critical | Owner: bell + email; Admin: bell + email; Dev: bell |  |
| `cost.threshold_reached` (no emitter yet) | `cost` | warning | Owner: bell + email; Admin: bell + email |  |
| `cost.reconciliation_diff` (no emitter yet) | `cost` | info | Owner: bell; Admin: bell |  |
| `group.suspended` | `groups_commerce` | warning | Owner: bell; Admin: bell; Dev: bell |  |
| `order.received` | `groups_commerce` | info | nobody |  |
| `publication.failed` | `publication` | warning | Owner: bell; Admin: bell; Dev: bell |  |
| `org.standing_changed` (no emitter yet) | `org` | critical | Owner: bell + email; Admin: bell; Dev: bell; Viewer: bell | yes |
| `org.deletion_scheduled` | `org` | critical | Owner: bell + email; Admin: bell + email | yes |
| `org.deletion_canceled` | `org` | info | Owner: bell + email; Admin: bell + email | yes |
| `billing.payment_failed` | `org` | critical | Owner: bell + email | yes |
| `billing.deletion_warning` | `org` | warning | Owner: bell + email | yes |
| `org.member_joined` | `org` | info | Owner: bell; Admin: bell |  |
| `org.member_left` | `org` | info | Owner: bell; Admin: bell |  |
| `org.api_keys_orphaned` | `org` | warning | Owner: bell + email; Admin: bell + email |  |
| `org.api_key_expiring` | `org` | warning | Owner: bell + email; Admin: bell + email; the person the notice names: bell + email |  |
| `org.data_export_ready` | `org` | info | the person the notice names: bell + email | yes |
| `org.retention_purged` (no emitter yet) | `org` | info | Owner: bell; Admin: bell |  |
| `security.password_changed` | `security` | critical | the person the notice names: bell + email | yes |
| `security.two_factor_changed` | `security` | critical | the person the notice names: bell + email | yes |
| `security.two_factor_reset` | `security` | critical | the person the notice names: bell + email | yes |
| `security.email_changed` | `security` | critical | the person the notice names: bell + email | yes |
| `security.new_device_login` (no emitter yet) | `security` | critical | the person the notice names: bell + email | yes |
| `security.role_changed` | `security` | critical | the person the notice names: bell + email | yes |
| `security.removed_from_org` | `security` | critical | the person the notice names: bell + email | yes |
| `instance.meta_signature_failing` (no emitter yet) | `instance` | critical | the person the notice names: bell + email | yes |
| `instance.queue_stalled` (no emitter yet) | `instance` | critical | the person the notice names: bell + email | yes |
| `instance.media_storage_down` (no emitter yet) | `instance` | critical | the person the notice names: bell + email | yes |
| `instance.rate_card_sync_failed` | `instance` | critical | instance super admins: bell + email | yes |

Types marked "no emitter yet" already exist in the catalog and the matrix, but no event fires them in this version.

## Banners

A banner is **state**, not a notice: it shows at the top of the panel while the condition holds and disappears on its own when it clears. There are three today: connections that need attention (not `active`), an organization deletion in progress, and connections disconnected for non-payment once the organization is back to normal (`connections_reconnect`, asks to reconnect).

## Retention and anti-spam

Notices are kept for **90 days**; a daily job then deletes them. To keep the bell from filling up, the same subject (for example, the same connection dropping for the same reason) does not notify again for **6 hours**.
