Conversation groups overview

Conversation groups organize the signed-in user's conversation list. They manage relationships between conversationID values and groups. They do not create chat groups, modify group membership, or change message targets.

The iOS enterprise SDK exposes conversation-group capabilities through OpenIMCore Objective-C functions distributed with OpenIMSDK; they are not yet wrapped in high-level OIMManager model APIs. Requests, results, and listener payloads are JSON NSString values. Parse them with NSJSONSerialization instead of inventing an OIMConversationGroup class.

Group types

Use 0 for ordinary user-defined categories. The rules that generate filtered groups depend on the current OpenIMServer deployment.

Available operations

• Create a conversation group
• Retrieve conversation groups
• Retrieve conversations in a group
• Retrieve the groups containing a conversation
• Update a conversation group
• Set conversation-group order
• Add conversations to groups
• Remove conversations from groups
• Delete a conversation group

Set the conversation-group listener

Open_im_sdkSetConversationGroupListener stores only one Open_im_sdk_callbackOnConversationGroupListener. No public remove or unset function is available, so retain the listener in an account-scoped state layer and set it centrally once.

#import <OpenIMSDK/CallbackProxy.h>
@import OpenIMCore;

@interface ConversationGroupStore () <Open_im_sdk_callbackOnConversationGroupListener>
@end

@implementation ConversationGroupStore

- (void)startListening {
    Open_im_sdkSetConversationGroupListener(self);
}

- (void)onConversationGroupAdded:(NSString * _Nullable)json {
    [self mergeConversationGroupsJSON:json];
}

- (void)onConversationGroupChanged:(NSString * _Nullable)json {
    [self mergeConversationGroupsJSON:json];
}

- (void)onConversationGroupDeleted:(NSString * _Nullable)json {
    [self removeConversationGroupsJSON:json];
}

- (void)onConversationGroupMemberAdded:(NSString * _Nullable)json {
    [self mergeConversationGroupMembersJSON:json];
}

- (void)onConversationGroupMemberDeleted:(NSString * _Nullable)json {
    [self removeConversationGroupMembersJSON:json];
}

@end

The added, changed, and deleted payloads are JSON arrays of groups. Membership-change payloads contain group, conversationIDs, and conversations. Merge groups idempotently by conversationGroupID, and identify membership using both conversationGroupID and conversationID.

When switching accounts, stop the old listener from dispatching updates to the UI, then replace it with the new account's complete listener. A successful call, an incremental listener update, and a newly queried snapshot are three separate stages.