Docs/Inbox

Inbox

Every message from every channel — WhatsApp, Instagram, SMS, web widget — lands in one unified inbox. Moxabot's AI handles conversations automatically; your agents step in when it matters most.

💡
Tip:You can monitor the inbox in real time from any device. The mobile-responsive layout works in any modern browser — no app install required.

Inbox layout

The inbox is split into two panels. The left panel shows your conversation list — sorted by most recent activity — with channel icons, contact names, a message snippet, timestamp, and a status pill. The right panel is the full chat view for the selected conversation.

Moxabot
Inbox
Contacts
AI Persona
Knowledge
Integrations
Analytics
Team
Billing
Inbox
AllOpenEscalated
Sara M.
2m
What's the return policy?
Escalated
James K.
9m
Love the new collection!
Open
Priya R.
14m
Do you ship to Canada?
Waiting
Tom L.
1h
Order #4421 still pending
Resolved
S
Sara M.
WhatsApp
AI
Aanya · AI
Hi Sara! I'm Aanya from Moxa Store. How can I help you today?
Hi, I want to return a jacket I bought last week.
AI
Aanya · AI
Of course! Our return window is 30 days from delivery. I'll start a return for you — can you share your order number?
It's #8821.
M
Marcus · Agent
Hey Sara, this is Marcus taking over. I've found your order. I'll process the return right now — you'll have a label in your email within 5 minutes.
Reply to Sara… (type / for macros)

Every message bubble carries a badge so you can instantly tell who sent it:

BadgeMeaning
Rose bubble · "AI" labelReply generated and sent by your AI persona automatically
Dark bubble · agent nameReply sent manually by a human agent after taking over
Grey bubble (right-aligned)Message from the customer
Internal note (yellow background)Private comment visible only to your team — not sent to the customer

Channel icons appear as coloured dots in the conversation list and in the chat header:

ColourChannel
Green (#25D366)WhatsApp
Pink (#E1306C)Instagram / Messenger
Red (#F22F46)SMS via Twilio
Blue (#2563EB)SMS via EZ Texting
Rose (#E11D48)Web widget
Red (#FF0000)YouTube comments
app.moxabot.com
Full inbox view showing the left conversation list with channel dots and status pills, and the right chat panel with AI and agent message bubbles
Inbox — unified conversation list on the left, full chat panel with AI and agent badge messages on the right

Assign & reply

By default, your AI handles every incoming message. When you need a human touch — for complaints, refunds, or VIP customers — any agent can take over in one click and reply directly from the inbox.

Taking over from the AI

1
Open the conversation
Click any conversation in the left panel. The chat history loads instantly.
2
Click Take over
Hit the Take over button in the top-right of the chat panel. The AI immediately stops auto-replying to this conversation. A system note is added to the thread: "Marcus has taken over this conversation."
3
Type your reply
Use the reply bar at the bottom. Press Enter or click Send. Your name and "Agent" badge appear on every message you send.
4
Hand back to AI (optional)
Click Return to AI (same button position as Take over) when you're done. The AI resumes handling new messages from this customer.
ℹ️
Note:Taking over does not affect the AI's handling of other conversations — it only pauses AI replies for the specific conversation you've claimed.

Assigning to a team member

Admins and agents can assign any conversation to a specific team member. Assigned conversations appear at the top of that agent's inbox view, filtered under their name.

1
Open the conversation
Select the conversation in the left panel.
2
Click Assign
Hit the Assign button in the chat header. A dropdown lists all active team members.
3
Select an agent
Click the agent's name. They receive an in-app notification and the conversation moves to their queue. The assignee's name appears in the conversation list row.

Replying manually

The reply bar supports plain text, emoji, and file attachments (images, PDFs up to 10 MB). Press Shift + Enter for a line break without sending. Press Enter or click Send to deliver.

Internal notes

Switch the reply bar to Note mode (toggle above the input field) to leave an internal comment. Notes are highlighted in yellow and are never sent to the customer — they're visible only to your team in the conversation thread.

💡
Tip:Use notes to brief the next agent on context: "Customer is a VIP — waive return shipping fee" or "Third contact about this order, treat as priority."
app.moxabot.com
Chat panel showing the Take over button active, the reply bar in Note mode with a yellow background, and the Assign dropdown open
Chat panel controls — Take over, Assign dropdown, and Note vs Reply toggle

Quick replies & macros

Macros are saved reply templates your whole team can share. They eliminate repetitive typing for common responses — shipping updates, return instructions, pricing FAQs — and keep tone consistent across every agent.

Creating a macro

1
Go to Team → Macros
In the sidebar, click Team, then select the Macros tab.
2
Click New macro
Hit + New macro in the top-right.
3
Name and write the body
Give the macro a short name (this becomes the slash-command keyword) and write the reply body. Use {{contact.first_name}} and other variables to personalise automatically.
4
Save
Click Save macro. It's immediately available to all agents.
💡
Tip:Name macros with intent: return-instructions, shipping-delay,escalate-refund. Short, lowercase names are easiest to recall mid-conversation.

Inserting a macro with /slash

While typing in the reply bar, press / to open the macro picker. Continue typing the macro name to filter results. Click or press Enter to insert the full body into the reply field. You can edit it before sending.

text
/ return          →  filters to all macros containing "return"
/ shipping-delay  →  inserts the "shipping-delay" macro body
/ refund          →  inserts the refund acknowledgement template

Managing the macro library

Admins can edit, duplicate, or delete macros from Team → Macros. Agents can only use macros — they cannot create or modify them unless granted Admin role.

ActionWho can do it
Use a macro in a replyAll agents, admins
Create / edit / delete macrosAdmins only
Insert variables ({{contact.first_name}} etc.)All agents, admins
app.moxabot.com
Macro picker dropdown appearing above the reply bar after typing /, showing a list of saved macros with names and previews
The /slash macro picker — type to filter, click to insert

Contact timeline

Every contact has a unified timeline that aggregates their entire conversation history across all channels. Whether they messaged you on WhatsApp last month and then the web widget yesterday, you see it all in one place.

Viewing the contact panel

Click the contact's name or avatar in the chat header to open the Contact details panelon the right side of the screen. It shows:

  • Full name, email, phone number, and location
  • First seen date and total conversation count
  • All channels they've used
  • Complete message history across every channel — scrollable timeline
  • Custom attributes you've added (e.g. "VIP", "Shopify customer ID")
  • Internal notes attached to the contact (separate from conversation notes)

Adding notes to a contact

1
Open the contact panel
Click the contact's name in the chat header, or go to Contacts in the sidebar and search for them.
2
Click Add note
Scroll to the Notes section in the contact panel and click + Add note.
3
Write and save
Type your note and click Save. Notes are timestamped and attributed to the agent who wrote them. All team members can see contact notes.
ℹ️
Note:Contact notes are not the same as conversation notes. Contact notes stay on the person's profile permanently. Conversation notes are tied to a specific thread.
app.moxabot.com
Contact details panel showing profile information, channel history timeline, and the Add note section
Contact panel — full cross-channel timeline, custom attributes, and team notes

Status indicators

Every conversation carries a status that tells your team at a glance what needs attention. Statuses update automatically as the conversation progresses, or you can change them manually.

StatusColourMeaningHow it's set
OpenBlueActive conversation — AI or agent is handling itSet automatically when a new message arrives
WaitingAmberAwaiting a reply from the customerSet automatically after agent or AI sends a message
EscalatedRoseAI has triggered a hand-off rule or agent manually escalatedAutomatic (hand-off rule) or manual button
ResolvedGreenConversation is closed — no further action neededAgent clicks Resolve, or AI closes after idle period

To manually change a status, open the conversation and use the status dropdown in the top-right of the chat panel (next to the Assign button). Resolved conversations are hidden from the default inbox view but remain searchable and visible in the contact timeline.

⚠️
Warning:Resolving a conversation stops AI auto-replies for that thread. If the customer messages again after it's resolved, a new conversation is created automatically and the AI resumes.

Filters & search

Use the filter bar above the conversation list to narrow down what you see. All filters can be combined and are remembered per browser session.

FilterOptions
ChannelAll, WhatsApp, Instagram, SMS (Twilio), SMS (EZ Texting), Widget, YouTube
StatusAll, Open, Waiting, Escalated, Resolved
Assigned toAll, Unassigned, Any team member by name
Handled byAll, AI only, Human only
Date rangeToday, Last 7 days, Last 30 days, Custom range

Search

The search bar (top of the inbox) searches across contact names, phone numbers, email addresses, and message content. Search is full-text and returns results from all channels and all statuses — including resolved conversations.

💡
Tip:Search by order number (e.g. #4421) to instantly find every conversation where that order was mentioned, across every channel.
app.moxabot.com
Inbox filter bar showing channel dropdown set to WhatsApp, status set to Escalated, and a date range picker
Filter bar — combine channel, status, agent, and date filters to focus your queue

Next steps

Configure your AI Persona and hand-off rulesConnect channels — WhatsApp, Instagram, SMS, WidgetInvite agents and set rolesUnderstand your plan limits and billing