Delivery & Read Receipts

Read receipts record how far each user has read in a conversation. Use them for "Seen by" avatars under a message, an unread badge on a conversation list ("3 new"), or a "the agent has seen your message" hint in support chat.

Where this fits: your app is connected to a conversation and shows messages. Your app tells Livqeno when the user has read something; Livqeno stores it and tells the other members.

Use it

In your app:

await chat.markAsRead('msg_3xR…');
 
chat.on('read', (event) => {
  console.log(`${event.userId} has read up to ${event.messageId}`);
});
 
const state = await chat.getReadState();
// { lastReadMessageId: 'msg_…', lastReadAt: '...', unreadCount: 3 }

const { receipts, markAsRead, readersOf } = useReadReceipts();
await markAsRead('msg_3xR…');
const readers = readersOf('msg_3xR…', messages); // everyone (but you) who's read this far or later

await livqeno.chat!.markAsRead('msg_3xR…');
const state = await livqeno.chat!.getReadState();

await chat.markAsRead(messageId);
 
chat.readReceipts.listen((state) {
  print('${state.userId} has read up to ${state.lastReadMessageId}');
});

Marking one message as read also marks everything before it. When a user scrolls to the bottom, make one call with the newest message.

When to call markAsRead:

• When the chat screen is open and visible, and a new message arrives.
• When the user scrolls down to the newest message.
• Not when the tab is in the background. The user hasn't actually seen it.

A position, not a log

Livqeno stores one marker per user per conversation: the newest message they've read. It doesn't store every single read.

• Opening a chat with 500 unread messages is one small update.
• The unread count is simply: messages after my marker, not sent by me.

The marker only moves forward

If two tabs are open at different scroll positions, the marker never moves back. An old tab can't "un-read" messages.

Delivery semantics: three different things

Why "delivered" isn't a per-recipient flag

A device receiving a message doesn't mean a person saw it. A background tab or a phone in a pocket receives everything. A "delivered ✓" per person would look strong but mean very little.

If you need something like "delivered", build it on read, which needs a real user action.

Everyone's position

To draw "Seen by" avatars, load everyone's marker once when the chat opens, then keep it updated with read events:

const receipts = await chat.getReadReceipts();
// [{ userId: 'bob', lastReadMessageId: 'msg_…', lastReadAt: '...' }, ...]

Returns at most 500 rows, even in very large channels.

Common errors

Next steps

• Messages
• Presence: another live signal, for comparison.