---
title: 通知类型 - 标准、时间敏感和电话警报
sidebarTitle: 通知类型
description: Echobell 通知类型和自定义的完整指南。了解标准推送通知、突破专注模式的时间敏感警报以及用于关键紧急情况的电话通知。理解如何为不同紧急程度配置通知偏好设置。
---

# Echobell 中的通知

通知是 Echobell 功能的核心。本指南解释了通知的工作原理、可用的不同类型以及如何根据您的需求自定义它们。

## 通知类型

订阅频道时，您可以根据紧急程度选择以下三种通知类型：

- **普通**：用于常规提醒的标准应用通知。这些通知遵循您设备的正常通知设置。
- **时效性**：可以突破某些专注模式的高优先级通知。适用于不应错过的重要提醒。
- **来电**：用于需要立即关注的关键情况的类似来电的提醒。这些通知在您的设备上显示为来电。

### 您选择的类型是上限

您选择的类型是频道能提醒您的最高级别。Webhook 请求可以发送 `notificationType`（`active`、`time-sensitive` 或 `calling`）来指定**更低**的级别，但不会超过您的设置。

例如，以**来电**类型订阅您的生产环境频道。不带 `notificationType` 的故障告警会像电话一样响铃，而发送 `notificationType=active` 的日常事件会以普通通知送达。以普通类型订阅同一频道的人，无论请求怎么要求，都不会收到来电。

一个频道每分钟最多给每位订阅者打一次电话。这一分钟内的再次来电会改为以时效性通知送达，因此卡在重试循环里的脚本无法让您的手机响个不停。

开启了自定义模板的频道会忽略请求中的 `notificationType`，每位订阅者始终收到自己选择的类型。详见 [Webhook](/zh/docs/webhook#通知级别)。

## 自定义提示音

每位订阅者在频道设置中为每个频道单独选择提示音，频道所有者无法替订阅者选择。您的选择会在您的设备之间同步。

Webhook、MCP `notify` 工具和其他触发请求同样无法选择提示音。

### 内置声音

Echobell 内置一套免费的声音库，全部为 Echobell 原创。选择某个声音时会播放试听。

- **提示音**：10 款简短的声音：钟鸣、铃铛、气泡、脉冲、上扬、下落、马林巴、声呐、警报和蜂鸣
- **铃声**：4 款循环播放的铃声，用于来电通知：经典、数码、微光和紧急

设置为**来电**的频道选择的是铃声，而不是提示音。铃声不能设为静音。

### 静音频道

将频道设为**静音**后，通知仍会送达，角标和记录都会保留，只是不发出声音。静音是免费的。

### 导入自己的声音

导入自己的音频文件是 Echobell 高级版的功能。导入的声音只保存在导入它的设备上，您的其他设备会回退到默认提示音。

- **iOS**：导入的声音会被裁剪到不足 30 秒，且不能用作来电铃声
- **Android**：导入的文件不能超过 30 秒，也可以用作来电铃声

### iOS 上的声音与专注模式

在 iOS 上，声音仍然遵循响铃/静音开关和专注模式。**时效性**通知可以突破专注模式，但不能突破静音开关。

## 通知内容

默认情况下，频道显示每个请求发送的 `title` 和 `body`，标题默认为频道名称。如果在频道设置的**高级设置**中开启**自定义模板**，频道会改用模板生成通知：

- **标题模板**：决定通知标题中显示的内容
- **正文模板**：控制通知的主要内容

模板支持使用 `{{variableName}}` 语法的动态变量。例如：

```
标题：{{server}} 状态提醒
正文：在 {{timestamp}} 检测到 {{message}}
```

## 通知中的变量

### Webhook 变量

在开启了自定义模板的频道上，Webhook 请求中的每个字段都会成为变量。您可以通过以下方式提供变量：

- 查询参数：`https://hook.echobell.one/t/<channel-token>?server=production&status=critical`
- JSON 正文：

```json
{
  "server": "production",
  "status": "critical"
}
```

特殊变量：

- `externalLink`：包含时，在通知记录视图中创建可点击的链接

### 电子邮件变量

通过电子邮件触发时，以下变量自动可用：

- `from`：发件人电子邮件地址
- `to`：收件人电子邮件地址
- `subject`：电子邮件主题行
- `text`：纯文本内容
- `html`：电子邮件的 HTML 内容

## 隐私和存储

Echobell 采用隐私优先的方式处理通知：

- 通知内容和历史记录仅存储在您的本地设备上
- 服务器仅存储必要数据（用户账户、频道配置和订阅）
- 您的通知数据始终在您的控制之下

## 应用设置

通过以下设置配置通知行为：

- **重复语音内容**：对于来电通知，启用重复通知内容
- **重试失败的来电**：自动重试因专注模式或其他原因失败的来电通知

## 重要说明

- 应用需要通知权限才能正常运行
- 频道触发时实时发送通知
- 您可以接收来自您创建的频道和您订阅的频道的通知
- 不同的通知类型可用于不同的紧急程度
