CRM客户群操作流程

本文档介绍了CRM客户群操作流程。

说明

本文档以企业内部应用实现为例，第三方企业应用实现流程与本文档流程一致。

流程简介

本文档介绍了如何调用客户管理接口创建CRM客户群等流程。首先创建一个企业内部应用，再使用客户管理提供的API，实现创建客户群组、更新客户群组、获取单个客户群组详情、查询客户群组列表、创建客户群、获取单个客户群详情、批量查询客户群、查询客户群列表流程。

步骤一：登录开发者后台，创建企业内部应用。

步骤二：获取AppKey和AppSecret。

步骤三：申请客户管理接口权限。搜索“CRM”，申请相应的权限。

步骤四：获取应用访问凭证获取企业内部应用的accessToken。

步骤五：调用服务端客户群组、客户群相关API。

客户群组相关API：

调用服务端API-创建客户群组接口，进行创建客户群组，获取客户群组openGroupSetId。

根据客户群组openGroupSetId进行客户群组管理操作。

根据客户群组openGroupSetId，调用服务端API-更新客户群组接口，进行更新客户群组。

根据客户群组openGroupSetId，调用服务端API-获取单个客户群组详情接口，进行查询单个客户群组详情。

调用服务端API-查询客户群组列表接口，进行查询客户群组列表。

客户群相关API：

调用服务端API-创建客户群接口，进行创建客户群。

根据客户群openConversationId进行客户群管理操作。

根据客户群openConversationId，调用服务端API-获取单个客户群详情接口，进行获取单个客户群详情。

根据客户群openConversationId，调用服务端API-批量查询客户群接口，进行批量批量查询客户群详情。

调用服务端API-查询客户群列表接口，进行查询客户群列表。

步骤一：创建企业内部应用

说明

如果已有企业内部应用，可直接使用已有应用，可忽略此步骤。

登录开发者后台，创建企业内部应用。

填写应用的基本信息，然后单击确定创建。

应用类型：选择H5微应用

开发方式：选择企业自主开发

步骤二：获取AppKey和AppSecret

获取AppKey和AppSecret。

步骤三：添加接口权限

申请客户管理接口权限。搜索“CRM”，申请相应的权限。

步骤四：获取应用访问凭证accessToken

根据步骤二中的AppKey和AppSecret，获取应用访问凭证获取企业内部应用的accessToken。

说明

服务端API差异详情参见新旧版规范服务端API区别。

服务端API接口SDK下载，详情参见服务端SDK下载。

新版服务端API接口SDK下载，详情参见新版服务端SDK下载。

以下接口均使用新版服务端API接口，SDK下载详情参见新版服务端SDK下载。

public void getAccessToken() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkoauth2_1_0.Client client = new com.aliyun.dingtalkoauth2_1_0.Client(config);
        GetAccessTokenRequest accessTokenRequest = new GetAccessTokenRequest()
                .setAppKey("din*********hgn")
                .setAppSecret("9G_O************mBkhgGIO");
        GetAccessTokenResponse accessToken = client.getAccessToken(accessTokenRequest);
        System.out.println(JSON.toJSONString(accessToken.getBody()));
    }

步骤五：调用服务端客户群组、客户群相关API

客户群组相关API：

调用服务端API-创建客户群组接口，进行创建客户群组，获取客户群组openGroupSetId。

public void createCustomerGroupSet() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcrm_1_0.Client client = new com.aliyun.dingtalkcrm_1_0.Client(config);
        CreateGroupSetHeaders createGroupSetHeaders = new CreateGroupSetHeaders();
        createGroupSetHeaders.xAcsDingtalkAccessToken = "<your access token>";
        CreateGroupSetRequest createGroupSetRequest = new CreateGroupSetRequest()
                .setName("群组名")
                .setOwnerUserId("301227837930")
                .setCreatorUserId("301227837930")
                .setMemberQuota(100)
                .setManagerUserIds("301227837930,301227837935")
                .setNotice("公告")
                .setNoticeToped(1)
                .setRelationType("crm_customer_personal")
                .setWelcome("欢迎加入");
        try {
            CreateGroupSetResponse groupSetWithOptions = client.createGroupSetWithOptions(createGroupSetRequest, createGroupSetHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(groupSetWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据客户群组openGroupSetId进行客户群组管理操作。

根据客户群组openGroupSetId，调用服务端API-更新客户群组接口，进行更新客户群组。

 public void updateCustomerGroupSet() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcrm_1_0.Client client = new com.aliyun.dingtalkcrm_1_0.Client(config);
        UpdateGroupSetHeaders updateGroupSetHeaders = new UpdateGroupSetHeaders();
        updateGroupSetHeaders.xAcsDingtalkAccessToken = "<your access token>";
        UpdateGroupSetRequest updateGroupSetRequest = new UpdateGroupSetRequest()
                .setOpenGroupSetId("dfgfghfghdsfdsf")
                .setName("营销群")
                .setMemberQuota(200)
                .setOwnerUserId("301227837938")
                .setManagerUserIds("301227837938")
                .setNotice("公告")
                .setNoticeToped(1)
                .setWelcome("欢迎入群");
        try {
            UpdateGroupSetResponse updateGroupSetResponse = client.updateGroupSetWithOptions(updateGroupSetRequest, updateGroupSetHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(updateGroupSetResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据客户群组openGroupSetId，调用服务端API-获取单个客户群组详情接口，进行查询单个客户群组详情。

 public void getCustomerGroupSet() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcrm_1_0.Client client = new com.aliyun.dingtalkcrm_1_0.Client(config);
        GetGroupSetHeaders getGroupSetHeaders = new GetGroupSetHeaders();
        getGroupSetHeaders.xAcsDingtalkAccessToken = "<your access token>";
        GetGroupSetRequest getGroupSetRequest = new GetGroupSetRequest()
                .setOpenGroupSetId("OkldZxxxx");
        try {
            GetGroupSetResponse groupSetWithOptions = client.getGroupSetWithOptions(getGroupSetRequest, getGroupSetHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(groupSetWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

调用服务端API-查询客户群组列表接口，进行查询客户群组列表。

public void queryCustomerGroupSets() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcrm_1_0.Client client = new com.aliyun.dingtalkcrm_1_0.Client(config);
        ListGroupSetHeaders listGroupSetHeaders = new ListGroupSetHeaders();
        listGroupSetHeaders.xAcsDingtalkAccessToken = "<your access token>";
        ListGroupSetRequest listGroupSetRequest = new ListGroupSetRequest()
                .setNextToken("fasafsafsd")
                .setMaxResults(10)
                .setQueryDsl("{\"queryGroupList\":[{\"logicType\":\"AND\",\"queryObjectList\":[{\"filterType\":\"SEARCH\",\"value\":\"XX\",\"fieldId\":\"name\"}]}]}")
                .setRelationType("crm_customer_personal");
        try {
            ListGroupSetResponse listGroupSetResponse = client.listGroupSetWithOptions(listGroupSetRequest, listGroupSetHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(listGroupSetResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

客户群相关API：

调用服务端API-创建客户群接口，进行创建客户群。

public void createCustomerGroup() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcrm_1_0.Client client = new com.aliyun.dingtalkcrm_1_0.Client(config);
        CreateGroupHeaders createGroupHeaders = new CreateGroupHeaders();
        createGroupHeaders.xAcsDingtalkAccessToken = "<your access token>";
        CreateGroupRequest createGroupRequest = new CreateGroupRequest()
                .setGroupName("abc")
                .setOwnerUserId("abc123")
                .setMemberUserIds("a,b,c")
                .setRelationType("abc");
        try {
            CreateGroupResponse groupWithOptions = client.createGroupWithOptions(createGroupRequest, createGroupHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(groupWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据客户群openConversationId进行客户群管理操作。

根据客户群openConversationId，调用服务端API-获取单个客户群详情接口，进行获取单个客户群详情。

   public void getCustomerGroup() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcrm_1_0.Client client = new com.aliyun.dingtalkcrm_1_0.Client(config);
        GetCrmGroupChatSingleHeaders getCrmGroupChatSingleHeaders = new GetCrmGroupChatSingleHeaders();
        getCrmGroupChatSingleHeaders.xAcsDingtalkAccessToken = "<your access token>";
        GetCrmGroupChatSingleRequest getCrmGroupChatSingleRequest = new GetCrmGroupChatSingleRequest()
                .setOpenConversationId("afasd1321");
        try {
            GetCrmGroupChatSingleResponse crmGroupChatSingleWithOptions = client.getCrmGroupChatSingleWithOptions(getCrmGroupChatSingleRequest, getCrmGroupChatSingleHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(crmGroupChatSingleWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

根据客户群openConversationId，调用服务端API-批量查询客户群接口，进行批量批量查询客户群详情。

  public void batchGetCustomerGroups() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcrm_1_0.Client client = new com.aliyun.dingtalkcrm_1_0.Client(config);
        GetCrmGroupChatMultiHeaders getCrmGroupChatMultiHeaders = new GetCrmGroupChatMultiHeaders();
        getCrmGroupChatMultiHeaders.xAcsDingtalkAccessToken = "<your access token>";
        GetCrmGroupChatMultiRequest getCrmGroupChatMultiRequest = new GetCrmGroupChatMultiRequest()
                .setOpenConversationIds(java.util.Arrays.asList(
                        "cidQJKDN****=="
                ));
        try {
            GetCrmGroupChatMultiResponse crmGroupChatMultiWithOptions = client.getCrmGroupChatMultiWithOptions(getCrmGroupChatMultiRequest, getCrmGroupChatMultiHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(crmGroupChatMultiWithOptions.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

调用服务端API-查询客户群列表接口，进行查询客户群列表。

 public void queryCustomerGroups() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkcrm_1_0.Client client = new com.aliyun.dingtalkcrm_1_0.Client(config);
        QueryCrmGroupChatsHeaders queryCrmGroupChatsHeaders = new QueryCrmGroupChatsHeaders();
        queryCrmGroupChatsHeaders.xAcsDingtalkAccessToken = "<your access token>";
        QueryCrmGroupChatsRequest queryCrmGroupChatsRequest = new QueryCrmGroupChatsRequest()
                .setRelationType("crm_customer_personal")
                .setNextToken("fasdfs1")
                .setMaxResults(10)
                .setQueryDsl("{\"queryGroupList\":[{\"logicType\":\"AND\",\"queryObjectList\":[{\"filterType\":\"SEARCH\",\"value\":\"测试客户群\",\"fieldId\":\"name\"},{\"filterType\":\"LT\",\"value\":\"2640002249001\",\"fieldId\":\"gmtCreate\"}]}],\"orderByFields\":[{\"orderByFieldId\":\"gmtCreate\",\"orderByDirection\":\"ASC\"}]}");
        try {
            QueryCrmGroupChatsResponse queryCrmGroupChatsResponse = client.queryCrmGroupChatsWithOptions(queryCrmGroupChatsRequest, queryCrmGroupChatsHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(queryCrmGroupChatsResponse.getBody()));
        } catch (TeaException err) {
            if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {
                // err 中含有 code 和 message 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.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 属性，可帮助开发定位问题
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

CRM客户群操作流程

流程简介#

步骤一：创建企业内部应用#

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#

步骤四：获取应用访问凭证accessToken#

步骤五：调用服务端客户群组、客户群相关API#

客户群组相关API：#

客户群相关API：#

流程简介

步骤一：创建企业内部应用

步骤二：获取AppKey和AppSecret

步骤三：添加接口权限

步骤四：获取应用访问凭证accessToken

步骤五：调用服务端客户群组、客户群相关API

客户群组相关API：

客户群相关API：