Read Receipt

Description

Read Receipt is used to notify the sender that "the recipient has read the sent message". When the recipient reads the message, a read message is reported, the backend system will generate a notification to inform the sender that the message has been viewed.
In instant messaging tools (WhatsApp, WeChat, etc.), when the recipient views the message, the sender will see a read receipt next to the message, such as a blue check mark or the word "read".
Note:
"Receipt" means "Reply Receipt", which represents a credential for confirming receipt. When you send a message and request a receipt, you are actually asking the other party "I want to confirm whether you have received and read my message". This confirmation is like a "receipt", proving that your message has been received.
Read receipts help ensure important messages has been viewed but can also cause psychological stress and privacy issues. Therefore, we support users to turn off the read receipt feature.
Note:
1. This feature is only supported by the premium edition. Please purchase the premium edition to use it.
2. "Group Chat Message Read Receipt" is supported from TUIKit 6.2.2363 version and later.
3. "One-to-one Chat Message Read Receipt" is supported from TUIKit 6.3.2609 version and later.

Effect

One-to-one Chat Message Read Receipt

Indicated by ✔️ or highlighted ✔️✔️ on the message


Group Chat Message Read Receipt

Message reading status is indicated on the message:
When no one has read it, ✔️ is displayed;
When some chat members have read it, gray ✔️✔️ is displayed;
When everyone has read it, highlighted ✔️✔️ is displayed.

Message List



Read Receipt Details

Click the read status to enter the read receipt details page.


Enabling Message Read Receipt

In the TUIChat component, within the GeneralConfig.java file, a switch for the "Message Read Receipt" feature, named msgNeedReadReceipt, is provided. Its type is boolean, with a default value of false.
public class GeneralConfig {
private boolean msgNeedReadReceipt = false;
}
If you want to enable the "Message Read Receipt" feature, please first activate the premium edition and then change the default value of msgNeedReadReceipt to true, or call the following method to enable it before the chat page is initialized.
TUIChatConfigs.getConfigs().getGeneralConfig().setMsgNeedReadReceipt(true);

FAQs

Error: The usage of this API is not supported by the package. Please upgrade to the premium edition.
The "Message Read Receipt" feature is only supported by the premium package. This error message indicates that your current package does not support this capability. Please log in to the Chat purchase page to activate the premium edition for experience.