通过洋葱头短信接口在影刀 RPA 中自动获取登录验证码

一、适用场景

当你在影刀 RPA 中自动登录网站时，如果网站采用“手机号 + 短信验证码”方式登录，可以通过洋葱头提供的短信助手和短信查询接口，自动读取手机收到的验证码短信，并将验证码回填到网页输入框中。

本文以“登录阿里云网站”为例，说明完整配置流程。

二、整体流程

整个流程分为 4 段：

1.在洋葱头控制台创建阿里云应用，并在高级选项中配置短信签名和关键词规则
2.在安卓手机上安装并登录洋葱头短信助手，让手机收到的短信可以被同步读取
3.在洋葱头控制台获取短信助手登录 Token，并准备 OpenAPI 调用所需的 Secret
4.在影刀 RPA 中配置自动化流程：触发发送验证码、调用短信接口、提取验证码、自动回填并登录

三、准备条件

开始前，请先确认以下条件已满足：

① 你有一台安卓手机，并且这台手机可以正常接收登录验证码短信
② 你已经注册并登录洋葱头账号
③ 你已经安装影刀 RPA
④ 你用于登录网站的手机号，就是短信助手所在手机实际接收短信的手机号
⑤ 你已经在洋葱头控制台创建目标网站应用，并准备好对应短信签名
⑥ 你已经拿到用于调用 OpenAPI 的 Secret

四、操作步骤

步骤 1：先创建阿里云应用并配置短信签名

在使用短信助手和短信查询接口前，建议先在洋葱头控制台中创建对应的网站应用。以阿里云为例，用户需要先创建“阿里云应用”，并在高级选项中配置短信签名。短信助手会根据管理员配置的签名和关键词规则，识别并读取符合条件的短信。

1. 添加阿里云应用

进入洋葱头控制台应用管理页面：

• https://console-onion.oray.com/console/account-share/website-app

在页面中新增一个网站应用，例如：

① 应用名称：阿里云
② 网站登录URL：https://account.aliyun.com/login/login.htm
③ 网站首页URL：https://www.aliyun.com

2. 在高级选项中配置短信签名

添加应用后，进入该应用的高级选项，配置短信签名。

短信签名是验证码短信中常见的签名内容，例如：

【阿里云】

短信助手会根据你配置的短信签名去匹配短信内容，只有命中规则的短信才会被读取和转发。

步骤 2：安装并登录短信助手

1. 安装短信助手

在安卓手机上访问洋葱头官网下载页：

• https://yct.oray.com/download/

按照页面提示安装“短信助手”。

2. 获取短信助手登录 Token

登录洋葱头控制台后，进入短信助手管理页面：

• https://console-onion.oray.com/console/account-share/team-sms

在页面中获取短信助手登录 Token。

3. 在手机上登录短信助手

打开安卓手机上的短信助手，输入刚才获取到的 Token 完成登录。

4. 授权短信读取权限

首次使用时，安卓系统通常会要求授予以下权限：

① 短信读取权限
② 通知或后台运行相关权限
③ 电池优化白名单权限（如系统有要求）

建议全部按提示授权，否则短信助手可能无法正常读取短信。

5. 验证是否接入成功

可以先用目标手机号接收一条测试短信，确认短信助手已经能正常读取短信内容。

步骤 3：确认短信查询接口可用

洋葱头获取短信验证码的接口说明见官方文档：

• https://service.oray.com/question/50856.html#data-17

短信接口为：

GET https://openapi.yctou.net/openapi/v2/sms/list?mobile=13711111119

请求头示例：

Authorization: Bearer <你的Secret>

这个 Secret 用于影刀 RPA 发起 HTTP 请求，调用洋葱头的短信查询接口。
secret获取方式：
① 洋葱头控制台 API Key 页面
② 地址：https://console-onion.oray.com/console/sys-setting/api-keys?page=1&size=20

返回示例

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": 9001,
      "mobile": "13711111119",
      "content": "【阿里云】您本次登录验证码为 123456，请勿泄露给他人。",
      "receive_time": 1700000000000,
      "team_application_id": 1001,
      "team_application_name": "企业CRM"
    }
  ]
}

接口说明

① mobile：按手机号查询短信
② content：短信正文，验证码一般就在这个字段里
③ 接口默认返回最近 10 分钟内的短信记录
④ 结果按接收时间倒序排列，通常第一条就是最新短信

步骤 4：在影刀 RPA 中配置自动登录流程

下面以“登录阿里云网站”为例说明。

流程目标

实现以下自动化过程：

1.打开阿里云登录页
2.切换到“手机号登录”
3.输入手机号
4.点击“获取验证码”
5.等待短信到达
6.调用洋葱头短信接口获取最新短信
7.从短信内容中提取验证码数字
8.将验证码填写到网页输入框
9.点击登录

五、影刀 RPA 推荐流程

步骤见下文。

1. 打开网页

在影刀中添加“打开网页”步骤，打开阿里云登录页。

2. 点击“手机号登录”

如果默认不是短信登录方式，先点击页面中的“手机号登录”。

3. 输入手机号

在手机号输入框中填写要登录的手机号，例如：

13711111119

实际运行时，影刀流程变量中应填写真实手机号。

4. 点击“获取验证码”

添加点击操作，触发网站发送短信验证码。

5. 等待短信到达

添加一个“等待”步骤，建议先等待 15~20 秒。

原因：
① 网站发送验证码需要时间
② 手机接收短信需要时间
③ 短信助手同步短信也需要一点时间

如果网络较慢，可适当延长到 20~30 秒。

6. 发起 HTTP 请求获取短信

在影刀中添加“HTTP 请求”步骤，配置如下。

请求方式

GET

请求地址

实际在影刀流程中，请传入真实手机号变量，例如：

https://openapi.yctou.net/openapi/v2/sms/list?mobile=${手机号变量}

请求头

Authorization: Bearer <你的Secret>

如果影刀支持单独配置 Header，请新增一项：

• Key：Authorization
• Value：Bearer <你的Secret>

7. 将 HTTP 返回内容转成 JSON

短信接口返回的是 JSON 字符串。在影刀中添加“转换成 Json 对象”步骤，将 HTTP 返回的内容转成 Json 对象，方便后续提取字段。

通常转换对象来源是：

http_response.content

8. 提取短信正文 content

接口返回的关键字段是：

data[0].content

也就是“最新一条短信的正文”。

你需要在影刀中把最新短信的 content 提取出来，并保存为变量，例如：

指令输入-数据：

json_instance

指令输入-待提取键名：

"content"

指令输出-返回：

code

则返回数据里第一条短信内容：

【阿里云】您本次登录验证码为 123456，请勿泄露给他人。

那么后续就要从这段文本中继续提取纯数字验证码。

9. 从短信正文中提取验证码数字

在影刀中添加“从文本中提取内容”步骤，从短信正文里提取数字。

建议使用“提取数字”或正则方式，得到类似：

123456

并保存为变量，例如：

verifycode

如果影刀支持正则表达式，常见可用规则为：

\d{4,8}

说明：

① \d 表示数字 ② {4,8} 表示匹配 4 到 8 位数字 ③ 大多数验证码都是 4 位、6 位或 8 位

10. 将验证码填写到网页输入框

在影刀中添加“填写输入框(web)”步骤，将变量 verifycode 填入验证码输入框。

11. 点击登录

最后添加“点击登录”步骤，完成自动登录。

六、常见问题

1. 接口请求返回 401

通常是鉴权信息有问题，重点检查：

① 是否携带了 Authorization 请求头
② 请求头格式是否为 Bearer <你的Secret>
③ Secret 是否填写错误
④ Secret 是否已失效

2. 接口返回成功，但没有短信数据

常见原因：

① 手机没有收到验证码短信
② 没有先创建阿里云应用
③ 没有配置正确的短信签名或关键词
④ 短信助手未登录成功
⑤ 短信助手没有短信读取权限
⑥ 查询手机号与实际收短信手机号不一致
⑦ 距离点击“获取验证码”时间太短，短信还未同步上来

建议：

① 先等待 20 秒后再查一次
② 检查网站应用是否已创建
③ 检查短信签名和关键词是否与真实短信内容一致
④ 检查短信助手是否在线
⑤ 检查手机是否真的收到了短信

3. 提取到了短信正文，但没有提取出验证码

通常是“提取规则”不对。建议先打印短信正文，再确认验证码格式是否为纯数字。

例如正文为：

【阿里云】您本次登录验证码为 123456，请勿泄露给他人。

则一般使用 \d{4,8} 就可以匹配出 123456。

4. 提取到了错误的验证码

可能原因：

① 同一时间收到了多条不同平台的短信
② 读取到了较早的一条短信
③ 你的提取规则过于宽泛

建议：

① 优先取最新一条短信
② 只对包含 阿里云 或 验证码 的短信做提取
③ 必要时增加二次校验

七、官方参考

1.短信助手安装入口：https://yct.oray.com
2.网站应用添加入口：https://console-onion.oray.com/console/account-share/website-app
3.短信助手 Token 获取页面：https://console-onion.oray.com/console/account-share/team-sms
4.OpenAPI Secret 获取页面：https://console-onion.oray.com/console/sys-setting/api-keys?page=1&size=20
5.短信签名配置说明：https://service.oray.com/question/49260.html#data-2
6.洋葱头 OpenAPI 文档：https://service.oray.com/question/50856.html#data-17