> ## Documentation Index > Fetch the complete documentation index at: https://wukong.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Conversation Management > WuKongIM iOS SDK conversation management functionality, including conversation lists, unread messages and conversation extensions Responsible for managing recent conversation data, such as: adding recent conversations, deleting recent conversations, unread message counts, etc. This documentation only covers core methods. For more details, check the `[WKSDK shared].conversationManager` interface in the code. ## Recent Conversation List ### Data Operations Get local recent conversation list: ```objc theme={null} NSArray *conversations = [[WKSDK shared].conversationManager getConversationList]; ``` ### Data Monitoring Add `WKConversationManagerDelegate`: ```objc theme={null} [[WKSDK shared].conversationManager addDelegate:self]; ``` WKConversationManagerDelegate description: ```objc theme={null} /** Called when recent conversation objects are updated @param conversations Recent conversation collection */ - (void)onConversationUpdate:(NSArray*)conversations; /** Recent conversation unread count changes @param channel Channel @param unreadCount Unread count */ - (void)onConversationUnreadCountUpdate:(WKChannel*)channel unreadCount:(NSInteger)unreadCount; /** Conversation deleted @param channel Deleted conversation channel */ - (void)onConversationDelete:(WKChannel*)channel; /** New conversation added @param conversation New conversation */ - (void)onConversationAdd:(WKConversation*)conversation; ``` ### Data Source `Trigger timing: After establishing connection, SDK actively triggers pulling recent conversations after going offline` Incrementally sync recent conversation data after going offline: ```objc theme={null} // version Data version number // lastMsgSeqs Concatenated recent conversation seq relationship data // callback SDK should call this callback when getting messages from server (Note: callback must be called regardless of success or failure) [[WKSDK shared].conversationManager setSyncConversationProviderAndAck:^(long long version, NSString * _Nonnull lastMsgSeqs, WKSyncConversationCallback _Nonnull callback) { // Implement your server API call here // Example: [YourAPIManager syncConversations:version lastMsgSeqs:lastMsgSeqs success:^(NSArray *conversations, long long newVersion) { callback(conversations, newVersion, nil); } failure:^(NSError *error) { callback(nil, version, error); }]; } ack:^(uint64_t cmdVersion, void (^ _Nullable complete)(NSError * _Nullable)) { // If ack receipt is not needed, directly call complete(nil); complete(nil); }]; ``` ## Recent Conversation Extensions Through recent conversation extension properties, you can customize your unique business attributes, such as implementing draft functionality similar to WeChat, with draft data synchronized across multiple devices. ### Data Operations #### Update Extensions ```objc theme={null} [[WKSDK shared].conversationManager updateOrAddExtra:(WKConversationExtra*)extra] ``` #### Sync Extensions ```objc theme={null} [[WKSDK shared].conversationManager syncExtra] ``` ### Data Monitoring Any data changes to recent conversation objects will trigger the `WKConversationManagerDelegate` delegate. Similarly, calling `updateOrAddExtra` will also trigger this delegate. ### Data Source #### Update Extensions `Trigger timing: Triggered when calling [[WKSDK shared].conversationManager updateOrAddExtra]` ```objc theme={null} // extra Updated extension data // callback Callback to SDK after update completion [[WKSDK shared].conversationManager setUpdateConversationExtraProvider:^(WKConversationExtra * _Nonnull extra, WKUpdateConversationExtraCallback _Nonnull callback) { // Implement your server API call here // Example: [YourAPIManager updateConversationExtra:extra success:^{ callback(nil); } failure:^(NSError *error) { callback(error); }]; }]; ``` #### Sync Extensions `Trigger timing: Triggered when calling [[WKSDK shared].conversationManager syncExtra]` ```objc theme={null} // version Latest extension data version existing on client // callback Callback data to SDK after syncing extensions [[WKSDK shared].conversationManager setSyncConversationExtraProvider:^(long long version, WKSyncConversationExtraCallback _Nonnull callback) { // Implement your server API call here // Example: [YourAPIManager syncConversationExtras:version success:^(NSArray *extras, long long newVersion) { callback(extras, newVersion, nil); } failure:^(NSError *error) { callback(nil, version, error); }]; }]; ``` ## Conversation Operations ### Delete Conversation ```objc theme={null} // Delete a conversation WKChannel *channel = [[WKChannel alloc] initWith:@"user123" channelType:WK_PERSON]; [[WKSDK shared].conversationManager deleteConversation:channel]; ``` ### Clear Unread Count ```objc theme={null} // Clear unread count for a conversation WKChannel *channel = [[WKChannel alloc] initWith:@"user123" channelType:WK_PERSON]; [[WKSDK shared].conversationManager clearUnreadCount:channel]; ``` ### Set Conversation Draft ```objc theme={null} // Set draft for a conversation using extensions WKChannel *channel = [[WKChannel alloc] initWith:@"user123" channelType:WK_PERSON]; WKConversationExtra *extra = [[WKConversationExtra alloc] init]; extra.channel = channel; extra.draft = @"This is a draft message..."; extra.draftUpdatedAt = [[NSDate date] timeIntervalSince1970]; [[WKSDK shared].conversationManager updateOrAddExtra:extra]; ``` ### Get Conversation by Channel ```objc theme={null} // Get specific conversation WKChannel *channel = [[WKChannel alloc] initWith:@"user123" channelType:WK_PERSON]; WKConversation *conversation = [[WKSDK shared].conversationManager getConversation:channel]; if (conversation) { NSLog(@"Unread count: %ld", conversation.unreadCount); NSLog(@"Last message: %@", conversation.lastMessage.content); } ``` ## Core Class Properties ### WKConversation ```objc theme={null} @interface WKConversation : NSObject // Channel information @property(nonatomic,strong) WKChannel *channel; // Last message @property(nonatomic,strong) WKMessage *lastMessage; // Unread message count @property(nonatomic,assign) NSInteger unreadCount; // Conversation timestamp @property(nonatomic,assign) NSTimeInterval timestamp; // Whether conversation is pinned @property(nonatomic,assign) BOOL stick; // Conversation extensions @property(nonatomic,strong) WKConversationExtra *extra; @end ``` ### WKConversationExtra ```objc theme={null} @interface WKConversationExtra : NSObject // Channel @property(nonatomic,strong) WKChannel *channel; // Draft content @property(nonatomic,copy) NSString *draft; // Draft update time @property(nonatomic,assign) NSTimeInterval draftUpdatedAt; // Custom extension data @property(nonatomic,strong) NSMutableDictionary *extraData; // Extension version @property(nonatomic,assign) long long version; @end ``` ## Best Practices ### 1. Efficient Conversation Loading ```objc theme={null} - (void)loadConversations { // Get cached conversations first NSArray *conversations = [[WKSDK shared].conversationManager getConversationList]; if (conversations.count > 0) { [self updateConversationUI:conversations]; } // Sync latest data from server [[WKSDK shared].conversationManager syncConversations]; } ``` ### 2. Handle Conversation Updates ```objc theme={null} - (void)onConversationUpdate:(NSArray*)conversations { dispatch_async(dispatch_get_main_queue(), ^{ // Sort conversations by timestamp NSArray *sortedConversations = [conversations sortedArrayUsingComparator:^NSComparisonResult(WKConversation *obj1, WKConversation *obj2) { if (obj1.stick && !obj2.stick) return NSOrderedAscending; if (!obj1.stick && obj2.stick) return NSOrderedDescending; if (obj1.timestamp > obj2.timestamp) return NSOrderedAscending; if (obj1.timestamp < obj2.timestamp) return NSOrderedDescending; return NSOrderedSame; }]; [self updateConversationUI:sortedConversations]; }); } ``` ### 3. Draft Management ```objc theme={null} - (void)saveDraft:(NSString *)draftText forChannel:(WKChannel *)channel { WKConversationExtra *extra = [[WKSDK shared].conversationManager getConversationExtra:channel]; if (!extra) { extra = [[WKConversationExtra alloc] init]; extra.channel = channel; } extra.draft = draftText; extra.draftUpdatedAt = [[NSDate date] timeIntervalSince1970]; [[WKSDK shared].conversationManager updateOrAddExtra:extra]; } - (NSString *)getDraftForChannel:(WKChannel *)channel { WKConversationExtra *extra = [[WKSDK shared].conversationManager getConversationExtra:channel]; return extra.draft; } ``` ## Next Steps Learn how to handle multimedia messages Return to chat message management Manage channel information Manage connection status