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.