创建群组阿里钉群聊知识。
接口说明
请求说明
将指定阿里钉群聊接入调用方已加入的群组知识库。
资源类型固定为 ALI_DING，作用范围固定为 GROUP，归属用户从网关鉴权身份解析。
groupId、chatId 与 historyStartTime 为必填项。
updateFrequency 可通过 preset 或五段 cron 配置后续同步频率。
服务端校验调用方群成员身份、目标群组目录权限及 chatId 作用域内唯一性。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /openapi/createGroupAliDingChat HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
生效租户 ID。 |
10000 |
| chatId |
string |
是 |
会话 ID，一般用于 JSSDK。 |
cidxxxxxxxx |
| chatName |
string |
否 |
群聊名称 |
客户项目群 |
| directoryId |
string |
否 |
目录 ID。 |
exampleDirectoryId |
| historyStartTime |
string |
是 |
聊天记录开始采集时间 |
2026-08-01 |
| updateFrequency |
object |
否 |
特征更新频率 |
|
| preset |
string |
否 |
预设模式（忽略即可） |
hourly |
| cron |
string |
否 |
定时调度任务 Cron。 |
0 2 * * * |
| enabled |
boolean |
否 |
限流规则是否启用，true 表示启用，false 表示禁用 |
true |
| description |
string |
否 |
AI 助理的描述 |
客户群聊历史 |
| operatingObjectName |
string |
否 |
数字员工名称（运营对象 name，可选） |
my-agent |
| notes |
string |
否 |
会议笔记内容（可选），会参与辅助分析 |
重点识别客户诉求与待办 |
| sourceTags |
string |
否 |
资源标签（可选，JSON 字符串列表，如 ["tagA","tagB"]） |
["客户","群聊"] |
| groupId |
string |
是 |
组 ID。 |
exampleGroupId |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
创建群组阿里钉群聊知识 |
||
| code |
string |
响应码。 |
200 |
| message |
string |
错误详情。 |
ok |
| requestId |
string |
请求 ID |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| sourceId |
string |
业务系统侧的唯一标识 ID，即业务 ID。 |
exampleSourceId |
| chatId |
string |
会话 ID，一般用于 JSSDK。 |
cidxxxxxxxx |
| name |
string |
机器人名称。 |
客户项目群 |
| status |
string |
签约状态。
|
PENDING |
| scope |
string |
权限范围。 |
GROUP |
| directoryId |
string |
目录 ID。 |
exampleDirectoryId |
| gmtCreate |
string |
创建时间。 |
2026-08-18T10:00:00Z |
| groupId |
string |
项目组 ID。 |
exampleGroupId |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "ok",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"sourceId": "exampleSourceId",
"chatId": "cidxxxxxxxx",
"name": "客户项目群",
"status": "PENDING",
"scope": "GROUP",
"directoryId": "exampleDirectoryId",
"gmtCreate": "2026-08-18T10:00:00Z",
"groupId": "exampleGroupId"
}