please select
  • UIKit
  • SDK
  • Server APIs
Chat/
SDK/
Android/
Conversation/
SDK
  • Install Chat SDK
  • Initialize Chat SDK
  • Login and Logout
  • Message
    • Overview
    • Send a Message
    • Receive a Message
    • Retrieve Messages
    • Forward Messages
    • Modify a Message
    • Insert a Message
    • Delete Messages
    • Clear History Messages
    • Recall a Message
    • Send an Online Message
    • Message Read Receipt
    • Query Messages
    • Mentions
    • Targeted Group Message
    • Do not Notify
    • Key-Value Extensions
    • Reactions
    • Translation
    • Pin Messages
  • Conversation
    • Overview
    • Conversation List
    • Get Conversations
    • Unread Count
    • Pin Conversations
    • Delete Conversations
    • Draft
    • Mark
    • Conversation Group
  • Group
    • Overview
    • Manage Group
    • Profile
    • Manage Members
    • Member Profile
    • Attribute
    • Counter
  • Community and Topic
    • Manage Community
    • Permission Group
  • User
    • User Profile
    • User Status
    • Manage Friends
    • Friend Group
    • Block Lists
    • Follow
  • Local Search
    • Search Messages
    • Search Friends
    • Search Groups
    • Search Group Members
  • Signaling
  • API Reference
    • Java
  • Guideline for Beginners
  • Console Guide
    • Creating and Upgrading an Application
    • Basic Configuration
    • Feature Configuration
    • Account Management
    • Group Management
    • Webhook Configuration
  • Product Introduction
    • Message Management
      • One-to-One Message
      • Message Storage
      • Offline Push
      • Group Message
      • Message Formats
    • Account System
      • Login Authentication
      • Online Status Management
    • Group Related
      • Group System
      • Group Management
    • User Profile and Relationship Chain
      • Profile Management
      • Relationship Chain Management
  • Purchase Guide
    • Billing Overview
    • Pricing
  • Error Codes
Docs Overview/
Chat/
SDK/
Android/
Conversation/
Delete Conversations/

Delete Conversations

Overview

After a user deletes a friend or leaves a group, the SDK will not automatically delete the corresponding one-to-one or group conversation. The user can call the following API to delete the conversation.
Multi-client sync is not supported for conversation deletion by default and can be enabled in the IM console.



Note
Multi-client sync for conversation deletion is supported only by the SDK on v5.1.1 or later.

Delete a single conversation

Call the deleteConversation API (Android / iOS and macOS / Windows) to delete a specified conversation.
Note：
When a conversation is deleted, the historical messages will be deleted from both the client and the server and cannot be recovered. If you want to keep historical messages, please delete multiple conversations.
Sample code:
Android
iOS and macOS
Windows
String conversationID = "conversationID";
V2TIMManager.getConversationManager().deleteConversation(conversationID, new V2TIMCallback() {
    @Override
    public void onSuccess() {
        // The conversation is deleted successfully.
    }
    @Override
    public void onError(int code, String desc) {
        // Failed to delete the conversation
    }
});
NSString *conversationID = @"conversationID";
[[V2TIMManager sharedInstance] deleteConversation:conversationID
    succ:^{
        // The conversation is deleted successfully.
    }
    fail:^(int code, NSString *desc) {
        // Failed to delete the conversation
    }];
class Callback final : public V2TIMCallback {
public:
    using SuccessCallback = std::function<void()>;
    using ErrorCallback = std::function<void(int, const V2TIMString&)>;

    Callback() = default;
    ~Callback() override = default;

    void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
        success_callback_ = std::move(success_callback);
        error_callback_ = std::move(error_callback);
    }
    void OnSuccess() override {
        if (success_callback_) {
            success_callback_();
        }
    }
    void OnError(int error_code, const V2TIMString& error_message) override {
        if (error_callback_) {
            error_callback_(error_code, error_message);
        }
    }
private:
    SuccessCallback success_callback_;
    ErrorCallback error_callback_;
};

V2TIMString groupName = u8"conversationID";
auto callback = new Callback;
callback->SetCallback(
    [=]() {
        // The conversation is deleted successfully.
        delete callback;
    },
    [=](int error_code, const V2TIMString& error_message) {
        // Failed to delete the conversation
        delete callback;
    });
V2TIMManager::GetInstance()->GetConversationManager()->DeleteConversationGroup(groupName, callback);

Delete multiple conversations

Call the deleteConversation API (Android / iOS and macOS / Windows) to delete specified conversations. When clearMessage is set to false, the historical messages will be retained; when set to true, client and server messages will be deleted together and cannot be restored.
Note：
This feature is supported only by the SDK on v7.1 or later.
Up to 100 conversations can be deleted at a time.
Sample code:
Android
iOS & macOS
Windows
List<String> conversationIDList = new ArrayList<>();
conversationIDList.add("c2c_userID");
conversationIDList.add("group_groupID");
V2TIMManager.getConversationManager().deleteConversationList(
    conversationIDList, true, new V2TIMValueCallback<List<V2TIMConversationOperationResult>>() {
        @Override
        public void onSuccess(List<V2TIMConversationOperationResult> results) {
            // The conversations are deleted successfully.
            for (V2TIMConversationOperationResult result : results) {
                int code = result.getResultCode();
                String info = result.getResultInfo();
                String conversationID = result.getConversationID();
            }
        }
        @Override
        public void onError(int code, String desc) {
            // Failed to delete the conversations
        }
    });
NSMutableArray *conversationIDList = [NSMutableArray array];
[conversationIDList addObject:@"c2c_userID"];
[conversationIDList addObject:@"group_groupID"];
[[V2TIMManager sharedInstance] deleteConversationList:conversationIDList
    clearMessage:true
    succ:^(NSArray<V2TIMConversationOperationResult *> *results) {
        // The conversations are deleted successfully.
        for (V2TIMConversationOperationResult *result in results) {
            int code = result.resultCode;
            NSString *info = result.resultInfo;
            NSString *conversationID = result.conversationID;
        }
    }
    fail:^(int code, NSString *desc) {
        // Failed to delete the conversations
    }];
template <class T>
class ValueCallback final : public V2TIMValueCallback<T> {
public:
    using SuccessCallback = std::function<void(const T&)>;
    using ErrorCallback = std::function<void(int, const V2TIMString&)>;

    ValueCallback() = default;
    ~ValueCallback() override = default;

    void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {
        success_callback_ = std::move(success_callback);
        error_callback_ = std::move(error_callback);
    }
    void OnSuccess(const T& value) override {
        if (success_callback_) {
            success_callback_(value);
        }
    }
    void OnError(int error_code, const V2TIMString& error_message) override {
        if (error_callback_) {
            error_callback_(error_code, error_message);
        }
    }
private:
    SuccessCallback success_callback_;
    ErrorCallback error_callback_;
};

V2TIMStringVector conversationIDList;
conversationIDList.PushBack(u8"c2c_userID");
conversationIDList.PushBack(u8"group_groupID");
auto callback = new ValueCallback<V2TIMConversationOperationResultVector>{};
callback->SetCallback(
    [=](const V2TIMConversationOperationResultVector& results) {
        // The conversations are deleted successfully.
        for (size_t i = 0; i < results.Size(); ++i) {
            const V2TIMConversationOperationResult& result = results[i];
            int code = result.resultCode;
            V2TIMString info = result.resultInfo;
            V2TIMString conversationID = result.conversationID;
        }
        delete callback;
    },
    [=](int error_code, const V2TIMString& error_message) {
        // Failed to delete the conversations
        delete callback;
    });
V2TIMManager::GetInstance()->GetConversationManager()->DeleteConversationList(conversationIDList, true, callback);

Conversation Deleted Notification

If you have called addConversationListener(Android / iOS & Mac / Windows) to add a conversation listener, you can get the notification that the conversation is deleted in onConversationDeleted.
Android
iOS & macOS
Windows
@Override
public void onConversationDeleted(List<String> conversationIDList) {
    Log.i("imsdk", "onConversationDeleted");
}
- (void)onConversationDeleted:(NSArray<NSString *> *)conversationIDList {
    // Received the notification that the conversation is deleted
}
void OnConversationDeleted(const V2TIMStringVector &conversationIDList) override {
    // Received the notification that the conversation is deleted
}