面向业务的接口接入
沿用 WorkTool 指令结构与现有接口路径。通过机器人 ID 发布文本、建群和加成员任务，再查询对应的执行结果。
查看接口示例 →什么是 QU-helper 数字助手？
把手机端的重复操作，变成可管理、可追踪的任务。
手机负责执行，
后台掌握每一步。
QU-helper 连接安卓机器人与业务系统，在管理后台统一授权设备、发布任务，查看运行日志与执行结果。通过已有 API 路径，将消息和群操作接入你的业务流程。
- 机器人 ID 接入，设备信息集中查看
- 同机器人串行投递，执行记录可追踪
- 群操作成功后，查看群码获取结果
任务执行流程流程示意新建群并拉人
发布任务后，自动追踪执行状态
- 任务受理
生成任务标识，进入待投递队列
- 设备接收
记录执行设备，开始群操作
- 结果回传
查看执行结果与群码获取状态
受理 ≠ 执行成功 · 结果以设备回传为准
从指令到结果，全流程可追踪
关联任务 ID、执行设备和提交、投递、完成、回调时间。群码获取失败会单独标记，便于核验处理。
查看执行流程 →从设备接入到执行结果，基础能力一站管理
围绕已经实现的功能，搭建你的自动化流程。
安卓设备接入
通过机器人 ID 连接服务，集中查看设备型号、系统版本与连接 IP。
机器人授权
管理授权期限与设备数量，达到上限时确认替换空闲设备。
文本消息发送
选择联系人或群聊，发布单目标文本任务，查看设备执行结果。
建群与添加成员
支持新建群并拉人、已有群加成员两种任务类型。
群码结果查看
回传解码后的群码链接，在后台预览、复制和下载二维码。
任务与回调日志
查看任务状态、时间节点、运行记录和设备结果回传。
业务 API
业务系统提交指令并查询结果，关联任务 ID 与消息 ID。
自建部署
管理服务、数据库与安卓设备连接地址由你配置和维护。
为什么选择 QU-helper
围绕设备、任务和结果，构建可掌握的自动化基础。
服务自主部署
- 后端和数据库自主运行
- 支持本地局域网联调
- 后台与官网同源访问
设备管理清晰
- 授权设备数与在线数量
- 设备信息与连接 IP
- 任务关联实际执行设备
执行过程透明
- 任务与设备结果关联
- 运行日志与回调记录
- 未知结果保留待核验
开始使用，连接你的第一台机器人
准备一台安卓设备和可访问的 QU-helper 服务。
- 1
创建并授权机器人
在后台创建机器人，设置授权有效期和允许接入的设备数量。
了解接入流程 → - 2
安装安卓客户端
下载安装包，填写机器人 ID，按提示完成权限配置。
下载安卓正式版 2.8.4 → - 3
发布并核验任务
确认设备在线，发布文本或群操作任务，在任务页查看执行结果。
查看接口示例 →
当前提供安卓正式版 2.8.4。无障碍服务用于手机操作；读取群码图片时需按系统提示授予相册权限。
把自动化，
接入你的业务系统。
保留已有接口路径。使用机器人 ID 发布任务，通过消息 ID 查询结果，逐步融入业务流程。
- 文本发送：type 203
- 新建群并拉人：type 206
- 已有群加成员：type 207
文本任务 · 请求示例
POST /wework/sendRawMessage?robotId=YOUR_ROBOT_ID
Content-Type: application/json
{
"socketType": 2,
"requestId": "your-unique-request-id",
"list": [{
"type": 203,
"titleList": ["联系人或群名称"],
"receivedContent": "你好，来自 QU-helper"
}]
} 结果查询：GET /wework/taskResult?robotId=YOUR_ROBOT_ID&messageId=MESSAGE_ID
接口受理仅表示入队。使用稳定 requestId 核对任务，结果未知时请先人工核验。
常见问题
一个机器人 ID 可以连接多台设备吗？
可以，在线数量受后台授权设备数限制。达到上限后，新设备需确认替换空闲设备；正在执行任务或等待结果的设备不会自动踢下线。同一个机器人仍按任务顺序串行执行。
群操作成功，但没有拿到群码怎么办？
群操作结果与群码获取结果分别记录。若群操作已成功而群码读取失败，请检查二维码页面及相册权限，先核验群是否已创建，避免重复建群。
回调记录会推送到外部业务地址吗？
当前支持设备执行结果回传、后台查看和业务 API 查询。对外 HTTP 回调推送尚未实现，业务系统需通过结果查询接口获取状态。
网页中的流程示意是实时数据吗？
官网用于产品介绍，流程图为示意。实时设备数量、任务状态及日志需登录管理后台查看。
让机器人接手重复工作
从一台设备、一个任务开始，搭建自己的自动化流程。