1. 概述

在传统场景下，短信通常只保留在单一手机设备中，验证码获取依赖人工查看和转发，不仅处理效率低，也会影响多人协作和统一管理。

通过洋葱头提供的短信自动转发功能，企业可以将手机号接收到的短信按预先配置的规则自动转发到指定通道，例如洋葱头浏览器、飞书群、企业微信群、钉钉群或第三方系统接口。

员工在登录网站或系统时，可根据事先配置好的短信转发规则与通道，自动获取短信验证码，从而提升登录效率和协作效率。

该功能可帮助企业：
①提高验证码接收和分发效率
②降低人工查看、复制和转发短信的操作成本
③支持多人协作共享短信内容
④支持按规则将短信自动同步到群聊或业务系统 ⑤提升企业在账号管理和日常运营中的整体效率

2. 使用介绍

2.1 页面入口

登录管理员账号访问洋葱头控制台。左侧导航中，进入 账号管理 > 手机短信 页面。

2.2 操作流程

2.2.1 添加手机号

手机号是短信转发配置的基础。您可通过自动上报或手动添加两种方式接入手机号。

方式一：通过短信助手 APP 自动上报

适用场景： 在手机上安装短信助手 APP 以读取验证码

操作步骤：
①在 Android 手机上访问洋葱头官网下载页，安装短信助手 APP；
②使用短信助手 token（即令牌）登录短信助手，见下图；
③登录成功后，系统会自动上报当前设备手机号；
④返回手机短信页面，在手机号列表中查看该号码；（若2分钟内仍未看到手机号，可手动添加）

方式二：手动添加手机号

适用场景： 使用 IOT 设备等第三方系统，非洋葱头短信助手 APP 来读取短信

操作步骤：

①进入手机短信页面
②点击页面右上角“添加手机号”
③填写手机号，可一并填写多条
④点击确定。保存成功后，手机号将显示在列表中

2.2.2 为手机号新增短信匹配规则

每个手机号下都可以配置一条或多条短信匹配规则。规则用于定义哪些短信需要被转发。

操作步骤： 在目标手机号下，点击“新建规则”，可根据下方字段说明进行配置。

字段	说明
规则名称	可选择复用已有规则或创建新的规则。 规则名称用于区分不同用途的规则，建议根据业务含义命名，例如：转发全部短信、在洋葱头登录巨量引擎、蝉妈妈等平台、向飞书群聊转发业务告警短信
匹配方式	1、全部短信：适用于需要转发该手机号收到的全部短信的场景。 2、按特征筛选：适用于仅转发特定短信的场景。 ①短信签名：必填，用于标识短信来源，可填写多个，用 ; 分隔。 ②短信关键词：选填，用于缩小匹配范围，可填写多个，用 ; 分隔。 规则效果：仅当短信命中已配置的签名和关键词条件时，系统才会执行转发。
转发通道	将短信转发至洋葱头或企业工作台。配置方式见下文

2.2.3 配置不同类型的转发通道

每条短信匹配规则都可以绑定一个或多个转发通道。短信一旦命中规则，即会同时转发到所有已配置的通道。

1. 洋葱头通道

洋葱头通道用于将命中的短信转发到洋葱头浏览器或洋葱头 APP。

字段	说明
通道名称	对通道的命名或备注
绑定应用	1、不指定应用： 如果不指定网站应用，则： ①用户在洋葱头浏览器的新标签页中不会看到该手机号账号； ②登录任意网站时，只要短信符合规则，系统都会转发短信内容。 2、指定应用： 如果指定网站应用，则： ①需要从控制台已有的网站应用列表中选择一个应用； ②用户可在洋葱头浏览器新标签页对应应用下看到该手机号账号。
选择应用	指定应用时出现，单选。应用列表来自控制台-网站平台。
授权成员	洋葱头通道支持配置授权成员。配置后，在洋葱头浏览器或洋葱头 APP 中，处于授权范围内的成员都可以接收该手机号转发的短信内容。 适用场景：团队共享验证码、多成员协作登录网站。

转发效果：
①在洋葱头浏览器PC端中接收验证码。 可点击浏览器右上角“手机短信”插件，打开后就能看到10分钟内收到的验证码，点击复制可一键获取验证码。 ②在洋葱头浏览器APP中接收验证码。 访问洋葱头官网，或者在手机应用商店搜索“贝锐洋葱头”即可安装APP。在APP中登录账号后，可在“短信”页面获取短信内容。

2. 飞书通道

飞书通道用于将短信通过机器人发送到飞书群聊。飞书机器人配置方式可见官方文档。

字段	说明
通道名称	对通道的命名或备注
Webhook URL	机器人通知地址，必填，从飞书中获取。
密钥	可选，用于飞书机器人开启签名校验时填写

下图为飞书机器人配置页

转发效果： 短信命中规则后，洋葱头会将短信转发给飞书机器人，实现在飞书群聊就可以收到短信内容。

3. 企微通道

企微通道用于将短信通过机器人发送到企业微信群聊。

字段	说明
通道名称	对通道的命名或备注
Webhook URL	机器人通知地址，必填，从企微群聊中获取

转发效果： 短信命中规则后，洋葱头会将短信转发给企业微信机器人，实现在企微群聊就可以收到短信内容。

4. 钉钉通道

钉钉通道用于将短信通过机器人发送到钉钉群聊。

字段	说明
通道名称	对通道的命名或备注
Webhook URL	机器人通知地址，必填，从钉钉群聊中获取。
加密密钥	可选，用于钉钉机器人开启安全校验时填写

转发效果： 短信命中规则后，洋葱头会将短信转发给钉钉机器人，实现在钉钉群聊就可以收到短信内容。

5. Webhook 通道

Webhook 通道适用于将短信内容推送到第三方平台或业务系统。

配置项说明

字段	说明
通道名称	对通道的命名或备注
Webhook URL	第三方平台的 webhook 地址，用来接收短信内容
请求方法	POST / GET / PUT / PATCH
请求头	格式：key 和 value，每行一组。如 Authorization: Bearer xxx

转发效果： 短信命中规则后，系统会按照所配置的请求方式和请求头，将短信内容推送到指定第三方接口。

适用场景： ①第三方平台接收短信
②业务系统自动处理短信内容
③与外部系统进行自动化对接

2.2.4 编辑已有规则

如果需要调整规则名称、匹配条件或通道配置，可直接编辑已有规则。

操作步骤： ①在目标手机号下找到需要修改的规则；
②点击规则一行右侧的“编辑”按钮；
③修改规则名称、匹配方式或通道配置；
④点击确认保存。

3. 常见配置示例

示例一：转发全部短信到洋葱头

适用场景： 希望某个手机号收到的所有短信都同步到洋葱头。

配置方法：
①添加或选中已有手机号；
②新建规则；
③选择“全部短信”；
④添加转发通道，选择“洋葱头”，不指定应用；
⑤保存规则。

示例二：将验证码短信转发到飞书群

适用场景： 团队成员需要在飞书群中统一接收登录抖店的验证码。

配置方法：
①添加或选中已有手机号；
②新建规则；
③选择“按特征筛选”；
④填写短信签名“抖店”；
⑤按需填写关键词，例如“验证码”；
⑥添加转发通道，选择“飞书”；
⑦填写飞书机器人 Webhook URL；
⑧保存规则。

示例三：将指定短信推送到第三方系统

适用场景： 业务系统需要自动接收短信内容并进行后续处理。

配置方法：
①添加或选中已有手机号；
②新建规则；
③选择“全部短信”；
④添加转发通道，选择“Webhook”；
⑤配置接口地址、请求方法和请求头；
⑥保存规则。