Skip to main content
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

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

Group management
Group templates
Pinned card
Group assistant

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.

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

chatId

A chatId uniquely identifies a Group Chat. It is returned by the group creation API.
In future versions, chatid will no longer be used. Use openConversationId as the unique identifier for a Group Chat.

openConversationId

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