Conversation
.getConversationList
API on the access side to get the conversation list.chat.getConversationList(options);
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. |
Promise
// Get the full conversation listlet 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 completedconst isSyncCompleted = imResponse.data.isSyncCompleted;}).catch(function(imError){console.warn('getConversationList error:', imError); // Error information});
// Get the list of specified conversationslet promise = chat.getConversationList([conversationID1, conversationID2]);promise.then(function(imResponse) {// List of specified conversations that already exist in the cacheconst conversationList = imResponse.data.conversationList;}).catch(function(imError){console.warn('getConversationList error:', imError); // Error information});
// Get all group conversationslet promise = chat.getConversationList({ type: TencentCloudChat.TYPES.CONV_GROUP });promise.then(function(imResponse) {const conversationList = imResponse.data.conversationList; // Conversation list});
// Get 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});
// Get all unmarked conversations (supported from v3.3.0 onwards)let promise = chat.getConversationList({ markType: 0 });promise.then(function(imResponse) {const conversationList = imResponse.data.conversationList; // Conversation list});
// Get all conversations in a specified conversation grouplet promise = chat.getConversationList({ groupName: 'Suppliers' });promise.then(function(imResponse) {const conversationList = imResponse.data.conversationList; // Conversation list});
// Get conversations that do not belong to any group (supported from v3.3.0 onwards)let promise = chat.getConversationList({ groupName: '' });promise.then(function(imResponse) {const conversationList = imResponse.data.conversationList; // Conversation list});
// Get conversations with unread counts (supported from v3.3.0 onwards)let promise = chat.getConversationList({ hasUnreadCount: true });promise.then(function(imResponse) {const conversationList = imResponse.data.conversationList; // Conversation list});
// Get conversations with group @ messages (supported from v3.3.0 onwards)let promise = chat.getConversationList({ hasGroupAtInfo: true });promise.then(function(imResponse) {const conversationList = imResponse.data.conversationList; // Conversation List});
TencentCloudChat.EVENT.CONVERSATION_LIST_UPDATED
events on the access side to get conversation list update notifications.let onConversationListUpdated = function(event) {console.log(event.data); // Array that stores Conversation instances};chat.on(TencentCloudChat.EVENT.CONVERSATION_LIST_UPDATED, onConversationListUpdated);
Was this page helpful?