与故障严重程度相匹配的优先级
凌晨 3 点的监控告警和每日备份报告,提示音不该一样。Pocket Alert 为每条消息设置优先级,从 silent 到 critical,任你选择。
五级,一个字段
silent、low、default、high、critical,共五级。任意消息都只需一个 level 字段,无论在 API、Webhook 负载还是 MCP 中使用。
在 Android 上突破勿扰模式
Android 上的紧急通知会进入专用渠道,绕过勿扰模式,并可全屏显示。
在 iPhone 上穿透专注模式
high 和 critical 消息在 iPhone 上以时效性通知送达,因此可以穿透专注模式。
该安静时就安静
level -2 投递时没有声音和震动。成功提示和摘要会留存记录,不会吵醒任何人。
按应用与 Webhook 设置默认值
每个应用或 Webhook 只需设置一次 default_level。所有消息都会继承它,任何消息也都可以单独覆盖。
优先级优先的消息流
移动应用可按优先级筛选和排序消息流,因此紧急故障不会被日常噪音淹没。
三步设置,让告警把你叫醒
选择等级
摘要用 silent,警告用 high,不能等到早上的故障用 critical。
发送消息
在 API 调用、Webhook 负载中添加 "level":"critical",或在应用上设置默认值。
成功突破
Android 绕过勿扰模式并全屏显示。iPhone 穿透专注模式。静音依然保持安静。
发送你的第一条紧急通知
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"}'
同一字段也适用于 Webhook 负载。在任意服务发送到你的 Pocket Alert Webhook 地址的 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'
静音消息会进入你的历史记录,且不发出声音。只有等级要求时,你的手机才会发出提示。
等级如何解析
消息显式等级 → Webhook default_level → 应用 default_level → 默认值。只需在接收监控告警的 Webhook 上设置一次默认值,它转发的所有内容都会以 high 送达,发送方无需任何改动。
手机上的一次性设置
在 Android 上,应用请求时请允许勿扰模式访问(设置 → 仅紧急通知),这样紧急通知才能穿透。在 iPhone 上,允许通知后,Pocket Alert 会将 high 和 critical 消息以时效性通知送达,从而穿透专注模式。能够无视静音开关的完整 iOS 紧急提示音,将随 Apple 授予相关权限而陆续开放。
常见问题解答
Android 上可以。发送 level: critical 的消息后,它会进入专用通知渠道,绕过勿扰模式并全屏显示。你只需在设置中为应用授予一次勿扰模式访问权限。在 iPhone 上,紧急消息会以时效性通知的形式送达,可以穿透专注模式。能够无视静音开关的完整紧急提示音,将随 Apple 授予相关权限而陆续开放。
共五级:silent(-2)、low(-1)、default(0)、high(1)和 critical(2)。API 既接受名称,也接受数字,常见别名同样有效,包括 min、normal、urgent 和 max。可以用 level 或 priority 字段发送,两者都支持。
在应用或 Webhook 上设置 default_level 后,经由它路由的每条消息都会继承该等级。消息本身显式指定的 level 始终优先。如果各处都未设置,消息将以 default 等级发送。
紧急通知投递是付费功能。在免费套餐中,紧急消息会以 high 优先级投递。它依然会即时送达,并保持在消息流顶部,只是不会突破勿扰模式。
不会。静音消息(level -2)完全不发出声音和震动,只会安静地出现在通知栏和消息历史中。适用于成功提示、摘要,以及任何只需留档、不想被打扰的内容。