启用群模板旧版SDK
更新于 2024-02-27
调用本接口，根据群模板ID、群ID启用群模板，生效群模板配置项、安装群模板机器人、开启群模板快捷入口，启用后如下图所示。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
企业内部应用 | 支持 | 钉钉群基础信息管理权限 | |
第三方企业应用 | 支持 | 钉钉群基础信息管理权限 | |
第三方个人应用 | 暂不支持 | 钉钉群基础信息管理权限 | 暂不支持 |
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/im/chat/scenegroup/template/apply
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | bes1***** | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
owner_user_id | String | 是 | 013***** | 群主的userid。 |
template_id | String | 是 | c354***-***-***-b4ea-6f1ab***65 | 群模板id，登录开发者后台 > 开放能力 > 场景群 > 群模板查看id：  说明 调用本接口前，需要在钉钉开发者后台为群模板设置灰度企业。  |
open_conversation_id | String | 是 | cid9FTRQSLo+sK*****== | 群ID。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
success | Boolean | true | 调用是否成功。 |
errmsg | String | ok | 返回码描述。 |
errcode | Number | 0 | 返回码。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK，接口使用旧版服务端SDK，参见服务端SDK）
返回示例
错误码
错误码（errorcode） | 错误信息描述（errmsg） | 解决方案 |
665036 | 群模板不存在或停用 | 确认群模板id是否正确 |
660023 | 群ID解码失败 | 确认群id是否正确 |
500 | 系统异常 | 优先确认群id，群模板id是否正确，请稍后重试 |
