tencent cloud

Feedback

Last updated: 2023-07-17 17:00:59

    Feature Description

    With conversation lists, users can easily locate target conversations after they log in to the application.
    The conversation list feature includes getting the conversation list and listening for conversation list update events. The core data structure is Conversation.

    Getting the Conversation List

    Call the getConversationList API on the access side to get the conversation list.
    API
    chat.getConversationList(options);
    The options is as described below:
    Name
    Type
    Description
    options
    undefined | Array | Object
    If options is undefined, the SDK will return all the conversations.
    if options is of the Array type, it shall not be empty, the SDK will return specified conversations.
    if options is of the Object type, as {type, markType, groupName}, the SDK will return filtered conversations.
    Returned Value
    Promise
    Sample
    // Get the full conversation list
    let promise = chat.getConversationList();
    promise.then(function(imResponse) {
    // This full conversation list will overwrite the original conversation list.
    const conversationList = imResponse.data.conversationList;
    // Whether synchronizing the conversation list from the cloud is completed
    const isSyncCompleted = imResponse.data.isSyncCompleted;
    }).catch(function(imError){
    console.warn('getConversationList error:', imError); // Error information
    });
    // Get the list of specified conversations
    let promise = chat.getConversationList([conversationID1, conversationID2]);
    promise.then(function(imResponse) {
    // List of specified conversations that already exist in the cache
    const conversationList = imResponse.data.conversationList;
    }).catch(function(imError){
    console.warn('getConversationList error:', imError); // Error information
    });
    // Get all group conversations
    let promise = chat.getConversationList({ type: TencentCloudChat.TYPES.CONV_GROUP });
    promise.then(function(imResponse) {
    const conversationList = imResponse.data.conversationList; // Conversation list
    });
    // Obtain all conversations that are marked as "favorite"
    let promise = chat.getConversationList({ markType: TencentCloudChat.TYPES.CONV_MARK_TYPE_STAR });
    promise.then(function(imResponse) {
    const conversationList = imResponse.data.conversationList; // Conversation list
    });
    // Obtain all conversations in a specified conversation group
    let promise = chat.getConversationList({ groupName: 'Suppliers' });
    promise.then(function(imResponse) {
    const conversationList = imResponse.data.conversationList; // Conversation list
    });

    Listening for Conversation List Update Events

    Listen for TencentCloudChat.EVENT.CONVERSATION_LIST_UPDATED events on the access side to get conversation list update notifications.
    Sample
    let onConversationListUpdated = function(event) {
    console.log(event.data); // Array that stores Conversation instances
    };
    chat.on(TencentCloudChat.EVENT.CONVERSATION_LIST_UPDATED, onConversationListUpdated);
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support