Skip to main content

Inbox Overview

What it is

The Inbox is BotBat's unified messaging hub where agents view, manage, and respond to all customer conversations across every connected channel. WhatsApp, SMS, email, and webchat messages all flow into a single interface, giving agents a complete picture of customer communications without switching between tools or platforms.

Each conversation is displayed as a threaded message history with timestamps, delivery status indicators, and media attachments. The left panel shows the conversation list with preview text, channel icons, and unread badges, while the main panel displays the full message thread for the selected conversation. A right-side panel provides contact profile details, tags, custom attributes, and a history of all past interactions with that contact across every channel.

The Inbox is designed for both individual agents handling their own queue and team leads monitoring overall inbox health. Role-based permissions control who can view, respond to, assign, and resolve conversations, ensuring that sensitive customer data is accessible only to authorized team members.

Key components of the Inbox

The Inbox interface is divided into three main areas that work together to give agents everything they need in one view.

ComponentLocationPurpose
Conversation listLeft panelBrowse all conversations with previews, channel icons, timestamps, and unread counts
Message threadCenter panelView full conversation history, send replies, add notes, and attach media
Contact sidebarRight panelView contact profile, attributes, tags, segments, and cross-channel history
Filter barTop of conversation listFilter by status, channel, assigned agent, tags, or date range
Quick actionsTop of message threadAssign, snooze, resolve, or tag the current conversation
Inbox list view, inbox open with 3+ conversations visible in the left panel

The conversation list updates in real time. New messages push conversations to the top of the list, unread counts increment automatically, and typing indicators appear when a contact is composing a message. This live behavior means agents never need to manually refresh the page to see new activity.

When to use

Responding to incoming customer messages. The Inbox is the primary workspace for agents handling inbound conversations. Every message from every connected channel arrives here, organized by conversation thread. Agents can read the full history, understand context from the contact sidebar, and compose a reply, all without leaving the Inbox. The threaded view ensures that agents see the complete conversation, not just the latest message.

Assigning conversations to agents or teams. When a new conversation arrives, it can be manually assigned to a specific agent or team, or automatically routed based on rules configured in Settings. The assignment dropdown at the top of each conversation thread shows all available agents and teams, along with their current workload. Assigning conversations ensures accountability and prevents multiple agents from responding to the same customer simultaneously.

Agent assignment dropdown, assignment dropdown open showing available agents

Reviewing conversation history for a specific contact. Before responding to a customer, agents often need context from previous interactions. The contact sidebar shows every conversation that contact has had across all channels, along with their profile data, tags, and segment memberships. This cross-channel history is essential for providing personalized, context-aware support without asking the customer to repeat information.

Filtering and prioritizing conversations. During high-volume periods, agents need to focus on the most important conversations first. The filter bar supports filtering by conversation status (open, pending, snoozed, resolved), channel, assigned agent, tags, and date range. Combining multiple filters helps agents find specific conversations quickly and manage their queue efficiently.

Monitoring team inbox health. Team leads and managers use the Inbox to monitor overall conversation volume, identify unassigned conversations, and ensure response time targets are met. The status tabs at the top of the conversation list show counts for open, pending, snoozed, and resolved conversations, providing an at-a-glance view of inbox health.

Opening a conversation

Click "Inbox" in the main navigation sidebar to open the Inbox. The conversation list loads with your most recent conversations displayed first. Click any conversation row to open its message thread in the center panel. The selected conversation is highlighted in the list, and the contact sidebar populates with that contact's profile data.

Conversation thread, single conversation selected with messages visible in the center panel

Replying to messages

Type your response in the message input area at the bottom of the center panel. Press Enter or click the Send button to dispatch your message. For WhatsApp and webchat channels, the contact sees a typing indicator while you compose. For SMS and email, the message is sent without a typing preview.

The message input supports rich text formatting for email (bold, italic, links, lists), plain text for SMS, and WhatsApp-compatible markdown (asterisks for bold, underscores for italic). Media attachments such as images, documents, and videos can be added using the attachment icon next to the input area. File size limits and supported formats vary by channel.

Resolving conversations

Click the "Resolve" button at the top of the conversation thread to close the conversation once the customer's issue is handled. Resolved conversations move to the Resolved tab and are excluded from agent workload counts. If the customer sends a new message after resolution, the conversation automatically reopens and returns to the Open tab.

Inbox channels and their capabilities

Different channels provide different capabilities within the Inbox. The table below summarizes what is available on each channel.

CapabilityWhatsAppSMSEmailWebchat
Typing indicatorsYesNoNoYes
Read receiptsYes (if enabled by recipient)NoNo (open tracking separate)Yes
Rich media (images, docs)YesMMS onlyYes (attachments)Yes
Message formattingWhatsApp markdownPlain text onlyFull HTMLRich text
Reply time window24-hour session windowNo limitNo limitSession-based

Understanding these differences helps agents format their messages correctly and set appropriate expectations for customer interactions on each channel.

Common pitfalls

  • Unassigned conversations go unnoticed. New conversations default to unassigned unless auto-routing rules are configured. Without routing rules, messages can sit in the queue for hours without anyone seeing them. Set up auto-assignment rules in Settings > Conversation Routing to prevent this, especially as your team grows beyond two or three agents.
  • Channel-specific formatting surprises. WhatsApp supports bold and italic via markdown syntax, but SMS does not support any formatting. If you copy a formatted message from one channel to another, the formatting characters may appear as literal text. Always preview your message and consider the target channel's capabilities.
  • Notification delays or missing notifications. If you are not receiving browser or push notifications for new messages, check your browser's notification permissions for the BotBat domain. Also verify your notification preferences in Settings > Notifications. Agents with their availability status set to Offline will not receive notification alerts.
  • 24-hour WhatsApp session window. WhatsApp enforces a 24-hour messaging window from the customer's last message. If you try to reply after the window expires, you must use an approved template message to re-initiate the conversation. Plan your response times accordingly.
  • Duplicate responses from multiple agents. Without conversation assignment, two agents may respond to the same customer simultaneously. Use assignment (manual or automatic) to ensure each conversation has a single responsible agent at any given time.
tip

Configure auto-routing rules early. Even a simple round-robin assignment across your team prevents conversations from being missed and ensures a more even workload distribution. You can always add more sophisticated routing logic later as your team and volume grow.

  • Inbox Overview
  • Conversation List
  • Message Thread
  • Conversation Assignment
  • Conversation Filters
  • Channel Capabilities