Overview of Message Extensions for One-to-One and Group Chat

The message extension feature for one-to-one and group chat allows you to add status identifiers (extension data in key-value pairs) to original messages, providing interfaces for adding, deleting, and querying extension information.

Use Cases

Message extensions can be used in business scenarios where status identifiers need to be added to original messages in one-to-one or group chat conversations. Here are some examples:

• Message Comments: You can add comments by setting extension information for the original message.
• Gift Redemption or Order Status Changes: This feature can be used to change the display status of a message. For example, when sending a gift to a user, the default status is "unclaimed," and after the user clicks, the message extension can be set to "claimed."

tip

The message extension interfaces for one-to-one and group chat only support one-to-one and group chat conversation types.

• Chatroom scenarios do not support message extensions. You cannot use message extensions in chatrooms.

Long-Term Storage of Message Extension Data

Message extension operations are implemented through a special type of message, which can be considered as an "extension operation message." The Cloud Storage for One-to-One and Group Messages service is enabled by default, which ensures that extension operation messages can still be retrieved in cases such as long-term client inactivity.

The Cloud Storage for One-to-One and Group Messages feature ensures that senders can retrieve historical messages (including extension operation messages) even if they have not logged into the client for a long time or if messages are not stored locally.

• Messages are stored in the server's historical message database, with a default retention period of 6 months. Messages that have not been retrieved for a long time or have been deleted locally can be retrieved through the client SDK's interface for pulling historical messages from the server.

The Cloud Storage for One-to-One and Group Messages service is enabled by default. If you are using an App Key in the production environment, this service is available for Chat Starter Plan or Chat Pro Plan. For specific features and pricing, please refer to the Billing Documentation.