Skip to main content
Key Benefit: Monitor message delivery status and user engagement with comprehensive tracking for delivery confirmations, read receipts, and user-level status management to ensure reliable communication.

​
Feature Overview

Message Delivery Status provides essential tools for tracking message delivery confirmation and user engagement within chat applications. This system enables you to monitor when messages are delivered, track which users have read messages, and manage delivery status for reliable communication workflows.

Delivery Tracking

Message delivery management
  • Mark messages as delivered
  • Track delivery confirmation
  • Monitor delivery status
  • Handle delivery failures

User Engagement

Read and delivery insights
  • Get message read users
  • Get message delivered users
  • Filter by membership status
  • Real-time engagement tracking
Performance Consideration: User list queries can be resource-intensive for messages with many recipients. Implement pagination and filtering to optimize performance in large channels.

​
Implementation Guide

  • Mark Message as Delivered
  • Get Message Read Users
  • Get Message Delivered Users
Update message delivery status when messages reach recipientsMark individual messages as delivered to track successful message delivery and provide delivery confirmation feedback to senders.

​
Core Operation

MethodPurposeWhen to Use
markAsDeliveredMark a message as deliveredWhen message reaches recipient device

​
Code Examples

Task {
     try await message.markAsDelivered()
}
Silent Operation: Message delivery marking typically happens silently in the background. Avoid showing intrusive error messages to users unless absolutely necessary.

​
Best Practices

Optimize delivery status operations
  • Mark messages as delivered immediately when they reach the device
  • Use batch operations for multiple messages to reduce API calls
  • Implement proper error handling for delivery marking failures
Efficient status management ensures accurate tracking without performance impact.
Respect user privacy in delivery tracking
  • Use membership filtering to show only relevant users in delivery lists
  • Respect user privacy settings for read receipt visibility
  • Implement appropriate access controls for delivery information
  • Consider user consent for delivery tracking features
Privacy-conscious implementation builds user trust and ensures compliance.
Build for scale and performance
  • Implement pagination for large user lists to avoid memory issues
  • Use lazy loading strategies for delivery data that’s not immediately visible
  • Consider implementing virtual scrolling for very large user lists
  • Monitor performance metrics and optimize based on usage patterns
Scalable implementation ensures consistent performance as your application grows.

Message Receipt Sync

Sync Infrastructure Real-time receipt synchronization for accurate status tracking

Message Read Status

Read Management Individual message read state tracking and analytics

Channel Unread Count

Unread Tracking Channel-level unread message counting and management
Implementation Strategy: Start with basic delivery marking, then add read/delivered user tracking with proper filtering. Focus on performance optimization for channels with many participants, and implement comprehensive analytics for delivery insights.