onMessageSeenmessage

onMessageSeenmessage is a client-side event or callback used in some messaging SDKs to indicate that a message has been seen by recipients. It is part of read receipt functionality, allowing applications to reflect when a user has viewed a message in chat interfaces.

Data and semantics

The event typically carries a payload that identifies the message and context. Common fields include messageId, chatId, seenAt (timestamp), and seenBy (the user or users who have seen the message). In one-to-one conversations, seenBy usually represents the other participant. In group chats, seenBy can be a list of members who have viewed the message, and seenAt may reflect the earliest or latest view time depending on the platform.

Behavior and usage

When a recipient opens or views a message, the server or client marks it as seen and emits onMessageSeenmessage to listeners. Developers use the event to update the user interface (for example, displaying a “Seen” indicator or a timestamp), and to refresh local caches or analytics. Because implementations vary, the exact payload shape and emission rules can differ between platforms or versions.

Privacy and limitations

Read receipts raise privacy considerations; some users or teams may disable read receipts, in which case the event might be reduced, hidden, or not emitted. Network latency and offline scenarios can delay or batch seen signals, so real-time updates are not guaranteed.

Relation to other events

onMessageSeenmessage is often used in conjunction with delivery events (delivered) and message updates (edited). It is one of several platform-specific hooks used to track message lifecycle in chat applications.