Skip to main content
Track unread counts per channel and in aggregate, mark messages as read or delivered, and sync receipts in real time. This section covers the full set of unread and delivery status APIs.

​
Feature Overview

The Unread Status system tracks message read and delivery states in real time, with accurate unread indicators, delivery confirmations, and user activity tracking.

Channel-Level Tracking

Unread count management
  • Individual channel unread counts
  • Total unread aggregation
  • Mention status indicators
  • Real-time synchronization

Message-Level Status

Granular status tracking
  • Read receipt management
  • Delivery confirmations
  • User interaction tracking
  • Status synchronization

​
Core Components

Channel Unread Count

Track unread messages at channel levelMonitor unread message counts for individual channels and aggregate totals across your entire chat system.Key Features:
  • Real-time unread count updates
  • Total unread aggregation
  • Mention status tracking
  • Support detection

Message Receipt Sync

Real-time receipt synchronizationManage the infrastructure for real-time read and delivery receipt tracking within channels.Key Features:
  • Start/stop receipt sync
  • Lifecycle management
  • Resource optimization
  • Connection handling

Message Read Status

Individual message read trackingMark messages as read and track reading status for accurate unread count management.Key Features:
  • Mark messages as read
  • Automatic read detection
  • Latest message tracking
  • UI integration patterns

Message Delivery Status

Delivery confirmation and user trackingTrack message delivery confirmations and identify which users have read or received messages.Key Features:
  • Delivery confirmations
  • Read user tracking
  • Membership filtering
  • Analytics insights

​
Feature Integration Patterns

Display unread status in channel listsCreate compelling channel list interfaces that clearly communicate unread activity:
  • Unread Badges: Show exact counts with visual hierarchy for mentions
  • Visual Indicators: Use colors, typography, and spacing to indicate priority
  • Last Message Preview: Combine unread counts with message previews
  • Sorting Logic: Prioritize channels with unread messages and mentions
Effective chat list integration helps users quickly identify where their attention is needed.
Embed status tracking in message displaysIntegrate read and delivery status directly into message interfaces:
  • Read Receipts: Show checkmarks or indicators for read status
  • Delivery Confirmations: Display delivery status for sent messages
  • User Lists: Show which users have read or received messages
  • Real-time Updates: Update status indicators as they change
Message-level integration provides immediate feedback on communication effectiveness.
Leverage status data for insightsUse unread and delivery data for user engagement analytics:
  • Response Metrics: Track average response times and engagement rates
  • User Activity: Monitor reading patterns and message interaction
  • Channel Performance: Identify most and least active channels
  • Mention Analytics: Track mention frequency and response rates
Analytics integration provides valuable insights into communication patterns and user behavior.

​
Common Use Cases

Customer Support

Track customer response ratesMonitor message delivery and read status to ensure customer inquiries are being addressed promptly.

Team Collaboration

Coordinate team communicationUse mention tracking and read receipts to ensure important team messages reach all members.

Community Management

Moderate community engagementTrack unread counts and response patterns to identify active discussions and engagement levels.

Sales & Marketing

Measure campaign effectivenessMonitor message delivery and engagement rates for marketing communications and sales outreach.

​
Getting Started

1

Implement Channel Unread Count

Start with Channel Unread Count to display unread indicators in your chat list and navigation.
2

Set Up Receipt Sync

Configure Message Receipt Sync for real-time read and delivery tracking in active channels.
3

Add Read Status Tracking

Implement Message Read Status to mark messages as read and maintain accurate unread counts.
4

Enable Delivery Tracking

Add Message Delivery Status for comprehensive delivery confirmation and user analytics.
Implementation Strategy: Begin with basic unread count display, then progressively add receipt sync, read tracking, and delivery status. Focus on user experience and performance optimization as you build out comprehensive status tracking capabilities.