우선순위 수준 및 긴급 알림
모든 Pocket Alert 메시지에는 알림이 얼마나 강하게 전달될지를 정하는 우선순위 수준이 있습니다. 조용히 알림 센터에만 남길 수도 있고, 일반 배너로 보여줄 수도 있고, 무음 스위치와 방해 금지 모드를 뚫고 기기를 깨우는 긴급 알림으로 보낼 수도 있어요.
다섯 가지 수준
| 수준 | 별칭 | 동작 |
|---|---|---|
silent | min, -2 | 알림 센터에만 전달됩니다. 소리와 진동이 없어요 |
low | -1 | 조용히 전달되며 흐름을 방해하지 않습니다 |
default | normal, 0 (또는 생략) | 일반 배너와 소리를 사용합니다 |
high | 1 | 시간에 민감한 알림입니다. 집중 모드와 예약 요약을 뚫고 전달돼요 |
critical | max, urgent, 2 | 무음 스위치와 방해 금지 모드를 뚫고 기기를 깨웁니다 |
두 가지 표기 방식 모두 어디서나 사용할 수 있어요. "level": "critical"로 보내도 되고 "level": 2로 보내도 됩니다. 메시지 생성 API에서는 이 필드를 priority로도 받을 수 있습니다. 웹훅은 level만 읽어요.
기기에서 각 수준의 동작
iOS에서는 수준을 APNs 방해 수준인 passive, active, time-sensitive, critical에 대응시킵니다. critical 알림은 Apple의 긴급 알림 권한을 사용하기 때문에, 벨소리가 꺼져 있고 방해 금지 모드가 켜져 있어도 자체 볼륨으로 소리를 재생합니다. iOS는 별도의 긴급 알림 권한을 요청하며, 설정 → 알림 → Pocket Alert에서 이 권한을 끄면 critical 메시지는 time-sensitive로 도착해요.
Android에서는 수준마다 별도의 알림 채널을 사용합니다. critical은 방해 금지 우회와 전체 화면 인텐트가 설정된 중요도 높은 채널을 사용하므로, 알림이 알림 센터에서 기다리는 대신 화면 전체를 차지합니다.
각 수준이 별도의 Android 채널이기 때문에, 사용자는 시스템 설정에서 일상적인 알림은 음소거하면서도 긴급 알림은 계속 받도록 설정할 수 있습니다.
설정 위치
우선순위는 다음 순서로 결정되며, 먼저 일치하는 값이 적용됩니다.
- 메시지별 — 메시지 생성의
level필드, 대시보드의 우선순위 선택기, 또는 웹훅으로 보내는 페이로드의 최상위level필드입니다. - 웹훅별 — 웹훅에 설정하는 기본 수준입니다. 이 웹훅으로 들어오는 메시지에 적용되므로, 들어온 페이로드를 심각도에 바로 매핑할 수 있어요.
- 애플리케이션별 — 애플리케이션에 설정하는 기본 수준입니다. 자체 수준을 지정하지 않은 모든 메시지에 적용돼요.
- 폴백 —
default입니다.
이 순서 덕분에 웹훅 하나로 일상적인 이벤트와 긴급한 이벤트를 모두 처리할 수 있습니다. 웹훅을 high로 설정해 두고, 실제로 문제가 생겼을 때만 개별 호출에서 수준을 올려 보내면 됩니다.
플랜별 제한
긴급 알림은 유료 기능입니다
무료 플랜에서는 critical이 거부되지 않고 자동으로 high로 낮춰집니다. 알림은 그대로 도착하지만 방해 금지 모드를 뚫지는 못해요. 다른 모든 수준은 모든 플랜에서 사용할 수 있습니다.
알 수 없는 수준 이름이거나 -2..2 범위를 벗어난 정수를 보내면 400이 반환됩니다.
앱에서 우선순위로 필터링하기
모바일 피드도 같은 수준을 사용합니다. 필터 아이콘을 누르면 하나 이상의 수준을 선택하거나, 날짜 범위를 좁히거나, 시간순 대신 심각도순으로 전체 피드를 정렬할 수 있어요. 알림이 마흔 개나 쌓인 휴대폰을 다시 열었을 때, 중요한 두 개만 빠르게 찾고 싶을 때 유용합니다.
수준 고르는 법
알림을 믿을 수 있게 유지하는 간단한 기준은 다음과 같습니다.
critical— 시간과 관계없이 누군가 지금 바로 조치해야 할 때입니다. 운영 서버 중단, 보안 침해, 냉동고 온도 초과 등이 해당해요.high— 한 시간 안에 확인이 필요할 때입니다. 배포 실패, 결제 거절, 대기열 적체 등이 해당합니다.default— 오늘 안에 알아두면 좋을 때입니다. 빌드 완료, 신규 가입, 폼 제출 등이 해당해요.low/silent— 휴대폰에 기록만 남기면 될 때입니다. 크론 작업이 예정대로 끝남, 야간 백업 완료 등이 해당합니다.
우선순위 수준의 목적은 모든 알림을 더 시끄럽게 만드는 것이 아닙니다. 시끄러운 알림이 진짜 의미를 갖도록 하는 것입니다.