群会话操作流程

本文档介绍了如何调用群会话相关接口实现群会话操作的相关流程。首先创建一个企业内部应用，再使用群会话提供的API，实现创建群会话、获取群会话信息、群会话管理操作、修改群会话流程。

流程简介

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

步骤二：获取AppKey和AppSecret。

步骤三：申请群会话接口权限。搜索“chat相关接口”，申请“场景群”和“群管理”相应权限。

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

步骤五：调用服务端群会话相关API。

调用服务端API-创建群会话接口，进行创建群会话，获取群会话chatId。

根据群会话chatId，调用服务端API-获取群会话信息接口，获取群会话的信息。

根据群会话chatId进行群会话管理操作。

根据群会话chatId，调用新版服务端API-获取群会话的OpenConversationId接口，获取群会话openConversationId。

根据群会话openConversationId，调用新版服务端API-批量设置企业群管理员接口，批量设置群管理员。

根据群会话chatId，调用服务端API-设置群管理员接口，进行群会话管理员的设置。

根据群会话chatId，调用服务端API-设置禁止群成员私聊接口，设置群会话群成员间是否可以私聊。

根据群会话chatId，调用服务端API-设置群成员昵称接口，进行设置群会话成员的昵称。

根据群会话chatId，调用服务端API-获取入群二维码链接接口，其他的企业成员点击链接即可申请加入群聊。

根据群会话chatId，调用服务端API-修改群会话接口，进行群会话信息的修改。

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

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

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

应用类型：选择H5微应用。

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

步骤二：获取AppKey和AppSecret

获取AppKey和AppSecret。

步骤三：添加接口权限

申请群会话接口权限，搜索“chat相关接口”，申请“场景群”和“群管理”相应权限。

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

重要

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

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

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

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

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

 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区别。

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

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

1，2步接口使用服务端API接口，SDK下载详情参见服务端SDK下载。

调用服务端API-创建群会话接口，进行创建群会话，获取群会话chatId。

public void createChat() {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/chat/create");
        OapiChatCreateRequest req = new OapiChatCreateRequest();
        req.setName("全员群");
        req.setOwner("manager4220");
        req.setUseridlist(Arrays.asList("userid1","userid2"));
        OapiChatCreateResponse rsp = client.execute(req, access_token);
        System.out.println(rsp);
    }

根据群会话chatId，调用服务端API-获取群会话信息接口，获取群会话的信息。

public void getChatInfo() {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/chat/get");
        OapiChatGetRequest req = new OapiChatGetRequest();
        req.setChatid("chate39f540dxxxx");
        req.setHttpMethod("GET");
        OapiChatGetResponse rsp = client.execute(req, access_token);
        System.out.println(rsp.getChatInfo());
    }

根据群会话chatId进行群会话管理操作。

根据群会话chatId，调用新版服务端API-获取群会话的OpenConversationId接口，获取群会话openConversationId。

重要

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

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

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

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

public void ConversationId() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkim_1_0.Client client = new com.aliyun.dingtalkim_1_0.Client(config);
        ChatIdToOpenConversationIdHeaders chatIdToOpenConversationIdHeaders = new ChatIdToOpenConversationIdHeaders();
        chatIdToOpenConversationIdHeaders.xAcsDingtalkAccessToken = "accessToken";
        try {
            ChatIdToOpenConversationIdResponse response = client.chatIdToOpenConversationIdWithOptions("chatId", chatIdToOpenConversationIdHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(response.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-批量设置企业群管理员接口，批量设置群管理员。

重要

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

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

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

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

public void subAdministrators() throws Exception {
        Config config = new Config();
        config.protocol = "https";
        config.regionId = "central";
        com.aliyun.dingtalkim_1_0.Client client = new com.aliyun.dingtalkim_1_0.Client(config);
        ChatSubAdminUpdateHeaders chatSubAdminUpdateHeaders = new ChatSubAdminUpdateHeaders();
        chatSubAdminUpdateHeaders.xAcsDingtalkAccessToken = "accessToken";
        ChatSubAdminUpdateRequest chatSubAdminUpdateRequest = new ChatSubAdminUpdateRequest()
                .setOpenConversationId("cid55SzIIO********=")
                .setUserIds(java.util.Arrays.asList(
                        "0147********7041"
                ))
                .setRole(2);
        try {
            ChatSubAdminUpdateResponse chatSubAdminUpdateResponse = client.chatSubAdminUpdateWithOptions(chatSubAdminUpdateRequest, chatSubAdminUpdateHeaders, new RuntimeOptions());
            System.out.println(JSON.toJSONString(chatSubAdminUpdateResponse.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);
            }
        }
    }

根据群会话chatId，调用服务端API-设置群管理员接口，进行设置群会话管理员。

重要

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

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

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

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

public void setChatAdmin() {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/chat/subadmin/update");
        OapiChatSubadminUpdateRequest req = new OapiChatSubadminUpdateRequest();
        req.setChatid("chat14432xxxx");
        req.setUserids("userid1");
        req.setRole(2L);
        OapiChatSubadminUpdateResponse rsp = client.execute(req, access_token);
        System.out.println(rsp.getBody());
    }

根据群会话chatId，调用服务端API-设置禁止群成员私聊接口，设置群会话群成员间是否可以私聊。

public void updateChatMemberFriendswitch() {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/chat/member/friendswitch/update");
        OapiChatMemberFriendswitchUpdateRequest req = new OapiChatMemberFriendswitchUpdateRequest();
        req.setChatid("chatdafe234xxxx");
        req.setIsProhibit(true);
        OapiChatMemberFriendswitchUpdateResponse rsp = client.execute(req, access_token);
        System.out.println(rsp.getBody());
    }

根据群会话chatId，调用服务端API-设置群成员昵称接口，进行设置群会话成员的昵称。

public void updateChatMemberNick() {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/chat/updategroupnick");
        OapiChatUpdategroupnickRequest req = new OapiChatUpdategroupnickRequest();
        req.setUserid("user123");
        req.setChatid("chate39f540d572b71cf97a556d95929fxxxx");
        req.setGroupNick("钉钉小二");
        OapiChatUpdategroupnickResponse rsp = client.execute(req, access_token);
        System.out.println(rsp.getBody());
    }

根据群会话chatId，调用服务端API-获取入群二维码链接接口，其他的企业成员点击链接即可申请加入群聊。

public void getChatURL() {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/chat/qrcode/get");
        OapiChatQrcodeGetRequest req = new OapiChatQrcodeGetRequest();
        req.setChatid("chat32****3a");
        req.setUserid("manager4220");
        OapiChatQrcodeGetResponse rsp = client.execute(req, access_token);
        System.out.println(rsp.getBody());
    }

根据群会话chatId，调用服务端API-修改群会话接口，进行群会话信息的修改。

public void updateChat() {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/chat/update");
        OapiChatUpdateRequest req = new OapiChatUpdateRequest();
        req.setChatid("chatxxxx");
        req.setName("群名称1");
        req.setOwner("04201724372xxxx");
        req.setOwnerType("emp");
        req.setAddUseridlist(Arrays.asList("userid2"));
        req.setDelUseridlist(Arrays.asList("userid1"));
        req.setIcon("@mediaId");
        req.setIsBan(true);
        req.setSearchable(0L);
        req.setValidationType(0L);
        req.setMentionAllAuthority(0L);
        req.setManagementType(0L);
        req.setChatBannedType(0L);
        req.setShowHistoryType(0L);
        OapiChatUpdateResponse rsp = client.execute(req,access_token);
        System.out.println(rsp.getBody());
    }

群会话操作流程

流程简介#

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

步骤二：获取AppKey和AppSecret#

步骤三：添加接口权限#

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

步骤五：调用服务端群会话相关API#

流程简介

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

步骤二：获取AppKey和AppSecret

步骤三：添加接口权限

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

步骤五：调用服务端群会话相关API