Уровни приоритета и критические оповещения
Каждое сообщение Pocket Alert имеет уровень приоритета, который определяет, насколько заметным будет push-уведомление: тихо в шторке, как обычный баннер или как критическое оповещение, которое будит устройство даже при включённом беззвучном режиме и режиме «Не беспокоить».
Пять уровней
| Уровень | Синонимы | Поведение |
|---|---|---|
silent | min, -2 | Доставляется только в шторку — без звука и вибрации |
low | -1 | Тихо, без прерывания |
default | normal, 0 (или не указан) | Стандартный баннер и звук |
high | 1 | Срочное — прорывается через «Фокусирование» и сводку по расписанию |
critical | max, urgent, 2 | Будит устройство даже при беззвучном режиме и «Не беспокоить» |
Работают обе записи везде: отправьте "level": "critical" или "level": 2. В API Create Message поле также принимается под именем priority; вебхуки читают только level.
Что делает каждый уровень на устройстве
iOS сопоставляет уровни с уровнями прерывания APNs — passive, active, time-sensitive и critical. Оповещение critical использует право Apple на критические оповещения, которое воспроизводит звук на собственной громкости, даже когда звонок выключен и включён режим «Не беспокоить». iOS запрашивает отдельное разрешение Critical Alerts; если оно выключено в Настройки → Уведомления → Pocket Alert, сообщения critical приходят как time-sensitive.
Android сопоставляет уровни с отдельными каналами уведомлений. critical использует канал высокой важности с обходом режима «Не беспокоить» и полноэкранным интентом, поэтому оповещение занимает весь экран, а не ждёт в шторке.
Так как каждый уровень — отдельный канал Android, пользователи могут отключить ваши обычные уведомления в системных настройках, оставив критические включёнными.
Где задать уровень
Приоритет определяется в таком порядке, побеждает первое совпадение:
- Для сообщения — поле
levelв Create Message, выбор приоритета на панели или полеlevelверхнего уровня в payload, отправленном на вебхук. - Для вебхука — уровень по умолчанию для вебхука, применяемый к сообщениям, которые через него поступают, так что входящий payload сразу сопоставляется с серьёзностью.
- Для приложения — уровень по умолчанию для приложения, применяемый ко всем сообщениям, которые не задают свой.
- Запасной вариант —
default.
Именно такой порядок позволяет одному вебхуку обрабатывать и рутинные, и срочные события: установите для вебхука high и позволяйте отдельным вызовам повышать уровень, когда что-то действительно ломается.
Ограничения тарифа
Critical — платная функция
На бесплатных тарифах critical автоматически понижается до high, а не отклоняется — оповещение всё равно придёт, но не будет обходить режим «Не беспокоить». Все остальные уровни работают на любом тарифе.
Неизвестное название уровня или целое число вне диапазона -2..2 возвращает 400.
Фильтрация по приоритету в приложении
Мобильная лента использует те же уровни. Нажмите на значок фильтра, чтобы выбрать один или несколько уровней, ограничить диапазон дат или сортировать всю ленту по серьёзности, а не по времени — это удобно, когда вы возвращаетесь к телефону с сорока уведомлениями и хотите увидеть два важных.
Как выбрать уровень
Простое правило, которое помогает сохранять доверие к уведомлениям:
critical— кому-то нужно действовать немедленно, в любое время суток. Продакшен упал, утечка безопасности, в морозилке выше допустимой температуры.high— требует внимания в течение часа. Сбой деплоя, отклонённый платёж, растущая очередь.default— стоит знать сегодня. Сборка завершена, новая регистрация, форма отправлена.low/silent— журнал на телефоне. Cron-задача выполнилась по расписанию, ночной бэкап завершён.
Смысл уровней не в том, чтобы сделать каждое оповещение громче. Они нужны, чтобы громкие оповещения что-то значили.
Связанное
- Create Message — поле
levelи полный справочник запроса - Кнопки действий — действуйте по оповещению, не открывая приложение
- Отложенная отправка — отправьте сейчас, доставьте позже