通知类型 - 标准、时间敏感和电话警报

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


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

通知类型

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

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

您选择的类型是上限

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

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

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

开启了自定义模板的频道会忽略请求中的 notificationType,每位订阅者始终收到自己选择的类型。详见 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 正文:
{
  "server": "production",
  "status": "critical"
}

特殊变量:

  • externalLink:包含时,在通知记录视图中创建可点击的链接

电子邮件变量

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

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

隐私和存储

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

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

应用设置

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

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

重要说明

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