添加服务群成员新版SDK

更新于 2023-01-18

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，将企业下成员添加到智能服务群中。

调用本接口实现的效果与下图操作实现效果一致，可以向已存在的智能服务群中添加企业下成员。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	场景服务群读写权限	API Explorer
第三方企业应用	暂不支持	场景服务群读写权限	暂不支持
第三方个人应用	暂不支持	场景服务群读写权限	暂不支持

名称	类型	是否必填	描述
x-acs-dingtalk-access-token	String	是	调用该接口的访问凭证。企业内部应用，调用获取企业内部应用的accessToken接口获取。

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

名称	类型	是否必填	描述
openTeamId	String	是	开放团队ID。如下图所示，查看ID信息内的团队ID值。
openConversationId	String	是	服务群openConversionId，调用创建场景服务群接口获取openConversationId参数值。
userIds	Array of String	是	待添加员工在钉钉组织内的的userId列表，最大值100。说明请确保userId值的正确性，如果userId值不正确，该接口不会报错，添加时会自动忽略该成员。

名称

类型

是否必填

描述

openTeamId

String

是

开放团队ID。如下图所示，查看ID信息内的团队ID值。