# Уровни приоритета и критические оповещения

Каждое сообщение Pocket Alert имеет уровень приоритета, который определяет, насколько заметным будет push-уведомление: тихо в шторке, как обычный баннер или как критическое оповещение, которое будит устройство даже при включённом беззвучном режиме и режиме «Не беспокоить».

## Пять уровней

| Уровень | Синонимы | Поведение |
|-------|---------|----------|
| `silent` | `min`, `-2` | Доставляется только в шторку — без звука и вибрации |
| `low` | `-1` | Тихо, без прерывания |
| `default` | `normal`, `0` (или не указан) | Стандартный баннер и звук |
| `high` | `1` | Срочное — прорывается через «Фокусирование» и сводку по расписанию |
| `critical` | `max`, `urgent`, `2` | Будит устройство даже при беззвучном режиме и «Не беспокоить» |

Работают обе записи везде: отправьте `"level": "critical"` или `"level": 2`. В API [Create Message](https://info.pocketalert.app/api/messages/create.md) поле также принимается под именем `priority`; вебхуки читают только `level`.

## Что делает каждый уровень на устройстве

**iOS** сопоставляет уровни с уровнями прерывания APNs — `passive`, `active`, `time-sensitive` и `critical`. Оповещение `critical` использует право Apple на критические оповещения, которое воспроизводит звук на собственной громкости, даже когда звонок выключен и включён режим «Не беспокоить». iOS запрашивает отдельное разрешение **Critical Alerts**; если оно выключено в **Настройки → Уведомления → Pocket Alert**, сообщения `critical` приходят как `time-sensitive`.

**Android** сопоставляет уровни с отдельными каналами уведомлений. `critical` использует канал высокой важности с обходом режима «Не беспокоить» и полноэкранным интентом, поэтому оповещение занимает весь экран, а не ждёт в шторке.

Так как каждый уровень — отдельный канал Android, пользователи могут отключить ваши обычные уведомления в системных настройках, оставив критические включёнными.

## Где задать уровень

Приоритет определяется в таком порядке, побеждает первое совпадение:

1. **Для сообщения** — поле `level` в [Create Message](https://info.pocketalert.app/api/messages/create.md), выбор приоритета на панели или поле `level` верхнего уровня в payload, отправленном на вебхук.
2. **Для вебхука** — уровень по умолчанию для вебхука, применяемый к сообщениям, которые через него поступают, так что входящий payload сразу сопоставляется с серьёзностью.
3. **Для приложения** — уровень по умолчанию для приложения, применяемый ко всем сообщениям, которые не задают свой.
4. **Запасной вариант** — `default`.

Именно такой порядок позволяет одному вебхуку обрабатывать и рутинные, и срочные события: установите для вебхука `high` и позволяйте отдельным вызовам повышать уровень, когда что-то действительно ломается.

## Ограничения тарифа

> **Warning: Critical — платная функция**
>
> На бесплатных тарифах `critical` автоматически понижается до `high`, а не отклоняется — оповещение всё равно придёт, но не будет обходить режим «Не беспокоить». Все остальные уровни работают на любом тарифе.

Неизвестное название уровня или целое число вне диапазона `-2`..`2` возвращает `400`.

## Фильтрация по приоритету в приложении

Мобильная лента использует те же уровни. Нажмите на значок фильтра, чтобы выбрать один или несколько уровней, ограничить диапазон дат или сортировать всю ленту по серьёзности, а не по времени — это удобно, когда вы возвращаетесь к телефону с сорока уведомлениями и хотите увидеть два важных.

## Как выбрать уровень

Простое правило, которое помогает сохранять доверие к уведомлениям:

- **`critical`** — кому-то нужно действовать немедленно, в любое время суток. Продакшен упал, утечка безопасности, в морозилке выше допустимой температуры.
- **`high`** — требует внимания в течение часа. Сбой деплоя, отклонённый платёж, растущая очередь.
- **`default`** — стоит знать сегодня. Сборка завершена, новая регистрация, форма отправлена.
- **`low`** / **`silent`** — журнал на телефоне. Cron-задача выполнилась по расписанию, ночной бэкап завершён.

Смысл уровней не в том, чтобы сделать каждое оповещение громче. Они нужны, чтобы громкие оповещения что-то значили.

## Связанное

- [Create Message](https://info.pocketalert.app/api/messages/create.md) — поле `level` и полный справочник запроса
- [Кнопки действий](https://info.pocketalert.app/features/action-buttons.md) — действуйте по оповещению, не открывая приложение
- [Отложенная отправка](https://info.pocketalert.app/features/scheduled-delivery.md) — отправьте сейчас, доставьте позже
