要通过API的方式在钉钉中创建客户群,您需要使用钉钉提供的API接口。首先,您需要在钉钉开放平台创建一个应用,应用创建成功后,系统会自动生成AppKey和AppSecret,这两个参数将用于验证您的身份。
然后,您可以使用获取凭证API来获取access_token,这是调用其他API接口所必需的。请求方式为GET,请求地址为:https://oapi.dingtalk.com/chat/get。
最后,您可以使用创建群聊的API来创建客户群。注意这里的群聊是针对企业的客户群,主要适用于销售和服务人员,包含如客户群看板等便于统一掌握所有客户群活跃情况以及服务人员响应效率的功能。
POST /v1.0/crm/groups HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:String
Content-Type:application/json
{
"groupName" : "String",
"ownerUserId" : "String",
"memberUserIds" : "String",
"relationType" : "String"
}
链接:https://open.dingtalk.com/document/isvapp/create-a-customer-group
POST /v1.0/crm/groups HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:String
Content-Type:application/json
{
"groupName" : "String",
"ownerUserId" : "String",
"memberUserIds" : "String",
"relationType" : "String"
}
```jsPOST /v1.0/crm/groups HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:String
Content-Type:application/json
{
"groupName" : "String",
"ownerUserId" : "String",
"memberUserIds" : "String",
"relationType" : "String"
}
```
POST /v1.0/crm/groups HTTP/1.1
Host:api.dingtalk.com
x-acs-dingtalk-access-token:String
Content-Type:application/json
{
"groupName" : "String",
"ownerUserId" : "String",
"memberUserIds" : "String",
"relationType" : "String"
}
调用本接口,用于创建客户群。
通过以下java代码创建客户群
package com.aliyun.sample;
import com.aliyun.tea.;
import com.aliyun.teautil.;
import com.aliyun.teautil.models.;
import com.aliyun.dingtalkcrm_1_0.;
import com.aliyun.dingtalkcrm_1_0.models.;
import com.aliyun.teaopenapi.;
import com.aliyun.teaopenapi.models.*;
public class Sample {
/**
* 使用 Token 初始化账号Client
* @return Client
* @throws Exception
*/
public static com.aliyun.dingtalkcrm_1_0.Client createClient() throws Exception {
Config config = new Config();
config.protocol = "https";
config.regionId = "central";
return new com.aliyun.dingtalkcrm_1_0.Client(config);
}
public static void main(String[] args_) throws Exception {
java.util.List<String> args = java.util.Arrays.asList(args_);
com.aliyun.dingtalkcrm_1_0.Client client = Sample.createClient();
CreateGroupSetHeaders createGroupSetHeaders = new CreateGroupSetHeaders();
createGroupSetHeaders.xAcsDingtalkAccessToken = "<your access token>";
CreateGroupSetRequest createGroupSetRequest = new CreateGroupSetRequest()
.setName("群组名")
.setOwnerUserId("301227837930")
.setCreatorUserId("301227837930")
.setTemplateId("asdasd-adsfdsfdsf-www")
.setMemberQuota(100)
.setManagerUserIds("301227837930,301227837935")
.setNotice("公告")
.setNoticeToped(1)
.setRelationType("crm_customer_personal")
.setWelcome("欢迎加入");
try {
client.createGroupSetWithOptions(createGroupSetRequest, createGroupSetHeaders, new RuntimeOptions());
} catch (TeaException err) {
if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
// err 中含有 code 和 message 属性,可帮助开发定位问题
}
} catch (Exception _err) {
TeaException err = new TeaException(_err.getMessage(), _err);
if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
// err 中含有 code 和 message 属性,可帮助开发定位问题
}
}
}
}
创建客户群组新版SDK
https://open.dingtalk.com/document/isvapp/create-a-customer-group-set
调用本接口,用于创建客户群组。
接口调用说明
客户群组是一组客户群的集合,有以下特点:
客户群组可以设置群成员数的最大值,当每个客户群成员数超过最大值,会自动创建一个新的客户群。
每次创建新群时,会自动设置群主、群管理员、群公告等信息。
接口功能介绍
例如,调用本接口创建一个名为核心客户的客户群组,客户群组设置成员人数最大是4人,群主是小钉,设置了1个管理员是小明。
接口调用成功后:
自动创建1个客户群,群名称为“核心客户1群”,群内共2人,分别为小钉、小明。如下图所示。
同时返回一个邀请链接,用户可以通过该链接加入客户群。
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。