跳转至

Air8783短信转发本地配置使用说明

一、功能概述

1.1 短信转发功能概述

1.1.1 什么是短信转发？

把短信转发器上收到的短信，自动转发到另一台手机、另一张 SIM 卡、飞书 / 钉钉 / 企微Webhook

1.1.2 核心价值：

短信不在你手上的那台设备，让你在自己常用终端拿到短信内容。

主要解决：不能注销但是又不常用的手机卡短信查看、无人设备收验证码、欠费告警、短信归集、系统自动化、日志留存。

1.1.3 实际场景应用：
1.1.3.1 设备无人值守场景

设备放在机房、野外、柜子里，没人看屏幕，但设备插 手机SIM 卡会收短信（验证码、告警短信、运营商通知）

  1. 远程查看设备收到的验证码

  2. 问题：远端物联网设备收到平台验证码、登录校验短信，设备本地没人，拿不到验证码没法继续操作。

  3. 作用：短信自动转发到运维手机，人在办公室就能拿到验证码，不用跑现场。

  4. 运营商告警、欠费提醒及时通知

  5. 问题：设备 SIM 卡欠费、流量告警、余额提醒，短信只存在设备里，设备没人看，欠费停机了才发现。

  6. 作用：欠费短信直接转发给管理员手机 / 钉钉机器人，提前续费，避免设备离线。

  7. 接收外部指令短信 别人给设备号码发短信指令，设备处理同时，把这条指令转发给管理人员，留存操作记录，知道谁下发过指令。
1.1.3.2 多卡、多手机号分离使用
  1. 副卡专门收验证码，不拿副卡手机

  2. 问题：一张卡放在模组 只用来注册账号收验证码，自己日常不用拿这台设备。

  3. 解决：所有验证码短信自动转发到主力手机，只用主力机看全部验证码，不用切换设备。

注意：很多互联网账号有风控，频繁转发验证码，部分平台会判定风险。

  1. 一机多号，消息统一归集 两张手机SIM卡，一张工作、一张私人，分别在不同设备，全部短信转发到一台手机，不用来回切换设备看短信。
1.1.3.3 对接系统，自动化业务

推送到企业 IM 告警（钉钉 / 飞书/企业微信机器人） 设备收到任意短信，自动发消息到运维群。

实际痛点：半夜设备收到运营商异常短信，不用登录设备远程读取，群里直接弹窗告警。

1.1.3.4 备份留痕审计

  • 问题：模组重启之后，部分 4G 模组短信缓存会丢失，短信直接丢了，查不到历史记录。

  • 作用：收到短信立刻转发存储，做日志留存，方便事后排查故障、审计操作记录。

1.2 短信转发实现原理

1.3 短信转发配置转发地址的方法

  1. 通过接收特殊短信指令本地即可修改转发配置：

指令短信格式：密码#指令#参数JSON

  1. 默认初始密码123456，支持短信指令修改密码；

所有配置短信必须携带正确密码才生效，拒绝非法短信篡改

  1. 可配置项：

钉钉 webhook/secret/自定义HTTP header(最多1个）

飞书 webhook/ver_token/自定义HTTP header(最多1个）

企微 webhook/自定义HTTP header(最多1个）

phones 转发手机号数组(最多5个)

  1. 收到普通业务短信 → 执行转发逻辑（钉钉 / 飞书 / 企微 http 推送、转发给 phones 手机号）

  2. 收到带密码的配置指令短信 → 解析指令，校验密码，成功后更新内存 +fskv持久化存储；回复结果短信给发送方；密码错误直接丢弃，不处理

二、硬件准备

Air8783，支持短信收发的手机卡，插到Air8783设备卡槽上，Air8783插到电脑USB口；

另准备任意可以发短信的手机，给Air8783发配置指令短信

注意：

  1. 物联网卡不适用，请使用支持4G的手机SIM卡

  2. 除了转发给钉钉 / 飞书 / 企微是http 推送，消耗卡的4G流量，其他所有的短信发送都是消耗卡的短信费 。

三、指令说明

任意手机号给Air8783设备发送指令短信即可完成配置，前提是格式和密码正确

3.1 指令：

3.1.1 指令短信完整内容格式：

指令短信完整内容格式：密码#指令CMD#参数JSON

比如修改初始密码123456改为654321，指令短信为：123456#SETPWD#{"new_pwd":"654321"}，

更多指令参考下述 3.2 示例 章节

3.1.2 指令集：
指令CMD 功能 参数json 短信回执
SETPWD 修改密码 {"new_pwd":"6位字符"} 【配置失败】密码错误
【配置失败】new_pwd必须不少于6位字符
【配置成功】密码修改完成
DING 设置钉钉配置 {"webhook":"xxx","secret":"SECxxx","custom_headers":{}} 【配置失败】JSON解析错误
【配置成功】钉钉配置已更新
FEISHU 设置飞书配置 {"webhook":"xxx","ver_token":"xxx","custom_headers":{}} 【配置失败】JSON解析错误
【配置成功】飞书配置已更新
QIWEI 设置企微配置 {"webhook":"xxx","custom_headers":{}} 【配置失败】JSON解析错误
【配置成功】企业微信配置已更新
PHONES 新增手机号 {"list":["13800000000","13900000000"]} 【配置失败】JSON 解析错误
【绑定失败】已达到最大绑定手机号数量
【提交候选完成】发起 N 条验证码，回复验证码完成绑定，XX 秒超时
【绑定成功】该号码加入短信转发列表
PHONEREPLACE 替换手机号 {"old":"旧号码","new":"新号码"} 【配置失败】JSON 解析错误
【配置失败】旧号码不在已绑定列表
【提交替换候选】向新手机号下发验证码，回复 4 位数字完成替换，旧号码保持生效
【替换绑定成功】已将设备转发旧号码1**********替换为本号码。
PHONESCLEAR 清空全部已绑定手机号 {} 【PHONESCLEAR 成功】已清空全部绑定手机号，同时清除待验证任务
GETCFG 查询全部配置 {} 【当前配置】{完整 json 配置字符串}

3.2 指令示例：

任意手机号给Air8783设备发送指令短信即可完成配置，前提是格式和密码正确

指令短信完整内容格式：密码#指令CMD#参数JSON

示例 1：SETPWD修改密码，初始密码123456改为654321

123456#SETPWD#{"new_pwd":"654321"}

示例 2：DING设置钉钉配置

654321#DING#{"webhook":"https://xxx","secret":"SECxxx","custom_headers":{"k":"v"}}

示例 3：FEISHU设置飞书配置

654321#FEISHU#{"webhook":"https://xxx","ver_token":"abc","custom_headers":{}}

示例 4：QIWEI设置企业微信(无加签)，可做通用http接口对接自定义webhook,支持配置custom_headers，即自定义HTTP header

654321#QIWEI#{"webhook":"https://xxx","custom_headers":{}}

示例 5：PHONES设置被转发手机号列表 phones(上限5个，需要回复验证码才能完成配置，防止被恶意配置骚扰)

654321#PHONES#{"list":["13800000000","13900000000"]}

示例 6：GETCFG读取当前全部配置（设备会回一条短信把当前配置返回给发送号码）

654321#GETCFG#{}

示例7：PHONEREPLACE替换手机号（旧号必须已经在生效列表，新号收验证码回复）

123456#PHONEREPLACE#{"old":"13800000000","new":"13700000000"}

示例8：PHONESCLEAR一键清空全部已绑定手机号

123456#PHONESCLEAR#{}

示例9：删除已经配置的URL (对应CMD参数为空即可)

654321#FEISHU#{"webhook":"","ver_token":""}

初始默认密码：123456，收到 SETPWD 指令可以修改密码，密码持久化保存。

3.3 指令执行规则：

  1. 短信不满足 密码#CMD#参数json 格式 → 判定普通短信，走转发业务；

  2. 密码错误，直接丢弃配置指令，不回复；

  3. JSON 解析失败，回复短信：【配置失败】JSON格式错误；

  4. 指令执行成功回复发送方短信，返回执行结果，回复短信会消耗Air8783设备卡的短信资费。

四、实操效果

4.1 配置钉钉/飞书/企业微信

a8e18ed9\-6134\-4645\-b1c7\-1483cf53ea01\.png

4.2 钉钉收到设备转发的短信

022dd0fac767640b61997d68cdc481d9\.png

4.3 钉钉收到设备转发的短信

779365973182100e3dfafd5acd0805d1\.png

4.4 企业微信收到设备转发的短信

loading-ag-482

4.5 清空手机号数组、重新添加手机号、收到转发的短信

image\.png

4.6 替换接收短信的手机号

82a60f09\-560e\-41b0\-a506\-8d0b4328e0f0\.png

五、钉钉 / 飞书 / 企微 的 webhook/secret/ver_token获取方法

5.1 钉钉

群自定义机器人

  1. 钉钉群 →右上角... →群管理 →机器人 →添加机器人 →【自定义机器人】

  2. 填写机器人名称，安全设置勾选 加签

  3. 复制：

  4. Webhook：https://oapi.dingtalk.com/robot/send?access_token=xxx

  5. Secret：SECxxxx（页面关闭后不可回看，务必保存）

5.2 飞书

群自定义机器人

  1. 飞书群 →右上角... →群设置 →群机器人 →添加机器人 →自定义机器人

  2. 填写名称，安全设置勾选签名校验

  3. 复制：

  4. Webhook：https://open.feishu.cn/open``‑apis/bot/v2/hook/xxx

  5. Secret (即配置指令中的ver_token)：43 位 base64 字符串（页面关闭后不可回看，务必保存）

5.3 企业微信

群自定义机器人

  1. 企微信群 →右上角... →添加群机器人

  2. 直接得到 Webhook 地址 https://qyapi.weixin.qq.com/cgi``‑bin/webhook/send?key=xxx

企微群机器人没有 secret 加签，仅靠 URL 里的key鉴权，安全保护只能自行确保 webhook url 不泄露

搜索