> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ikhtisar

> Pelajari pengelolaan obrolan di DingTalk — mulai dari catatan versi, ikhtisar kemampuan terbuka (open API), tutorial, hingga terminologi kunci untuk mengelola grup secara efisien.

Topik ini memperkenalkan pengelolaan percakapan.

## Apa itu pengelolaan percakapan

Pengelolaan percakapan adalah serangkaian kemampuan yang memungkinkan DingTalk membuat, mengonfigurasi, dan mengelola grup beserta anggotanya secara fleksibel sesuai kebutuhan bisnis. Fitur ini juga menyediakan layanan dalam grup yang disesuaikan dengan skenario bisnis tertentu, menggabungkan komunikasi dan kolaborasi. Anggota organisasi dapat berkolaborasi dan berkomunikasi secara efisien, terstruktur, dan jelas dengan memanfaatkan kemampuan grup yang kaya di Obrolan Grup, sehingga meningkatkan efisiensi kerja kolaboratif.

## Keterangan versi

| **Fitur**                                                                                              | **Kelola Grup** | **Grup berbasis skenario** |
| ------------------------------------------------------------------------------------------------------ | --------------- | -------------------------- |
| Pengelolaan dasar Obrolan Grup dan anggota                                                             | ✅               | ✅                          |
| Prakonfigurasi fitur lanjutan di Obrolan Grup (seperti kartu tersemat, entri cepat grup, dan Bot grup) | ❌               | ✅                          |
| Kelola Obrolan Grup secara massal melalui API berdasarkan templat grup                                 | ❌               | ✅                          |
| Kustomisasi jenis dan fitur grup dalam organisasi berdasarkan templat grup                             | ❌               | ✅                          |

## Ikhtisar kemampuan terbuka

### Daftar open API

Pengelolaan percakapan menyediakan serangkaian open API yang kaya. Developer dapat mengintegrasikan grup dengan sistem bisnis perusahaan melalui API ini.

#### Kelola Grup

| **API**                                                                                               | **Deskripsi**                                                                                           | **Versi API** |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------- |
| [Buat Obrolan Grup](/id/open/development/create-common-group-new-version-v2)                          | Buat Grup Internal atau Obrolan Grup Standar.                                                           | New           |
| [Perbarui Obrolan Grup](/id/open/development/api-updategroup)                                         | Perbarui informasi dasar dan anggota Obrolan Grup tertentu berdasarkan chatid.                          | New           |
| [Kueri informasi grup](/id/open/development/obtain-a-group-session)                                   | Ambil pengaturan grup dan informasi anggota.                                                            | Legacy        |
| [Perbarui nama panggilan grup seorang anggota](/id/open/development/set-a-group-nickname)             | Perbarui nama panggilan seorang anggota dalam grup.                                                     | Legacy        |
| [Tetapkan Admin grup organisasi secara massal](/id/open/development/batch-setup-group-administrator)  | Berikan atau cabut izin admin untuk anggota Grup organisasi secara massal.                              | New           |
| [Nonaktifkan Obrolan Pribadi](/id/open/development/set-private-chat)                                  | Konfigurasikan apakah anggota grup dapat saling menambahkan sebagai Kontak dan mengirim pesan langsung. | Legacy        |
| [Dapatkan tautan undangan Kode QR grup](/id/open/development/obtain-a-qr-code-link)                   | Ambil tautan undangan Kode QR untuk bergabung ke grup.                                                  | Legacy        |
| [Dapatkan OpenConversationId dari Obrolan Grup](/id/open/development/obtain-group-openconversationid) | Kueri OpenConversationId berdasarkan chatId.                                                            | New           |

##### Kelola Grup

| **API**                                      | **Deskripsi**                                                                                        | **Versi API** |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------- |
| Buat grup berbasis skenario                  | Buat grup berdasarkan ID templat grup.                                                               | New           |
| Perbarui grup berbasis skenario              | Perbarui informasi grup berdasarkan ID grup.                                                         | New           |
| Tambah anggota grup                          | Tambahkan anggota baru ke grup (hingga 1.000 anggota per grup).                                      | New           |
| Hapus anggota grup                           | Hapus anggota grup berdasarkan ID grup dan ID anggota.                                               | New           |
| Kueri informasi grup                         | Ambil nama grup, ikon grup, ID Pemilik grup, tautan gabung, dan pengaturan grup berdasarkan ID grup. | Legacy        |
| Atur status bisu anggota grup                | Atur status bisu anggota dalam grup berbasis skenario.                                               | New           |
| Kueri status bisu grup                       | Kueri status bisu grup dan anggotanya.                                                               | New           |
| Perbarui nama panggilan grup seorang anggota | Perbarui nama panggilan grup seorang anggota berdasarkan ID grup dan ID anggota.                     | New           |
| Perbarui Admin grup                          | Perbarui Admin grup dari sebuah grup.                                                                | New           |
| Kueri informasi ringkas grup                 | Ambil informasi dasar seperti nama grup, ikon grup, dan ID Pemilik grup berdasarkan ID grup.         | New           |
| Kueri anggota grup                           | Kueri informasi anggota grup.                                                                        | New           |
| Hapus Obrolan Grup                           | Hapus grup tertentu berdasarkan ID grup.                                                             | New           |
| Kueri Bot templat grup dalam sebuah grup     | Kueri informasi tentang Bot templat grup dalam sebuah grup.                                          | New           |

##### Templat grup

| **API**                  | **Deskripsi**                                         | **Versi API** |
| ------------------------ | ----------------------------------------------------- | ------------- |
| Aktifkan templat grup    | Aktifkan templat grup berdasarkan ID templat grup.    | Legacy        |
| Nonaktifkan templat grup | Nonaktifkan templat grup berdasarkan ID templat grup. | Legacy        |

##### Kartu tersemat

| **API**                                     | **Deskripsi**                                                 | **Versi API** |
| ------------------------------------------- | ------------------------------------------------------------- | ------------- |
| Buat dan aktifkan kartu interaktif tersemat | Buat dan aktifkan kartu interaktif tersemat dalam percakapan. | New           |
| Tutup kartu interaktif tersemat             | Tutup kartu interaktif tersemat dalam percakapan.             | New           |

##### Asisten grup

| **API**                  | **Deskripsi**                                                       | **Versi API** |
| ------------------------ | ------------------------------------------------------------------- | ------------- |
| Kirim pesan asisten grup | Kirim pesan ke grup melalui Bot yang ditentukan dalam templat grup. | Legacy        |

### Daftar peristiwa Callback

Pengelolaan percakapan mendukung peristiwa Callback seperti menghapus Obrolan Grup, menambah anggota, menghapus anggota, dan mengganti Pemilik grup. Untuk peristiwa lainnya, lihat ikhtisar Langganan peristiwa.

## Tutorial

DingTalk menyediakan contoh Alur integrasi untuk API pengelolaan percakapan.

* Buat Obrolan Grup (grup berbasis skenario)
* [Buat entri cepat (plugin grup)](/id/open/development/create-a-group-plug-in)
* [Kirim pesan melalui asisten grup](/id/open/development/group-assistant-sends-a-message)
* [Buat, kueri, ubah, dan kelola Obrolan Grup](/id/open/development/group-session-operation-process)
* [Mode pull murni untuk kartu tersemat](/id/open/development/pure-pull-mode-process-guide)

## Glosarium

### Obrolan

DingTalk mendukung dua jenis percakapan utama: **Obrolan Pesan Langsung satu lawan satu** dan **Obrolan Grup**.

### Anggota grup

Semua anggota yang membentuk sebuah Obrolan Grup.

### Peran pengelolaan grup

Peran dalam Obrolan Grup yang memegang izin pengelolaan grup yang berbeda, meliputi **Pemilik grup, Admin grup, dan anggota grup standar**. Cakupan izin mereka berperingkat sebagai berikut: Pemilik grup > Admin grup > anggota grup standar.

### Peran grup

Peran yang diberikan kepada anggota grup oleh Pemilik grup atau Admin grup, seperti "Product Manager" atau "HR".

### Templat grup

Dengan menyiapkan templat grup terlebih dahulu dan menggunakannya untuk membuat Obrolan Grup, atau dengan mengonversi Grup Internal standar menjadi grup yang menerapkan templat tersebut, Anda dapat memasang berbagai kemampuan ke dalam grup sekaligus, termasuk pengaturan grup, Bot dalam grup, dan entri cepat dalam grup. Anda juga dapat mengelola Obrolan Grup secara massal melalui templat grup. Templat grup juga mendukung pengaturan cakupan visibilitas dan dapat ditampilkan di entri pembuatan grup di bawah ikon "+", sehingga pengguna dalam organisasi dapat membuat Obrolan Grup Kustom dengan satu klik langsung dari klien DingTalk.

### Kartu tersemat

Obrolan Grup mendukung penyisipan konten tertentu ke area tersemat sebuah grup melalui API untuk menampilkan notifikasi, pengumuman, dan informasi lainnya, sehingga meningkatkan jangkauan pesan.

### Entri cepat

Sebelumnya dikenal sebagai plugin grup. Buka aplikasi yang sering digunakan dengan cepat dari batang entri cepat dalam grup tanpa dialihkan ke workbench atau app marketplace, sehingga memungkinkan alur kerja bisnis yang efisien dalam grup.

Obrolan Grup mendukung kustomisasi entri cepat untuk grup tertentu melalui templat grup dan Cool App, termasuk tautan entri dan urutannya. Entri cepat dalam percakapan Bot obrolan tunggal juga dapat dikonfigurasi di tingkat organisasi melalui API.

Untuk petunjuk membuat entri cepat, lihat [Buat entri cepat (plugin grup)](/id/open/development/create-a-group-plug-in).

### chatId

Sebuah chatId secara unik mengidentifikasi sebuah **Obrolan Grup**. Nilai ini dikembalikan oleh API pembuatan grup.

<Warning>
  Pada versi mendatang, **chatid** tidak akan digunakan lagi. Gunakan **openConversationId** sebagai pengidentifikasi unik untuk sebuah Obrolan Grup.
</Warning>

### openConversationId

Sebuah openConversationId secara unik mengidentifikasi sebuah **Obrolan Grup**. Nilai ini dikembalikan oleh API pembuatan grup.
