Skip to main content

Chat List

The left panel of the Chat page shows all your conversations across WhatsApp, Facebook Messenger, and Instagram DM. This is where you search, filter by channel, browse, and select chats to view.

At the top of the chat list you'll see:

  • Your profile avatar and name
  • Font size toggle — switch between small and large text
  • Notification settings — configure message notifications
📸
Screenshot: Chat list header showing profile, font size toggle, and notification icon
chat-list-header.png
1. Navigate to the Chat page
2. Capture the top header area of the chat list showing the avatar, name, font size button, and notification icon
Save to: static/img/screenshots/chat/chat-list/chat-list-header.png

Below the header is a search bar. Type to search conversations by:

  • Contact name
  • Email address
  • Mobile number or username

Results update as you type. Next to the search bar is a filter button (funnel icon) that opens the Filter Chats drawer.

📸
Screenshot: Search bar with filter button
search-bar.png
1. Capture the search bar area with the filter funnel button next to it
Save to: static/img/screenshots/chat/chat-list/search-bar.png

Channel Filter Bar​

Below the search bar, a horizontal channel filter bar lets you quickly filter conversations by messaging channel:

ButtonColor when selectedWhat it shows
AllBlueConversations from all channels
WhatsAppGreen (#25D366)Only WhatsApp conversations
MessengerBlue (#0084FF)Only Facebook Messenger conversations
InstagramPink (#E4405F)Only Instagram DM conversations

Click a channel button to filter. Click the same button again to deselect it and show all channels.

📸
Screenshot: Channel filter bar showing All, WhatsApp, Messenger, and Instagram buttons
channel-filter-bar.png
1. Navigate to the Chat page
2. Capture the channel filter buttons below the search bar
Save to: static/img/screenshots/chat/chat-list/channel-filter-bar.png
tip

The channel filter works alongside other filters. For example, you can filter by WhatsApp channel AND Need Reply message status to see only WhatsApp conversations waiting for a response.

Tabs​

Below the channel filter, conversations are organized into three tabs:

TabWhat it showsCount
ActiveConversations with recent activityNumber of active chats
NewNew or unread conversationsNumber of new chats
AllAll conversations regardless of statusTotal number of chats

Each tab shows a count badge with the number of conversations in that category.

📸
Screenshot: Three tabs — Active, New, All — with count badges
tabs.png
1. Capture the tab bar showing Active, New, and All tabs with their count badges
Save to: static/img/screenshots/chat/chat-list/tabs.png

Conversation Items​

Each conversation in the list shows several pieces of information at a glance:

📸
Screenshot: Conversation items from different channels showing channel badges, names, and statuses
conversation-item.png
1. Find conversations from different channels (WhatsApp, Messenger, Instagram)
2. Capture 2-3 conversation items showing different channel badges and states
Save to: static/img/screenshots/chat/chat-list/conversation-item.png

What each element means​

ElementLocationDescription
Avatar circleLeftShows the first letter of the contact's name
Channel badgeBottom-right of avatarColor-coded dot: Green = WhatsApp (active window), Red = WhatsApp (expired window), Blue = Facebook Messenger, Pink = Instagram
Contact nameTop-leftThe contact's name
Channel iconNext to nameMessenger or Instagram icon displayed inline next to the contact name (WhatsApp has no inline icon)
Contact identifierBelow nameSee Channel-specific identifiers below
Message status chipBelow identifierLast message status: Sent, Delivered, Read, Failed, or Replied
Unread badgeTop-rightBlue badge showing unread count (max "99+")
TimestampTop-rightWhen the last message was sent or received
Assigned agentBelow timestampAgent name, "AI-Assistant", or "Unassigned"
Lead statusBottom-rightColor-coded lead qualification status chip

Channel-Specific Identifiers​

The information shown below the contact name depends on the channel:

ChannelWhat's displayedExample
WhatsAppMobile phone number+919876543210
Facebook Messenger@username and page name (separated by ·)@john.doe · My Business Page
Instagram@username and page name (separated by ·)@john_doe · My Business Page

If a Messenger or Instagram contact doesn't have a username, the platform user ID is shown instead.

Message Status Chips​

The status chip on each conversation shows the delivery status of the last message:

StatusIconColorMeaning
SentSingle tickGrayMessage sent to the platform
DeliveredDouble tickBlueMessage delivered to the customer
ReadDouble tickBlue/GreenCustomer has read the message
FailedExclamation markRedMessage failed to send
RepliedArrowPurpleCustomer has replied

Selecting a Conversation​

Click any conversation to open it in the center panel. The selected conversation is highlighted with a light background.

Active Filter Chips​

When you have filters applied (from the Filter Chats drawer or the channel filter bar), colored chips appear below the search bar showing each active filter. Each chip has an X button to remove that specific filter, and a Clear All button to remove all filters at once.

📸
Screenshot: Active filter chips showing applied filters below the search bar
active-filter-chips.png
1. Apply 2-3 filters from the Filter drawer
2. Capture the filter chips area showing the colored chips with X buttons and Clear All
Save to: static/img/screenshots/chat/chat-list/active-filter-chips.png

Font Size​

Use the font size toggle in the header to switch between:

  • Small font (default) — compact view
  • Large font — increased readability

This setting applies to the entire Chat page — the chat list, conversation messages, and the contact info panel.

tip

The font size setting is remembered during your session. You don't need to set it every time you open a conversation.