开启用户代聊

批量为某个用户开启与多个目标的代聊配置。

请求方法

POST： https://数据中心域名/v3/user/proxychat/start

频率限制： 每秒钟限 100 次

签名规则： 所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。

正文参数

HTTP 请求正文数据格式为 application/json：

参数	类型	必传	说明
userId	String	是	被代聊用户的唯一标识，长度 ≤ 64 字符。
targetIds	Array<String>	是	目标用户 ID 列表，支持批量设置，最多 50 个，每个 ID 长度 ≤ 64 字符。
botUserId	String	是	代聊助手（Bot）的用户 ID，长度 ≤ 64 字符。
metadata	Map<String, String>	否	可选动态扩展参数，最多支持 32 组键值对；key 长度 ≤ 32，value 长度 ≤ 512。

注意事项

• 单次最多添加 50 个 targetIds。
• 仅支持绑定 rc_agentchat 类型的 botUserId，其他类型暂不支持。

请求示例

HTTP

POST  /v3/user/proxychat/start HTTP/1.1
Host: api.rong-api.com
App-Key: e0x9wycxx2qdq
Nonce: 83682
Timestamp: 1726627371000
Signature: 81be659c74fccb5be993d553c51f5e26c13e6825
Content-Type: application/json

{
  "userId": "user_001",
  "targetIds": ["user_002", "user_003"],
  "botUserId": "bot_123",
  "metadata": {
    "role": "assistant"
  }
}

返回结果

返回值	类型	说明
code	Int	返回码。200 表示成功。

返回示例

HTTP

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200}

错误码

详见：错误码说明