Note：
This document provides the changelog for the V4 SDK. The V4 SDK (@tencentcloud/lite-chat) introduces a new architecture, superseding the V3 SDK (@tencentcloud/chat). We recommend upgrading to the latest version promptly to benefit from enhanced product stability and real-time support.
4.3.0 @2025-04-22
Feature
Added the getServerTime method.
Fix
Fixed an issue where key-value parsing was incorrect when updating group custom fields.
Fixed an issue where updating user custom fields did not work as expected.
Fixed an issue where custom friend fields were returned as empty.
Fixed an issue where updating the lastMessage in a conversation was triggered by non-roaming groupTips messages.
Fixed an issue where unread counts could not be cleared due to immediate read reporting upon message receipt.
Fixed an issue where the local login state was not cleared after the userSig expired.
Fixed an issue where multiple instance kick notifications were received after re-logging in with an expired userSig.
Fixed an issue where commercial capability bits were parsed incorrectly after login.
4.2.9 @2025-04-03
Feature
Added event notifications for changes to group member roles (role) and group name cards (nameCard).
Fix
Fixed an issue where the image compression type was incorrectly recorded for local messages after sending an image.
4.2.8 @2025-03-27
Feature
Added support for the Saudi site.
Fix
Fixed an issue where modifying messages by directly assigning payload had no effect.
Fixed an issue where lastMessage was not cleared after deleting C2C conversation history.
Optimized notification logic for online member changes in AVChatRoom.
Optimized the addFriend API to use mutual friend addition mode by default.
Optimized the deleteFriend API to use mutual friend deletion mode by default.
4.2.7 @2026.03.05
Fix
Fixed an issue where multi-client sync failed for pinned C2C conversations.
Fixed an issue where the isPeerRead field was not updated when fetching historical messages.
Fixed an issue with abnormal Map traversal in Edge browser environments.
Optimized conversation lastMessage preview text to support both Chinese and English.
Optimized audit notification cards for group invitations to display the invited user's avatar and nickname.
4.2.6 @2026.02.09
Feature
Added support for Feishu Mini Program.
Fix
Optimized the log reporting format for interfaces.
Fixed an issue where historical messages could not be fetched after rejoining a group chat and deleting the conversation.
Fixed an issue where the log reporting API threw uncaught exceptions when the network was disconnected.
Fixed an issue where the SDK incorrectly parsed conversationType when sending group system notifications via the REST API.
4.2.5 @2026.01.23
Feature
File upload size limits now support configuration via cloud control.
Added cloud control configuration for whether meeting groups count unread messages.
Fix
Fixed an issue where the nick field was empty when retrieving group tips messages.
Fixed an issue where the nameCard field was empty in the lastMessage of group conversations.
Fixed an issue where the isPinned property was empty after receiving messages in a conversation.
Fixed an issue where the MESSAGE_MODIFIED event was not triggered when asynchronous voice message moderation failed.
4.2.4 @2026.01.16
Feature
Added support for parsing streaming messages sent from the backend.
Fix
Fixed an issue where the subType field was empty in group conversations.
Fixed an issue where querying your own status using getUserStatus did not report commercial capabilities.
Optimized environment detection for uni-app when packaging desktop Mini Programs.
4.2.2 @2026.01.09
Feature
Added support for Alipay Mini Program.
Added support for Douyin Mini Program.
Fix
Fixed an issue when parsing the onlineOnlyFlag field in group messages.
Fixed an issue with merged forward messages not displaying correctly under the Vue2 framework.
Optimized session list update timing after login by adding a sync completion indicator.
Optimized the logic for converting voice message duration formats.
Increased the blacklist pagination fetch limit to 1000.
4.2.1 @2025.12.26
Fix
Fixed an issue where unread counts were incorrect after receiving group join notifications in newly created conversations.
Fixed issues with ESLint checks.
Optimized the error format when rich media message size validation fails.
Improved local creation of temporary conversations by providing default values for userProfile and groupProfile.
Optimized the log reporting format.
4.1.3 @2025.12.15
Fix
Fixed abnormal return values when retrieving community messages.
Fixed environment detection for WeChat Mini Program desktop on Windows.
Optimized TypeScript type declarations.
Optimized the error format thrown by sendMessage.
4.1.2 @2025.12.02
Fix
Fixed packaging issues with Taro under the Node 18 environment.
Fixed an issue where the revoker field in lastMessage was empty after re-fetching the conversation list.
Fixed an issue where image uploads failed when packaging an app with uniapp.
4.1.1 @2025.11.28
Fix
Fixed incorrect parsing of group notifications when users leave AVChatRoom.
Fixed an issue where the avatar field was empty in the response from the getFriendApplicationList API.
4.1.0 @2025.11.20
Feature
Added support for instant transfer of rich media messages.
Added support for Douyin Mini Game.
Added support for WeChat Mini Game.
Fix
Fixed inaccurate isPeerRead status.
Fixed an issue where image uploads failed on certain iOS devices when packaging an app with uniapp.
Fixed issues with parsing Live custom notifications.
Optimized parameter validation for acceptFriendApplication.
Optimized the return value format for joinGroup.
4.0.0 @2025.11.06
Package size optimization for flexible integration:
Offers Lite, Standard, and Full editions, allowing developers to import only what they need. The Lite edition is approximately 200 KB.
Simplified integration process:
The V4 architecture streamlines the upload process for rich media messages, removing the need to import and register upload plugins.
Ongoing future enhancements:
V4 maintains high compatibility with V3. All future features and technical updates will be introduced starting from the V4 version.