Delete all messages of a user in a group

Delete all historical messages posted by a specific user within a group conversation:

This administrative action is typically initiated by group owners or managers to moderate chat logs and remove spam or abusive content.

await OpenIMSDK.deleteUserAllMessagesInConv({
  conversationID,
  userID,
});

Parameters

Return value

A resolved Promise confirms that the deletion request was validated and executed on the server. Permissions are enforced according to group roles; invoking this method without administrative privileges returns an error.

Listen for user message deletions

When a user's messages are removed from a group, the SDK emits the OnDeleteUserAllMsgsInConv event. The callback payload provides the target conversationID and userID. Locate the active conversation and filter out all messages sent by userID.

interface DeleteUserAllMsgsData {
  conversationID: string;
  userID: string;
}

const handleUserMessagesDeleted = (data: DeleteUserAllMsgsData) => {
  // Locate the target conversation by data.conversationID and filter out messages from data.userID
};

// Register listener
OpenIMSDK.on(
  OpenIMEvent.OnDeleteUserAllMsgsInConv,
  handleUserMessagesDeleted,
);

// Unregister listener on cleanup
OpenIMSDK.off(
  OpenIMEvent.OnDeleteUserAllMsgsInConv,
  handleUserMessagesDeleted,
);

Always unregister listeners using identical function references when unmounting components or signing out.