Перейти к содержимому

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

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

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

УровеньСинонимыПоведение
silentmin, -2Доставляется только в шторку — без звука и вибрации
low-1Тихо, без прерывания
defaultnormal, 0 (или не указан)Стандартный баннер и звук
high1Срочное — прорывается через «Фокусирование» и сводку по расписанию
criticalmax, 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, пользователи могут отключить ваши обычные уведомления в системных настройках, оставив критические включёнными.

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

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

  1. Для сообщения — поле level в Create Message, выбор приоритета на панели или поле level верхнего уровня в payload, отправленном на вебхук.
  2. Для вебхука — уровень по умолчанию для вебхука, применяемый к сообщениям, которые через него поступают, так что входящий payload сразу сопоставляется с серьёзностью.
  3. Для приложения — уровень по умолчанию для приложения, применяемый ко всем сообщениям, которые не задают свой.
  4. Запасной вариант — default.

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

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

Critical — платная функция

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

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

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

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

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

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

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

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

Связанное ​

Документация Pocket Alert