우선순위 단계

알림이 무음 모드도 뚫고 방해 금지 모드까지.

Pocket Alert는 모든 푸시 알림에 무음부터 긴급까지 우선순위 단계를 부여해요. 안드로이드에서는 긴급 알림이 방해 금지 모드와 무음 모드를 무시하고, 아이폰에서는 시간 민감 알림으로 집중 모드를 통과해요. API 호출에서 필드 하나로 설정하면 돼요.

5단계: -2…2DND 무시필드 하나: level 업데이트
기능

장애 상황에 맞는 우선순위 단계

새벽 3시의 모니터링 경고와 매일 밤의 백업 보고서가 같은 소리로 울리면 안 돼요. Pocket Alert는 모든 메시지에 무음부터 긴급까지 우선순위 단계를 부여해요.

단계 5개, 필드 하나

silent, low, default, high, critical까지, API, 웹훅 페이로드, MCP 어디서든 메시지 하나에 level 필드 하나면 충분해요.

안드로이드 방해 금지 모드 돌파

안드로이드의 긴급 알림은 방해 금지 모드를 무시하는 전용 채널로 게시되며, 전체 화면으로 표시할 수 있어요.

아이폰 집중 모드 돌파

high와 critical 메시지는 아이폰에서 시간 민감 알림으로 도착해서 집중 모드도 통과해요.

필요할 때는 조용하게

level -2 메시지는 소리와 진동 없이 전달돼요. 성공 알림과 요약 보고서는 누구도 깨우지 않고 기록으로 남아요.

앱과 웹훅별 기본값

애플리케이션이나 웹훅마다 default_level을 한 번만 설정하면 모든 메시지가 이를 따르고, 개별 메시지에서 언제든 덮어쓸 수 있어요.

우선순위 중심 피드

모바일 앱은 피드를 우선순위별로 필터링하고 정렬해서, 긴급 장애가 일상적인 알림에 묻히지 않아요.

시작하기

깨워 주는 알림까지 3단계

1

단계 선택

요약 보고서는 silent, 경고는 high, 아침까지 기다릴 수 없는 장애는 critical로 설정하세요.

2

메시지 전송

API 호출이나 웹훅 페이로드에 "level":"critical"을 추가하거나, 애플리케이션에 기본값을 설정하세요.

3

알림이 뚫고 나와요

안드로이드에서는 방해 금지 모드를 무시하고 전체 화면으로 표시돼요. 아이폰에서는 집중 모드를 통과해요. 무음은 그대로 무음이에요.

첫 긴급 알림 보내기

1. 단계 선택하기

모든 메시지는 level(또는 priority) 필드를 받아요:

level: silent (-2) · low (-1) · default (0) · high (1) · critical (2)

별칭도 사용할 수 있어요: min, normal, urgent, max. 잘못된 값은 API에서 400으로 명확하게 응답하므로 오타가 조용히 무시되는 일은 없어요.

2. 전송하기

curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Primary DB down","message":"Postgres is not responding on db-1","level":"critical"}'

같은 필드를 웹훅 페이로드에서도 쓸 수 있어요. 서비스가 Pocket Alert 웹훅 URL로 보내는 JSON에 "level": "critical"을 추가하면 되고, create_message MCP 도구에서도 동일하게 작동해요.

3. 중요하지 않은 알림은 조용하게

pg_dump mydb | gzip > backup.sql.gz && \
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Backup finished' -F 'message=Nightly dump completed' -F 'level=silent'

무음 메시지는 소리 없이 기록에 남아요. 휴대폰은 단계에서 울려야 한다고 지정할 때만 소리를 내요.

단계가 결정되는 순서

메시지에 직접 지정한 level → 웹훅의 default_level → 애플리케이션의 default_level → default. 모니터링 알림을 받는 웹훅에 기본값을 한 번 설정해 두면, 발신 서비스를 건드리지 않고도 그 웹훅이 전달하는 모든 메시지가 high로 도착해요.

휴대폰에서 한 번만 설정하기

안드로이드에서는 앱이 요청하면 방해 금지 모드 접근을 허용해 주세요(설정 → 중요 알림만). 그래야 긴급 알림이 방해 금지 모드를 뚫고 울려요. 아이폰에서는 알림을 허용하면 Pocket Alert가 high와 critical 메시지를 시간 민감 알림으로 전달하고, 이 알림은 집중 모드를 통과해요. 무음 스위치를 무시하는 iOS 긴급 알림 사운드는 Apple이 권한을 승인하는 대로 순차 적용될 예정이에요.

FAQ

궁금한 점을 답해드려요

안드로이드에서는 가능해요. level: critical로 메시지를 보내면 방해 금지 모드를 무시하고 전체 화면으로 표시되는 전용 알림 채널에 게시돼요. 설정에서 앱에 방해 금지 모드 접근 권한을 한 번만 허용해 주세요. 아이폰에서는 긴급 메시지가 집중 모드를 통과하는 시간 민감 알림으로 도착해요. 무음 스위치를 무시하는 긴급 알림 사운드는 Apple이 권한을 승인하는 대로 순차 적용될 예정이에요.

silent(-2), low(-1), default(0), high(1), critical(2)까지 총 5단계예요. API는 단계 이름이나 숫자를 모두 받고, min, normal, urgent, max 같은 별칭도 사용할 수 있어요. 필드 이름은 level 또는 priority 중 아무거나 쓰면 돼요.

애플리케이션이나 웹훅에 default_level을 설정하면 그곳을 거치는 모든 메시지가 해당 단계를 따라요. 메시지에 직접 지정한 level이 항상 우선해요. 어디에도 설정하지 않으면 메시지는 default 단계로 발송돼요.

긴급 알림 전송은 유료 기능이에요. 무료 플랜에서는 긴급 메시지가 high 우선순위로 전송돼요. 즉시 도착하고 피드 상단에 머무르지만, 방해 금지 모드를 무시하지는 않아요.

아니요. 무음 메시지(level -2)는 소리와 진동을 완전히 건너뛰고 알림 트레이와 메시지 기록에 조용히 남아요. 진동 없이 기록으로 남기고 싶은 성공 알림, 요약 보고서 등에 사용하세요.

호출기가 돌아왔어요. 이제 주머니 속에 있어요.

API 호출의 level 필드 하나로 푸시 알림이 조용히 올지 바로 깨울지 정할 수 있어요. 설정해 두면 장애를 놓치지 않아요.