使用说明

Agent 与 HTTP 通知的来电式提醒

用 CLI、MCP 或 JSON Webhook 为 Ntfyx 消息请求可选来电式提醒,了解手机开启方式、静音规则及 iPhone / Android 的实际边界。

更新于

什么是来电式消息提醒?

#

Ntfyx 可为 CLI、MCP 或 JSON Webhook 的消息请求可选来电式提醒,需要先在接收手机主动开启。查看或忽略提醒不会回答原问题,也不会批准操作。

在接收手机上主动开启

#

来电式提醒默认关闭。发送方可以请求这种提醒方式,但不能替你打开手机开关或授予系统权限。请在 Ntfyx 设置中主动开启,并查看当前设备显示的可用状态。

  1. 在接收手机的 Ntfyx 设置中开启来电式提醒。
  2. 处理系统权限请求,再返回检查状态;Android 全屏访问在适用系统上属于单独设置。
  3. 检查 Topic 静音和安静时段,再发送自己的测试消息。

用 CLI 请求来电式提醒

#

当前公开 CLI 为 0.5.0。配对后,在 send 或 ask 上加 --alert-mode call;同一条消息仍保存在原 Topic 和 Session 中。不加这个明确选项,普通通知保持原有行为。

终端
ntfyx send "结果需要你查看" --alert-mode call --session-id review-demo
ntfyx ask "查看这个无害示例吗?" --allow-deny --alert-mode call --session-id review-demo --wait 60s --expires 90s --json

本地 MCP 使用相同提醒选项

#

本地 ntfyx_send 与 ntfyx_ask 工具接受 alert_mode: "call"。下面是 Source 已配对后传给 ntfyx_send 的参数对象;该选项请求提醒,不授予执行权限。

JSON 配置
{
  "body": "结果需要你查看",
  "session_id": "review-demo",
  "alert_mode": "call"
}

在复制链接的 JSON Webhook 中请求

#

向 App 复制的私有发送链接 POST 下方 JSON。这个固定 URL Webhook 格式要求把控制字段放在 ntfyx.alert_mode 下;第三方数据中无关的顶层 alert_mode 不会请求来电式提醒。GET 链接和普通监控消息保持原通知行为。

JSON 配置
{
  "body": "结果需要你查看",
  "ntfyx": {
    "alert_mode": "call"
  }
}

静音设置与平台边界

#

Ntfyx 会检查 Topic 静音、安静时段、消息期限与设备能力。声音和展示还取决于手机系统策略;Call 模式不承诺绕过专注、勿扰或静音设置。

平台或条件实际行为
iPhone后台登记最长 24 小时,需每天打开 Ntfyx 续期;登记过期后回退普通加密推送。
已在途的 iOS 推送若提醒失效或已静音,但 iOS 要求报告已在途推送,可能短暂出现通用系统提醒后立即结束。关闭设置不能撤回推送服务已经接受的推送。
Android需要 Google Play 服务及适用的通知权限。全屏访问属于单独权限,可能不可用;Call 渠道被设为静音时,不会切到有声普通渠道绕过你的选择。
能力不可用或过期在规则允许时,消息仍可走普通通知路径。网络、期限与投递限制可能阻止或延迟提醒;不保证唤醒,也不提供紧急响应。

查看消息与回答问题分别操作

#

打开提醒可进入原来已验证的消息。忽略提醒不会回答问题;确认、选项或文字题仍要在原请求下作答,由发送电脑验签并领取。系统来电按钮不会替代这一步。

公开版本与验证范围

#

公开的 iPhone 1.6.4 与 Android 1.6.4 已包含这个需主动开启的功能。另行提交的 1.6.1 更新截至 2026 年 10 月 23 日仍在审核。已有记录包括 iPhone 测试环境锁屏提醒、用户确认的铃声震动与原消息导航,以及 Android 模拟器通知和权限检查;这些记录不涵盖所有设备、专注模式、强制退出状态或 Play 安装后的全屏权限。