server/htsy-skill
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add RPA device, app, and task API reference

Browse Source
This commit is contained in:
dcsunny
2026-07-16 15:11:08 +08:00
parent daa2d12b61
commit 064a05354e
4 changed files with 89 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
agents/openai.yaml
+1 -1
View File
@@ -1,6 +1,6 @@
interface:
display_name: "海豚私域 Htsy"
short_description: "通过 htsy-cli 调用海豚私域账号、微号、客户、群、素材、自动化和客服接口"
short_description: "通过 htsy-cli 调用海豚私域账号、微号、客户、群、素材、自动化、RPA 和客服接口"
default_prompt: "使用 $htsy 通过 htsy-cli 登录并调用海豚私域接口。"
policy:
htsy/SKILL.md
+2 -1
View File
@@ -1,6 +1,6 @@
---
name: htsy
description: 当用户需要通过海豚私域 htsy-cli 操作账号、用户、登录注册、席位、角色、微号、客户、标签、群、素材、话术库、关键词、SOP、群发、营销计划、客服或知识库接口时使用本 skill。本 skill 面向公开业务使用场景，说明 htsy-cli 登录状态检查、接口路径选择、JSON 请求体字段编写方式，以及如何把接口结果整理成自然、有人味的业务回复。
description: 当用户需要通过海豚私域 htsy-cli 操作账号、用户、登录注册、席位、角色、微号、客户、标签、群、素材、话术库、关键词、SOP、群发、营销计划、RPA 设备与应用、客服或知识库接口时使用本 skill。本 skill 面向公开业务使用场景，说明 htsy-cli 登录状态检查、接口路径选择、JSON 请求体字段编写方式，以及如何把接口结果整理成自然、有人味的业务回复。
---
# 海豚私域 Htsy
@@ -39,6 +39,7 @@ htsy-cli call /api/bot/wx/list -d @request.json
- 群、群成员、群分组、群管理、群公告、欢迎语、群守卫、群查重、群转播、批量入群/邀请：读 [api-group.md](references/api-group.md)。
- 素材、话术库、话术分类/标签、上传 token：读 [api-material.md](references/api-material.md)。
- 关键词、SOP、群发、快速推送、朋友圈、订阅、社群氛围、监听、中控群、淘客：读 [api-automation.md](references/api-automation.md)。
- RPA 设备、应用、设备分组、消息转发、群管任务：读 [api-rpa.md](references/api-rpa.md)。
- 客服会话、客服消息、AI 回复、知识库、飞书配置：读 [api-customer.md](references/api-customer.md)。
- 不确定模块时先读 [htsy-api.md](references/htsy-api.md) 索引。
htsy/references/api-rpa.md
+85
View File
@@ -0,0 +1,85 @@
# RPA 设备、应用与任务
阅读本文件处理 RPA 设备、应用购买与转移、设备分组、消息转发和群管任务。这里的 `deviceId`/`deviceID` 都指 RPA 设备 ID，不是微号 `botId`；请求字段名必须按各接口表格使用。
## 目录
- [设备](#设备)
- [应用](#应用)
- [设备分组](#设备分组)
- [消息转发](#消息转发)
- [群管](#群管)
- [常用示例](#常用示例)
## 设备
| 目标 | 接口 | 请求字段 | 常用返回字段 |
| --- | --- | --- | --- |
| 设备列表 | `POST /api/rpa/device/list` | `page`(int64, 必填)；`pageSize`(int64, 必填)；`userId`(int64, 可选，主账号按用户筛选)；`appId`(int64, 可选，执行应用 ID)；`name`(string, 可选，设备名称)；`groupID`(int64, 可选，`-1` 未分组、`0` 全部、正数为指定分组) | `items`(repeated DeviceItem，含 `id`, `name`, `execApplicationId`, `expireTime`, `userID`, `userName`, `botType`, `botName`, `botStatus`, `execAppName`)；`page`；`pageSize`；`total`；`last` |
| 设备详情 | `POST /api/rpa/device/info` | `id`(int64, 必填，设备 ID) | `id`；`name`；`execApplicationId`；`expireTime`(毫秒)；`ip`；`port`；`guid`；`botType`；`botName`；`botStatus`；`appInfo`(应用名称、可执行文件、图标、版本、32/64 位下载地址及自动更新配置) |
| 更新设备应用配置 | `POST /api/rpa/device/appUpdate` | `deviceID`(int64, 必填)；`applicationID`(int64, 必填)；`autoUpdate`(bool, 必填)；`updateStart`(string, 必填，`HH:mm:ss`)；`updateEnd`(string, 必填，`HH:mm:ss`)；`forceSystemBit`(int32, 必填，`32`/`64`，`0` 不强制) | 空对象或无业务数据 |
| 删除设备 | `POST /api/rpa/device/delete` | `deviceIDs`(repeated int64, 必填，只能删除没有应用的设备) | 空对象或无业务数据 |
| 切换执行应用 | `POST /api/rpa/device/switchExecApplicationId` | `deviceID`(int64, 必填)；`applicationID`(int64, 必填) | 空对象或无业务数据 |
| RPA 客户端信息 | `POST /api/rpa/client/info` | `{}` | `version`(版本号)；`download`(下载地址)；`updateInfo`(更新信息) |
| 设备执行状态 | `POST /api/rpa/device/status` | `deviceIds`(repeated int64, 必填) | `list`(repeated Status，含 `deviceId`, `appType`, `targetGroupNum`, `successGroupNum`, `failGroupNum`, `updateAt`, `logType`, `logMsg`, `status`) |
设备状态中的 `logType`：`0` 信息、`1` 警告、`2` 错误。`status` 的协议类型是 string，当前说明值为 `0` 等待中、`1` 运行中、`2` 完成，不要改成 JSON 数字。
## 应用
| 目标 | 接口 | 请求字段 | 常用返回字段 |
| --- | --- | --- | --- |
| 应用列表 | `POST /api/rpa/application/list` | `deviceId`(int64, 可选；传入后返回该设备的购买和执行状态) | `items`(repeated ApplicationItem，含 `id`, `name`, `priceByMonth`, `priceByYear`, `isBuy`, `expireTime`, `isExec`, `autoUpdate`, `updateStart`, `updateEnd`, `forceSystemBit`) |
| 购买应用 | `POST /api/rpa/application/buy` | `deviceID`(int64, 必填)；`applicationID`(int64, 必填)；`payMode`(string, 必填，支付方式)；`expireNum`(int64, 必填，购买年/月数量) | `deviceID`；`endDate`(到期时间) |
| 转移应用权限 | `POST /api/rpa/device/application/transfer` | `sourceDeviceID`(int64, 必填)；`targetDeviceID`(int64, 必填)；`applicationIDs`(repeated int64, 必填) | 空对象或无业务数据 |
| 未购买指定应用的设备 | `POST /api/rpa/application/notExistDeviceList` | `applicationID`(int64, 必填)；`name`(string, 必填，设备名称模糊查询)；`groupID`(int64, 必填)；`page`(int64, 必填)；`pageSize`(int64, 必填) | `list`(repeated DeviceItem)；`page`；`pageSize`；`total`；`last` |
## 设备分组
| 目标 | 接口 | 请求字段 | 常用返回字段 |
| --- | --- | --- | --- |
| 分组列表 | `POST /api/rpa/group/list` | `{}` | `items`(repeated GroupItem，含 `id`, `name`) |
| 添加分组 | `POST /api/rpa/group/add` | `name`(string, 必填) | 空对象或无业务数据 |
| 删除分组 | `POST /api/rpa/group/del` | `id`(int64, 必填) | 空对象或无业务数据 |
| 更新分组名称 | `POST /api/rpa/group/update` | `id`(int64, 必填)；`name`(string, 必填) | 空对象或无业务数据 |
| 移动设备 | `POST /api/rpa/group/device/move` | `deviceIDs`(repeated int64, 必填)；`groupID`(int64, 必填，目标分组 ID) | 空对象或无业务数据 |
## 消息转发
| 目标 | 接口 | 请求字段 | 常用返回字段 |
| --- | --- | --- | --- |
| 转发配置详情 | `POST /api/rpa/msgforward/info` | `deviceId`(int64, 必填) | `id`(转发配置 ID)；`sendRate`(最高 1 倍，向下递减)；`groupNames`(目标群名)；`listenGroupName`(监听群名) |
| 更新转发配置 | `POST /api/rpa/msgforward/update` | `deviceId`(int64, 必填)；`sendRate`(float, 可选，最高 1 倍)；`groupNames`(repeated string, 可选)；`listenGroupName`(string, 可选) | 空对象或无业务数据 |
| 转发执行状态 | `POST /api/rpa/msgforward/status` | `deviceIds`(repeated int64, 必填) | `list`(repeated Status，含 `deviceId`, `targetGroupNum`, `successGroupNum`, `failGroupNum`, `updateAt`, `logType`, `logMsg`, `status`) |
转发状态中的 `logType` 和 `status` 取值与设备执行状态相同。
## 群管
| 目标 | 接口 | 请求字段 | 常用返回字段 |
| --- | --- | --- | --- |
| 群管配置详情 | `POST /api/rpa/qunguan/info` | `deviceId`(int64, 必填) | `deviceId`；`sendRate`(最高 1 倍，向下递减)；`groupNames`(群名列表) |
| 更新群管配置 | `POST /api/rpa/qunguan/update` | `deviceId`(int64, 必填)；`sendRate`(float, 可选，最高 1 倍)；`groupNames`(repeated string, 可选) | 空对象或无业务数据 |
| 待执行任务列表 | `POST /api/rpa/qunguan/taskList` | `deviceId`(int64, 必填) | `taskInfos`(repeated TaskInfo，含 `taskId`, `methodType`, `content`, `isAtAll`) |
| 发送任务 | `POST /api/rpa/qunguan/sendTask` | `deviceId`(int64, 必填)；`methodType`(int32, 必填)；`content`(string, 必填)；`isAtAll`(bool, 可选，仅方式 2、3 生效) | 空对象或无业务数据 |
| 删除任务 | `POST /api/rpa/qunguan/delTask` | `deviceId`(int64, 必填)；`taskIds`(repeated string, 必填) | 空对象或无业务数据 |
群管 `methodType`：`1` 修改群名，`2` 群发消息，`3` 修改群公告，`4` 邀请进群。`content` 随类型分别填写群名规则、群发内容、公告内容或受邀者名称。
## 常用示例
```bash
# 查看全部 RPA 设备
htsy-cli call /api/rpa/device/list -d '{"page":1,"pageSize":20,"groupID":0}'
# 查看指定设备已购买和正在执行的应用
htsy-cli call /api/rpa/application/list -d '{"deviceId":1001}'
# 配置消息转发
htsy-cli call /api/rpa/msgforward/update -d '{"deviceId":1001,"sendRate":1,"listenGroupName":"订单群","groupNames":["客户群A","客户群B"]}'
# 向群管设备下发群公告任务
htsy-cli call /api/rpa/qunguan/sendTask -d '{"deviceId":1001,"methodType":3,"content":"今日活动已开始","isAtAll":true}'
```
设备注册、设备拉取任务和设备执行数据上报是 RPA 客户端内部流程，不作为常规业务 API 调用。
htsy/references/htsy-api.md
+1
View File
@@ -9,6 +9,7 @@
- 群、群成员、群运营：[api-group.md](api-group.md)
- 素材、话术库、上传 token：[api-material.md](api-material.md)
- 自动化、群发、关键词、SOP、营销计划：[api-automation.md](api-automation.md)
- RPA 设备、应用、设备分组、消息转发、群管：[api-rpa.md](api-rpa.md)
- 客服与知识库：[api-customer.md](api-customer.md)
排除原则：不面向用户直接调用的协议实例、Cron、客户端节点、回调上报、内部专用、第三方特供接口不写入模块参考；除非用户明确说明是在维护服务端内部代码，否则不要主动调用这些接口。