优先级等级

让告警 穿透静音模式和勿扰模式。

Pocket Alert 为每条推送通知设置从 silent 到 critical 的优先级。在 Android 上,紧急通知会绕过勿扰模式和静音模式;在 iPhone 上,它会以时效性通知的形式穿透专注模式。你只需在 API 调用中设置一个字段即可。

5 个等级:-2…2绕过 DND一个字段:level更新于
功能

与故障严重程度相匹配的优先级

凌晨 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。所有消息都会继承它,任何消息也都可以单独覆盖。

优先级优先的消息流

移动应用可按优先级筛选和排序消息流,因此紧急故障不会被日常噪音淹没。

快速开始

三步设置,让告警把你叫醒

1

选择等级

摘要用 silent,警告用 high,不能等到早上的故障用 critical。

2

发送消息

在 API 调用、Webhook 负载中添加 "level":"critical",或在应用上设置默认值。

3

成功突破

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)完全不发出声音和震动,只会安静地出现在通知栏和消息历史中。适用于成功提示、摘要,以及任何只需留档、不想被打扰的内容。

寻呼机回来了,而且就在你口袋里。

API 调用中的一个 level 字段,决定推送是轻声提醒还是把你叫醒。设置好它,别再错过故障告警。