Membuat, mengueri, memodifikasi, dan mengelola obrolan grup

Dokumen ini menjelaskan cara memanggil API obrolan grup untuk melakukan operasi obrolan grup. Pertama, buat aplikasi internal. Kemudian, gunakan API obrolan grup untuk membuat obrolan grup, mengambil informasi obrolan grup, mengelola obrolan grup, dan memodifikasi obrolan grup.

Ikhtisar proses

Langkah 1: Dapatkan client ID dan Client Secret dari aplikasi. Langkah 3: Dapatkan kredensial akses aplikasi dengan mengikuti Mendapatkan access token dari aplikasi internal. Langkah 4: Panggil API obrolan grup sisi server.

Panggil Server API untuk membuat obrolan grup guna membuat obrolan grup dan memperoleh chatId-nya.
Berdasarkan chatId, panggil Server API Mengueri informasi obrolan grup untuk mengambil informasi obrolan grup.
Kelola obrolan grup menggunakan chatId-nya.
- Berdasarkan chatId, panggil Server API baru Mendapatkan OpenConversationId dari obrolan grup untuk memperoleh openConversationId.
  - Berdasarkan openConversationId, panggil Server API baru untuk menetapkan admin grup secara massal guna menetapkan admin grup secara massal.
- Berdasarkan chatId, panggil Server API untuk memperbarui admin grup guna menetapkan admin grup.
- Berdasarkan chatId, panggil Server API Nonaktifkan Obrolan Pribadi untuk mengontrol apakah anggota grup dapat mengobrol secara pribadi.
- Berdasarkan chatId, panggil Server API Memperbarui nama panggilan grup dari anggota grup untuk menetapkan nama panggilan anggota grup.
- Berdasarkan chatId, panggil Server API Mendapatkan tautan Kode QR untuk gabung obrolan. Pengguna lain di organisasi Anda dapat mengeklik tautan tersebut untuk meminta bergabung ke obrolan grup.
Berdasarkan chatId, panggil Server API untuk memperbarui obrolan grup guna memodifikasi informasi obrolan grup.

Prasyarat

Selesaikan proses Pembuatan dan konfigurasi aplikasi.

Langkah 1: Dapatkan kredensial aplikasi

Pilih aplikasi target, buka halaman detail aplikasi, dan klik Basic Information > Credentials and Basic Information.
Dapatkan client ID dan Client Secret dari aplikasi.

Langkah 2: Tambahkan izin API

Klik Development Configuration > Manage Permissions. Pada kotak pencarian izin, masukkan qyapi_chat_manage, qyapi_chat_read, dan qyapi_chat_base_read secara terpisah, lalu ajukan permintaan izin.

Langkah 3: Dapatkan access token aplikasi

Untuk detail tentang perbedaan antar Server API, lihat Legacy API VS New API. Semua API berikut menggunakan Server API baru. Untuk detail unduhan SDK, lihat Server-side SDK download.

Berdasarkan client ID dan Client Secret yang diperoleh pada Langkah 1, dapatkan kredensial akses aplikasi dengan mengikuti Mendapatkan access token dari aplikasi internal.

 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()));
    }

Langkah 4: Panggil API obrolan grup sisi server

Panggil Server API untuk membuat obrolan grup guna membuat obrolan grup dan memperoleh chatId-nya.

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

Berdasarkan chatId, panggil Server API Mengueri informasi obrolan grup untuk mengambil informasi obrolan grup.

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

Kelola obrolan grup menggunakan chatId-nya.

Berdasarkan chatId, panggil Server API baru Mendapatkan OpenConversationId dari obrolan grup untuk memperoleh openConversationId.

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 berisi atribut code dan message untuk membantu menemukan masalah
                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 berisi atribut code dan message untuk membantu menemukan masalah
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

Berdasarkan openConversationId, panggil Server API baru untuk menetapkan admin grup secara massal guna menetapkan admin grup secara massal.

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 berisi atribut code dan message untuk membantu menemukan masalah
                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 berisi atribut code dan message untuk membantu menemukan masalah
                System.out.println(err.code);
                System.out.println(err.message);
            }
        }
    }

Berdasarkan chatId, panggil Server API untuk memperbarui admin grup guna menetapkan admin grup.

public void setChatAdmin() {
        DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/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());
    }

Berdasarkan chatId, panggil Server API Nonaktifkan Obrolan Pribadi untuk mengontrol apakah anggota grup dapat mengobrol secara pribadi.

public void updateChatMemberFriendswitch() {
        DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/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());
    }

Berdasarkan chatId, panggil Server API Memperbarui nama panggilan grup dari anggota grup untuk menetapkan nama panggilan anggota grup.

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

Berdasarkan chatId, panggil Server API Mendapatkan tautan Kode QR untuk gabung obrolan. Pengguna lain di organisasi Anda dapat mengeklik tautan tersebut untuk meminta bergabung ke obrolan grup.

public void getChatURL() {
        DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/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());
    }

Berdasarkan chatId, panggil Server API untuk memperbarui obrolan grup guna memodifikasi informasi obrolan grup.

public void updateChat() {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.io/chat/update");
        OapiChatUpdateRequest req = new OapiChatUpdateRequest();
        req.setChatid("chatxxxx");
        req.setName("Nama grup 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());
    }

Panduan pemanggilan API

Autentikasi & otorisasi

Kontak

Kalender

Konferensi

AI Table

Dokumen & file

IM

Membuat, mengueri, memodifikasi, dan mengelola obrolan grup

Ikhtisar proses

Prasyarat

Langkah 1: Dapatkan kredensial aplikasi

Langkah 2: Tambahkan izin API

Langkah 3: Dapatkan access token aplikasi

Langkah 4: Panggil API obrolan grup sisi server

​Ikhtisar proses

​Prasyarat

​Langkah 1: Dapatkan kredensial aplikasi

​Langkah 2: Tambahkan izin API

​Langkah 3: Dapatkan access token aplikasi

​Langkah 4: Panggil API obrolan grup sisi server

Ikhtisar proses

Prasyarat

Langkah 1: Dapatkan kredensial aplikasi

Langkah 2: Tambahkan izin API

Langkah 3: Dapatkan access token aplikasi

Langkah 4: Panggil API obrolan grup sisi server