> ## 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.

# Overview

> Introduces chat management with version notes, open capability overview, tutorials, and key terminology.

This topic introduces conversation management.

## What is conversation management

Conversation management is a set of capabilities through which DingTalk lets you create, configure, and manage groups and their members in flexible ways based on business needs. It also provides in-group services tailored to specific business scenarios, combining communication and collaboration. Organization members can collaborate and communicate efficiently, in a structured and clear manner, by leveraging rich group capabilities in Group Chats, improving collaborative office efficiency.

## Version description

| **Feature**                                                                                               | **Group management** | **Scenario-based group** |
| --------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------ |
| Basic management of Group Chats and members                                                               | ✅                    | ✅                        |
| Preconfigure advanced features in Group Chats (such as pinned cards, group quick entries, and Group bots) | ❌                    | ✅                        |
| Batch manage Group Chats via APIs based on group templates                                                | ❌                    | ✅                        |
| Customize group types and features within an organization based on group templates                        | ❌                    | ✅                        |

## Open capability overview

### Open API list

Conversation management provides a rich set of open APIs. Developers can integrate groups with enterprise business systems through these APIs.

#### Group management

| **API**                                                                                         | **Description**                                                                          | **API version** |
| ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | --------------- |
| [Create a Group Chat](/open/development/create-common-group-new-version-v2)                     | Create an Internal Group or a Standard Group Chat.                                       | New             |
| [Update a Group Chat](/open/development/api-updategroup)                                        | Update the basic information and members of a specified Group Chat by chatid.            | New             |
| [Query group information](/open/development/obtain-a-group-session)                             | Retrieve the Group settings and member information.                                      | Legacy          |
| [Update a member's group nickname](/open/development/set-a-group-nickname)                      | Update a member's nickname within a group.                                               | Legacy          |
| [Set organization Group admins in batches](/open/development/batch-setup-group-administrator)   | Grant or revoke admin permissions for organization Group members in batches.             | New             |
| [Turn off Private Chat](/open/development/set-private-chat)                                     | Configure whether Group members can add each other as Contacts and have direct messages. | Legacy          |
| [Get the Group QR Code invitation link](/open/development/obtain-a-qr-code-link)                | Retrieve the QR Code invitation link for joining a group.                                | Legacy          |
| [Get the OpenConversationId of a Group Chat](/open/development/obtain-group-openconversationid) | Query the OpenConversationId by chatId.                                                  | New             |

##### Group management

| **API**                                  | **Description**                                                                                 | **API version** |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------- | --------------- |
| Create a scenario-based group            | Create a group based on a group template ID.                                                    | New             |
| Update a scenario-based group            | Update group information by group ID.                                                           | New             |
| Add Group members                        | Add new members to a group (up to 1,000 members per group).                                     | New             |
| Remove Group members                     | Remove Group members by group ID and member ID.                                                 | New             |
| Query group information                  | Retrieve the group name, group icon, Group owner ID, join link, and Group settings by group ID. | Legacy          |
| Set the mute status of Group members     | Set the mute status of members in a scenario-based group.                                       | New             |
| Query group mute status                  | Query the mute status of a group and its members.                                               | New             |
| Update a member's group nickname         | Update a member's group nickname by group ID and member ID.                                     | New             |
| Update Group admins                      | Update the Group admins of a group.                                                             | New             |
| Query brief group information            | Retrieve basic information such as the group name, group icon, and Group owner ID by group ID.  | New             |
| Query Group members                      | Query Group member information.                                                                 | New             |
| Delete a Group Chat                      | Delete a specified group by group ID.                                                           | New             |
| Query the group template bots in a group | Query information about the group template bots in a group.                                     | New             |

##### Group templates

| **API**                  | **Description**                                | **API version** |
| ------------------------ | ---------------------------------------------- | --------------- |
| Enable a group template  | Enable a group template by group template ID.  | Legacy          |
| Disable a group template | Disable a group template by group template ID. | Legacy          |

##### Pinned card

| **API**                                     | **Description**                                                | **API version** |
| ------------------------------------------- | -------------------------------------------------------------- | --------------- |
| Create and enable a pinned interactive card | Create and enable a pinned interactive card in a conversation. | New             |
| Close a pinned interactive card             | Close a pinned interactive card in a conversation.             | New             |

##### Group assistant

| **API**                        | **Description**                                                          | **API version** |
| ------------------------------ | ------------------------------------------------------------------------ | --------------- |
| Send a group assistant message | Send a message to a group through the bot defined in the group template. | Legacy          |

### Callback event list

Conversation management supports callback events such as deleting a Group Chat, adding members, removing members, and changing the Group owner. For more events, see the event subscription overview.

## Tutorials

DingTalk provides examples of the Integration flow for conversation management APIs.

* Create a Group Chat (scenario-based group)
* [Create a quick entry (group plugin)](/open/development/create-a-group-plug-in)
* [Send a message via the group assistant](/open/development/group-assistant-sends-a-message)
* [Create, query, modify, and manage Group Chats](/open/development/group-session-operation-process)
* [Pure pull mode for pinned cards](/open/development/pure-pull-mode-process-guide)

## Glossary

### Chat

DingTalk supports two main conversation types: **one-to-one Direct Message Chats** and **Group Chats**.

### Group members

All members that make up a Group Chat.

### Group management roles

The roles in a Group Chat that hold different group management permissions, including **Group owner, Group admin, and standard Group member**. Their permission scope ranks as follows: Group owner > Group admin > standard Group member.

### Group role

A role assigned to a Group member by the Group owner or a Group admin, such as "Product Manager" or "HR".

### Group template

By presetting a group template and using it to create a Group Chat, or by converting a standard Internal Group into a group that applies the template, you can install a variety of capabilities into the group at once, including Group settings, in-group bots, and in-group quick entries. You can also batch manage Group Chats through group templates. Group templates also support visibility scope settings and can be displayed in the group creation entry under the "+" icon, allowing users in the organization to create Custom Group Chats with a single click directly from the DingTalk client.

### Pinned card

Group Chats support inserting specified content into a group's pinned area via API to display notifications, announcements, and other information, improving message reach.

### Quick entry

Formerly known as group plugins. Open frequently used apps quickly from the in-group quick entry bar without redirecting to the workbench or app marketplace, enabling efficient business workflows within the group.

Group Chats support customizing quick entries for a specified group through group templates and Cool Apps, including the entry link and order. The quick entries in Single-chat bot conversations can also be configured at the organization level through APIs.

For instructions on creating a quick entry, see [Create a quick entry (group plugin)](/open/development/create-a-group-plug-in).

### chatId

A chatId uniquely identifies a **Group Chat**. It is returned by the group creation API.

<Warning>
  In future versions, **chatid** will no longer be used. Use **openConversationId** as the unique identifier for a Group Chat.
</Warning>

### openConversationId

An openConversationId uniquely identifies a **Group Chat**. It is returned by the group creation API.
