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

> 为每条推送设置优先级：静音、低、默认、高或紧急。紧急告警可绕过 Android 的勿扰模式，并突破 iPhone 的专注模式。API 中只需一个 level 字段。

<!-- source: https://pocketalert.app/zh/use-cases/critical-alerts -->

最后更新：2026-10-25

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

## 三步设置，让告警把你叫醒

1. **选择等级** — 摘要用 silent，警告用 high，不能等到早上的故障用 critical。
2. **发送消息** — 在 API 调用、Webhook 负载中添加 "level":"critical"，或在应用上设置默认值。
3. **成功突破** — Android 绕过勿扰模式并全屏显示。iPhone 穿透专注模式。静音依然保持安静。

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

凌晨 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. 选择等级

每条消息都接受一个 `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 授予相关权限而陆续开放。

### Pocket Alert 支持哪些优先级等级？

共五级：silent（-2）、low（-1）、default（0）、high（1）和 critical（2）。API 既接受名称，也接受数字，常见别名同样有效，包括 min、normal、urgent 和 max。可以用 level 或 priority 字段发送，两者都支持。

### 能否为每个应用或 Webhook 单独设置默认等级？

在应用或 Webhook 上设置 default_level 后，经由它路由的每条消息都会继承该等级。消息本身显式指定的 level 始终优先。如果各处都未设置，消息将以 default 等级发送。

### 紧急通知在免费套餐中可用吗？

紧急通知投递是付费功能。在免费套餐中，紧急消息会以 high 优先级投递。它依然会即时送达，并保持在消息流顶部，只是不会突破勿扰模式。

### 静音消息会丢失吗？

不会。静音消息（level -2）完全不发出声音和震动，只会安静地出现在通知栏和消息历史中。适用于成功提示、摘要，以及任何只需留档、不想被打扰的内容。
