通知渠道参数

「设置 › 通知」里八个渠道的字段、推送的事件和机器人命令。配置步骤见接收通知。

会推送哪些事件

所有已启用的渠道收到同一份通知，目前不能按事件类型单独开关某个渠道。

事件	说明
收到短信	经蜂窝网络或 VoWiFi 收到的都算。命中短信转发规则的短信按规则发送，不再发给全部渠道
来电、未接来电	来电在 SIP 客户端上接起时也会提醒
换 IP 完成	手动换 IP 与自动化脚本换 IP 都会推送
流量额度达到提醒阈值	见查看流量并设置额度
eSIM Profile 快到期或已到期
自动化脚本的通知	「推送通知」步骤、「等待输入」步骤的提示，以及脚本切卡后没能切回
登录验证码	只发到「通知渠道验证码」选定的那个渠道

渠道字段

Telegram Bot

字段	必填	说明
「Bot Token」	是	`@BotFather` 建机器人时给的 token，形如 `123456:ABC…`
「Chat ID」	是	接收通知的会话 ID，纯数字；群是负数。给机器人发一条消息后，打开 `https://api.telegram.org/bot<token>/getUpdates`，在 `chat` 下的 `id` 里找到
「Admin ID」	否	当前版本的命令鉴权只看「Chat ID」，这一格可以不填
「TG API 反代」	否	在「网络」里。替代 `api.telegram.org` 的地址，主机直连不了 Telegram 时用
「HTTP 代理」	否	在「网络」里。经这个代理访问 Telegram

飞书 Bot

armv7 版本的 nSIM 没有这个渠道。

字段	必填	说明
「App ID」	是	飞书开放平台自建应用的 App ID，`cli_` 开头
「App Secret」	是	同一个应用的 App Secret
「Chat IDs」	是	接收通知的群，`oc_` 开头；多个用英文逗号分隔

应用这一侧要：启用「机器人」能力；在「事件配置」里选「使用长连接接收事件」；添加 im:message 与 im:message:send_as_bot 权限并发布；把机器人加进群。用长连接时 nSIM 主动连飞书，主机不需要公网地址。

QQ Bot

字段	必填	说明
「App ID」「App Secret」	是	在 QQ 机器人官方控制台申请，表单的「获取方式」里有入口
「群聊」「私聊」	至少一个	在「接收人」里，填 OpenID，多个用英文逗号分隔

OpenID 的取法：先保存 App ID 与 App Secret。再用 QQ 给机器人发一条消息，到「诊断 › 日志」里搜 OpenID。接收人为空时，机器人既不推送也不回复。

Bark

字段	必填	说明
「目标地址」	至少一个	Bark 应用给的推送地址，形如 `https://api.day.app/<key>/`。点「添加地址」可加多个，推给多部手机
「分组」	否	通知在 Bark 里归入的分组
「通知级别」	否	「时效性 · 亮屏」「积极 · 亮屏」「被动 · 只进通知中心」
「图标 URL」	否	通知上显示的图标

表单里有「发一条测试」。

Email

字段	必填	说明
「主机」「端口」	是	在「SMTP 服务器」里。端口常见 465 或 587
「SSL/TLS」	否	端口填 465 时会自动勾上
「用户名」「密码」	是	在「账号」里。很多邮箱要先在网页设置里开启 SMTP，用生成的授权码代替登录密码
「发件人」「收件人」	是	在「收发」里。收件人多个用英文逗号分隔

表单里有「发一条测试」。

Pushplus

字段	必填	说明
「Token」	是	Pushplus 账号的 Token
「群组编码」	否	发给群组时填，留空发给自己
「渠道」	否	「微信」「Webhook」「企业微信」「邮件」

浏览器推送

把通知推到浏览器或手机的通知栏，不需要第三方账号。渠道在服务端开一次，每台要接收的设备各自订阅一次。

字段	必填	说明
「联系方式」	否	`mailto:` 或 `https://` 开头，推送服务出问题时联系你用
「控制台地址」	否	点通知后打开的地址，留空用当前站点

「此浏览器」里是这台设备的「订阅状态」与「订阅推送」「取消订阅」「发测试推送」。「已订阅的设备」列出所有订阅过的设备，当前这台标「当前设备」，连续投递失败的标出次数。

必须用 https:// 地址或 localhost 访问 nSIM，普通 http:// 地址下浏览器不提供推送能力。
在 iPhone、iPad 上，只有从主屏幕图标打开 nSIM 时才能订阅。
鸿蒙 NEXT 的浏览器不提供推送能力。
各平台从主屏幕打开后的能力差别，见把 nSIM 加到手机主屏幕。

Webhook

把通知以 HTTP POST 发到你自己的服务。只发不收，不接受命令。

字段	必填	说明
「目标地址」	至少一个	接收地址，点「添加地址」可加多个
「签名密钥」	否	填了之后每个请求带 `X-NSIM-Signature: sha256=<十六进制>`，值是用这个密钥对原始请求体算的 HMAC-SHA256
「自定义请求头」	否	例如 `Authorization`。`Content-Type` 与 `X-NSIM-Signature` 由系统设置，填同名的会被忽略
「文本模板」	否	可用占位符 `{{text}}` `{{event}}` `{{timestamp}}` `{{device_id}}` `{{device_name}}` `{{device_label}}`；留空发原始文本
「请求超时」	否	在「超时与重试」里，单位毫秒，1000–60000
「最大重试次数」	否	在「超时与重试」里，0–10，0 为不重试

表单里有「发一条测试」。

请求体是 JSON：

{
  "event": "sms_received",
  "timestamp": "2026-01-01T08:00:00+08:00",
  "text": "通知文本",
  "meta": {
    "device_id": "<设备 ID>",
    "device_name": "<设备名>",
    "device_label": "<设备名> (<设备 ID>)",
    "event": "sms_received",
    "timestamp": "2026-01-01T08:00:00+08:00"
  }
}

event 常见的取值：sms_received（收到短信）、incoming_call（来电）、missed_call（未接来电）、call_on_sip_client（在 SIP 客户端上接起）、ip_rotated（换 IP 完成）。其他通知的取值可能是 raw 或 notification。

机器人命令

Telegram、飞书、QQ 机器人能接收以下命令。机器人只认配置里的会话：

Telegram：「Chat ID」里的会话。
飞书：「Chat IDs」里的群。
QQ：「接收人」里的 OpenID。

命令	作用
`/list`	设备总览
`/status [设备ID]`	某台设备的状态
`/sms`	查看短信
`/send [设备ID] [号码] [内容]`	发短信
`/compose`	分步写短信
`/rotate`	换 IP
`/esim`	查看 eSIM Profile
`/switch [设备ID] [序号或ICCID]`	切换 eSIM Profile
`/vocall [设备ID] [号码] [保持秒数]`	经 VoWiFi 拨一通电话
`/run [脚本名或ID]`	运行自动化脚本
`/runs`	查看自动化运行
`/input [运行编号] [内容]`	给等待输入的脚本交输入

这些命令会真的发短信、拨号、切换 eSIM，能在那个会话里发言的人都能用。