- Release Notes
- Product Introduction
- Purchase Guide
- Getting Started with Demos
- Console Guide
- SDK Documentation
- SDK Download
- Quick Integration (Including UI Library)
- General Integration (No UI Library)
- Update Logs (Web & Mini Programs)
- Update Log (Native)
- Update Log (Unity)
- Legacy API Tutorials
- Client APIs
- Server APIs
- Generating UserSig
- RESTful APIs
- RESTful API Overview
- RESTful API List
- Account Management
- One-to-One Messages
- Profile Management
- Pushing to All Users
- Relationship Chain Management
- Group Management
- Getting All Groups in an App
- Creating a Group
- Getting Group Profiles
- Getting Group Member Profiles
- Modifying the Profile of a Group
- Adding Group Members
- Deleting Group Members
- Modifying the Profile of a Group Member
- Disbanding a Group
- Getting the Groups a User Has Joined
- Querying the Roles of Users in a Group
- Bulk Muting and Unmuting
- Getting the List of Muted Group Members
- Sending Ordinary Messages in a Group
- Sending System Messages in a Group
- Recalling Group Messages
- Changing Group Owner
- Importing a Group Profile
- Importing Group Messages
- Importing Group Members
- Setting the Unread Message Count of a Member
- Recalling Messages Sent by a Specified User
- Pulling Historical Messages
- Getting the Number of Online Users in an Audio-Video Group
- Global Mute Management
- Operations Management
- Online States
- Third-Party Callbacks
- Third-Party Callback Overview
- Callback Command List
- Online Status Callbacks
- Relationship Chain Callbacks
- One-to-One Message Callbacks
- Group System Callbacks
- Callback Before Creating a Group
- Callback After Creating a Group
- Callback Before Accepting a Request to Join a Group
- Callback Before Accepting a Request to Add a User to a Group
- Callback After a User Joins a Group
- Callback After a User Leaves a Group
- Callback Before Sending a Group Message
- Callback After Sending a Group Message
- Callback After a Group Is Full
- Callback After Disbanding a Group
- Callback After Modifying Group Profile
- Callback Mutual Authentication Configuration Guide
- Best Practices
- FAQs
- General References
- Error Codes
- Release Notes
- Product Introduction
- Purchase Guide
- Getting Started with Demos
- Console Guide
- SDK Documentation
- SDK Download
- Quick Integration (Including UI Library)
- General Integration (No UI Library)
- Update Logs (Web & Mini Programs)
- Update Log (Native)
- Update Log (Unity)
- Legacy API Tutorials
- Client APIs
- Server APIs
- Generating UserSig
- RESTful APIs
- RESTful API Overview
- RESTful API List
- Account Management
- One-to-One Messages
- Profile Management
- Pushing to All Users
- Relationship Chain Management
- Group Management
- Getting All Groups in an App
- Creating a Group
- Getting Group Profiles
- Getting Group Member Profiles
- Modifying the Profile of a Group
- Adding Group Members
- Deleting Group Members
- Modifying the Profile of a Group Member
- Disbanding a Group
- Getting the Groups a User Has Joined
- Querying the Roles of Users in a Group
- Bulk Muting and Unmuting
- Getting the List of Muted Group Members
- Sending Ordinary Messages in a Group
- Sending System Messages in a Group
- Recalling Group Messages
- Changing Group Owner
- Importing a Group Profile
- Importing Group Messages
- Importing Group Members
- Setting the Unread Message Count of a Member
- Recalling Messages Sent by a Specified User
- Pulling Historical Messages
- Getting the Number of Online Users in an Audio-Video Group
- Global Mute Management
- Operations Management
- Online States
- Third-Party Callbacks
- Third-Party Callback Overview
- Callback Command List
- Online Status Callbacks
- Relationship Chain Callbacks
- One-to-One Message Callbacks
- Group System Callbacks
- Callback Before Creating a Group
- Callback After Creating a Group
- Callback Before Accepting a Request to Join a Group
- Callback Before Accepting a Request to Add a User to a Group
- Callback After a User Joins a Group
- Callback After a User Leaves a Group
- Callback Before Sending a Group Message
- Callback After Sending a Group Message
- Callback After a Group Is Full
- Callback After Disbanding a Group
- Callback After Modifying Group Profile
- Callback Mutual Authentication Configuration Guide
- Best Practices
- FAQs
- General References
- Error Codes
Based on common use cases, Instant Messaging (IM) supports the following group types by default: work group (Work), public group (Public), meeting group (Meeting), and audio-video chat room (AVChatRoom). For more information, see Group Types.
You can perform the following operations on groups:
| Group Operation | Description | Notes |
|---|---|---|
| Create a group | This operation creates a new group. You can specify the group type, name, and a list of users to add to the group. After the group is created, the group ID is returned, which uniquely identifies the group and is used to send and receive messages. | The daily limit of net group consumption is 10,000 per app. |
| Transfer a group | This operation changes the group owner. | The app admin can transfer a group through the RESTful API. The only other role that can transfer a group is the group owner. |
| Disband a group | This operation disbands a group that has been created on the app. When the group is disbanded, all group members receive a system message stating that the group has been disbanded. | App admin can call the RESTful API to disband any group. The permission to disband groups on the app is limited by member roles: For a public group, meeting group, or AVChatRoom, only the group owner can disband the group. For a work group, no one in the group can disband the group. |
Note：
- When you create a group, IM assigns a default group ID that begins with @TGS#. You can also specify a group ID. For more information, see Custom Group IDs.
- After the group is created, a system message about the group creation is sent to the group owner's device to ensure synchronization across multiple devices (once a group is created on 1 device, all devices instantly perceive the created group.)
Group Profile Management
The group profile includes properties that are specific to a single group, such as the group name, overview, announcement, and group owner, as well as custom group fields.
| Group Profile Management | Description | Notes |
|---|---|---|
| Obtain the group profile | Pull basic group information. If you want to pull custom information, configure APIs for the custom fields that you want to pull. | Group members obtain the group profile: group members can obtain the group profile. Non-members obtain the group profile: non-members can only obtain the group profile that has been made public. Obtain the personal profile in the group: users can obtain their own profiles in all groups, or in a single group. Obtain the profile of a group member: in an AVChatRoom, only some members' profiles are available, including the group owner, admins, and some group members. |
| Modify the group profile | You can modify the group name, introduction, announcement, profile photo, group name card, membership application option, group-level custom fields, roles of group members, member-level custom fields, and group message receiving options. | Currently, you can configure callbacks for group name, introduction, announcement, and profile photo URL changes for the app in the console. To enable callbacks for changes in other group information, including group-level custom fields, submit a ticket. |
Group Member/Group Management
Group member management involves 2 aspects:
- Obtain and modify personal information in the group. This information can be obtained and set only by users themselves, for example, message receiving options.
- Obtain and modify other group members' information, including the role, joining time, time of the last message, group name card, and member-level custom information.
| Group Member Management | Description | Notes |
|---|---|---|
| Obtain group member information | Obtain personal information or other group members' information. | Available information includes role, joining time, time of last message, group name card, and member-level custom information. |
| Modify a group member's profile | The group owner, admins, and members can modify group member profiles. | |
| Invite to a group | Add non-members to a group. | |
| Apply to join a group | A user proactively applies to join a group through the IM SDK. | ApplyJoinOption field in the group profile. |
| Delete a group member | The group owner or a group admin removes a group member from the group. | When a group member is removed from the group by the group owner or a group admin, the member receives a system message announcing the removal, and other members in the group also receive an event message about the removal. |
| Quit a group | A group member initiates the quit operation. | When a group member quits the group, the leaving member receives a system message stating that he or she has left the group, and other members in the group also receive an event message about the member quitting the group. |
| Obtain the list of groups a user has joined | Pull the list of groups that the current user has joined. The returned result contains only part of the basic information. | To obtain detailed group information, use the group members obtain the group profile feature. |
| List of pending group messages | A group's pending messages include all group operations that require approval. | You can pull the list of pending group messages, report pending read messages, and process pending group messages (approve or reject). |
Yes
No
Was this page helpful?