Inbox
The Inbox puts email, LinkedIn, WhatsApp, Instagram, Telegram and Messenger conversations in one list: read, reply, triage, share and match them to records.
What is the Inbox?
The Inbox is unified messaging on Customermates Cloud: email, LinkedIn, WhatsApp, Instagram, Telegram and Messenger conversations in one list, most recent activity first. Click a conversation to read it next to the list; on narrow screens the list and the conversation take turns. From a conversation you reply on its original channel, set its state, move an email to another folder, share it with your team and match its participants to records. Mate, or your own AI agent through MCP, can leave a reply as a draft in the conversation; you review, edit and send it (see drafts). You connect the accounts themselves on Channels & calendars, see App guide, Profile.
Who can use the Inbox, and why is it locked on Starter or missing in the self-hosted version?
All four conditions must hold:
- Customermates Cloud. Self-hosted installations have no Inbox: the sidebar entry is hidden and opening it leads to the Dashboard.
- A plan with messaging: Pro, Business, Max, Enterprise or a trial. On Starter the Inbox stays in the sidebar but shows Upgrade to unlock messaging, and Upgrade your plan opens Billing.
- A usable subscription: status Active or a trial that has not ended. While the status is Past Due or Cancelled, the Inbox is locked the same way.
- Your role: Inbox messages with Read access set to All. With None the sidebar entry is hidden and opening the Inbox leads to the Dashboard. The Admin role always has access.
While the plan or subscription locks the Inbox, the upgrade notice stays visible and background thread and unread-count refreshes stop. When access returns, reopening the Inbox loads the conversations again. Private conversations keep their visibility settings throughout.
Do I need a connected channel?
Not to open the Inbox: without a channel of your own you still see what teammates share. To send and receive on your own accounts you need one. An empty Inbox reads Nothing here yet; members with Create on Inbox messages get a Channels button below it (when Mate is available, starter prompts appear there instead). Add an email, LinkedIn, WhatsApp, Instagram, Telegram or Messenger account with Connect channel, see How do I connect a channel?. Channels per member: Pro 1, Business 3, Enterprise unlimited; a trial counts as Pro.
Which conversations do I see, and can an admin read my private ones?
The list combines the channels you connected, channels a teammate shared with the whole workspace, and single conversations a teammate shared from a private channel. A teammate's private conversations never appear, whatever your role, Admin included.
For email accounts, only folders switched on in the account's Folders tab on Channels & calendars appear. By default every folder is on except trash, junk or spam, drafts and the all-mail folder; if mail from an archive is missing, check its switch. A conversation without any message appears only while it holds a saved draft.
Which permissions does the Inbox need?
Roles are edited on Roles. The Inbox uses the Inbox messages row: Create, Edit, Delete, and Read access None or All.
| To do this | The role needs |
|---|---|
| See the Inbox and read conversations | Inbox messages: Read access All |
| Reply, save or send drafts, start a conversation from a contact | Inbox messages: Create |
| Discard a draft | Inbox messages: Delete |
| Change the state, move an email, Refresh, Resync thread, load older messages, share a conversation | Inbox messages: Edit |
| Match a participant's address to a record, or create a record from it | Read and edit access to that record; create access for a new record |
| Link a record to this one conversation | Inbox messages: Edit, plus read and edit access to the record |
| Add a Contact details field to a list | Data model |
Without Create the reply box is hidden. Without Edit the move action is hidden, the state is a read-only chip, and opening an unread conversation leaves it Unread. Sharing a single conversation also requires that you own its channel.
How do I search, filter or refresh the Inbox?
The top bar of the Inbox holds:
- Filter searches and filters: type text and choose the contains entry to find conversations by subject, message text, conversation name, and participant names or addresses (F opens it). It also offers State, Linked records, Participants (not fully linked finds conversations with someone who has no matching record you can read), Provider, Channel, Email folder, Draft (has some finds conversations with a saved draft), Last message (Sent or Received), Last message date and Last activity.
- Refresh pulls new messages right away (Inbox refreshed.) and reports channels that hit a rate limit, need reconnecting or could not be refreshed. Needs Edit.
- Channels opens Channels & calendars, with a number when channels need attention. Needs Create.
Email folder groups folders under their account, so folders with the same name stay apart; in finds conversations with a visible message in any selected folder, not in excludes them. Last message and Last message date use the latest real sent or received message; drafts, deleted messages and system events do not count. For mail from three to seven days ago, add two Last message date conditions: Older than… 3 days and 7 days. Last activity includes saved drafts. All filters respect account sharing and the enabled folders.
The views row starts with All conversations, followed by your saved views and the views teammates shared with you; click All conversations to leave a view. The list shows 25 conversations per page (5, 10, 25 or 100). The sidebar entry shows how many conversations you can see are Unread.
How do I open a specific conversation?
Click its row. The browser address then points to that conversation, so you can bookmark it or send it to a teammate who can see it; an address you cannot open brings you back to the Inbox. To find the conversations of one record, pick it in the Linked records filter: matching uses the record's contact details and still checks your access to each conversation. Mate does not open a single conversation for you: it opens the Inbox and names the conversation.
With Edit on Inbox messages, scrolling to the top of a conversation fetches older messages from the provider, once per conversation until you reload. Resync thread in the header fetches the whole conversation again.
What is in the conversation header?
Next to the conversation's name, left to right:
| Control | What it does |
|---|---|
| Move conversation to folder… (IMAP and Outlook) | Files the conversation in another folder; needs Edit |
| Resync thread | Fetches the conversation again; needs Edit |
| Private Thread or Shared Thread chip | Opens Thread settings |
| Some participants have no linked record you can read | Opens Thread settings; shown when you can create or edit records in a list with a Contact details field |
| State chip | Unread, Open, Closed or Spam |
On narrow screens the chips show icons only.
Incoming messages sit on the left, outgoing on the right. An email's compact header shows sender, time and first recipient; Details (also under Email actions) shows From, To, Cc and Bcc. Bcc is visible only on outgoing mail, to the account owner and teammates with access to the whole account; sharing a single conversation never reveals it. Click an address to copy it. A folder button below the recipients shows where that email is filed. Emails written in Customermates and plain-text emails use the app's colors and font and follow your light or dark theme. Received HTML that brings its own dark mode is shown in your theme; other received HTML keeps the sender's layout and colors on a light background. Remote images load only after Load remote images.
What do the thread states mean?
| State | Meaning |
|---|---|
| Unread | New, or a new message came in |
| Open | Read, still needs attention |
| Closed | Done |
| Spam | Marked as spam |
Opening an unread conversation sets it to Open (only with Edit). The state is shared by everyone who sees the conversation. A new incoming message sets it back to Unread, even from Closed or Spam. Spam is only a label: it does not hide the conversation, block the sender or report anything to the provider; use the State filter to keep it out of view. Setting a state never sends anything.
How do I move an email to another folder?
In IMAP and Outlook conversations, click an email's folder button and pick a destination under Move this email to… to move only that email, or use Move conversation to folder… in the header to file the whole conversation. Messages move in the real mailbox too. Sent and Drafts are never targets, and messages in them stay put. Gmail conversations, members without Edit and teammates who see a conversation shared from a private channel can read the folder names but get no move options; only the channel owner files those.
You can keep working while the move runs. Messages moved into a folder that is switched off on the account's Folders tab disappear from the conversation; when nothing visible remains, the confirmation says it no longer appears in your Inbox. If the provider rate-limits partway, a message says so and you can move the rest later.
How do I share a single conversation?
Click Private Thread or Shared Thread in the header to open Thread settings. The Share with team switch shares just this conversation with everyone whose role can read the Inbox (Shared to CRM); switching it off shows Conversation is now private. Only the channel owner can use it, on a plan with messaging and with Edit. Teammates can then read the conversation, change its state and resync it, but not move it, and only you can reply while the channel itself is private.
To share every conversation of a channel, switch on Visibility on the channel's Details tab on Channels & calendars (Business, Max or Enterprise). The per-conversation switch then stays on and locked.
How do I link participants and records?
Messages are matched to records through their contact details: a record whose Contact details field contains an email address, phone number or profile shows every conversation with that address. A phone number also matches WhatsApp chats from the same number. Open Thread settings. Under People, each participant shows the records you can see that match their address as chips. Link opens a search that adds the address to the contact details of a record in any list that has a Contact details field; the ✕ on a chip removes only that match. One address can belong to several records, for example a contact and an organization, and every other conversation with the same address follows. Ordinary text fields are never used for matching.
Under Conversation records, the field's picker (Link record) attaches only this conversation to a record, for example a deal in a list without a Contact details field; other conversations with the participant stay separate. Linking never grants access to private messages or restricted records.
How do I reply to a conversation?
Click Write a reply... (email) or Type a message... (chat) below the conversation. Email replies show Subject and To, filled from the conversation; Cc/Bcc adds those fields, and any combination works as long as there is one valid recipient. You write email in a Markdown editor, and your signature, if switched on, is added when sending. Bcc recipients are never carried into a reply. Chat replies are plain text. Use Attach files and Insert emoji as needed, then Send or Cmd/Ctrl+Enter; More send options holds Save as draft.
If sending fails, Retry appears only when trying again can help (rate limit, temporary outage). When the provider rejects a message, change it first; after a timeout, check the conversation, because the message may already have gone out. A channel that needs reconnecting is reported before anything is sent, and only its owner can reconnect it. Replies go out from the conversation's own channel, so you can answer only on channels you own or that are shared with the workspace.
How do I start a new conversation or write a new email to a contact?
The Inbox has no button for a new conversation. Open the person's record, for example in your contacts list, and click the New message icon next to an email address or handle in its contact details. When several of your channels can send, pick one under From; for LinkedIn with Sales Navigator or Recruiter, Send as chooses Classic, Sales Navigator InMail or Recruiter InMail. After Send the message goes out in the background (Sending message, then Message sent.). This needs Customermates Cloud and Create on Inbox messages.
How do drafts and attachments work?
Save as draft keeps a message without sending it; while you edit a saved draft it reads Update draft. A reply draft sits in its conversation with Send draft, Edit and Discard. A draft for a new conversation appears in the list as its own conversation ("Draft saved. Find it in the inbox."), also when you already have a draft to the same people; the Draft filter with has some lists them all. A conversation holds one draft. A new LinkedIn InMail cannot be saved as a draft. Discarding cannot be undone. The app, the REST API and MCP share the same drafts.
When drafts are waiting, Review drafts in the top bar shows how many and opens them one at a time: the recipient, the sending account, the latest messages of the conversation and the draft itself. Send sends the draft (swipe right or press the Right arrow key), Keep leaves it for later (swipe left or press the Left arrow key), Edit changes the text first (E), and Discard draft deletes it. The review lists the drafts you may send: those on your own channels and on channels shared with you. An Inbox link ending in ?review=drafts opens the review directly.
Each saved draft version is sent at most once. If the draft changed after you opened it, for example in another tab, by Mate or by an agent, Send keeps your text and offers Load latest version or Send mine. If sending could not be confirmed, the draft is not sent again: check the conversation first, for email also your Sent folder, then edit and update the draft to send it anyway. For email, as soon as the sent copy of that earlier send arrives from your mailbox, the draft counts as sent and leaves the inbox; it is then not sent again, not even after an edit.
For this, every sent draft leaves a send record: its ids, its state and hashes of the sent content, never the content itself. For email the hashes cover To, Cc, subject, text and attachment names, and for the exact send also Bcc and the attachment contents; for chat they cover the text and attachments. The record is deleted 30 days after its last change once its draft is gone. While the draft still exists, for example after a send that could not be confirmed, the record stays, so the draft cannot go out twice. Disconnecting the channel deletes its records.
Attach files adds up to 20 files per message, 15 MB together. Drafts cannot keep attachments ("Remove attachments before saving this draft."). In received messages supported media opens inline, other files download, and unsupported items show Unsupported.
How do I set an email signature?
The signature belongs to each email account you own: on Channels & calendars, open the Gmail, Outlook or IMAP account and use its Email tab. Set font, size and link style, switch on Add a signature, choose a layout with or without a logo and write the text in Markdown. While it is on, it is added below every email sent from that account, from the Inbox, the REST API or MCP, so do not paste it into the message; the composer previews it. All fields: Email appearance and signature.
For agents
Prefer MCP tools over clicking: get_messaging_threads reads conversations, update_messaging_thread sets the state (REST POST /api/v1/messaging/threads/{id}/state), move_email_thread files an email (REST POST /api/v1/messaging/threads/{id}/move; it fails for a conversation shared from someone else's private channel), send_email and send_chat_message start conversations, and save_message_draft (REST POST /api/v1/messaging/drafts) prepares one for review; send or discard a draft with its message id and current draftRevision. resolve_record_identifiers finds the records that match an address, manage_conversation_records reads and changes the records linked to one conversation, and mutate_crm_record changes a record's contact details.
Breaking change: sending saved drafts through the REST API changed. POST /api/v1/messaging/send-email answers 200, and POST /api/v1/messaging/threads/{id}/messages and POST /api/v1/messaging/start-chat answer 201, once the sent message is recorded, also when the call repeats an earlier send of the same draft revision; such a repeat carries repeated: true and sends nothing. They answer 202 with a receipt only while the sent message is not recorded yet. A stale draftRevision or changed recipients answer 409 with customCode draftChanged or draftRecipientsChanged instead of 404, and DELETE /api/v1/messaging/drafts/{id} with a stale draftRevision answers 409 with customCode draftChanged instead of 404. POST /api/v1/messaging/drafts, like save_message_draft with connectedAccountId, creates a new conversation on every call; update a saved draft through its conversation with POST /api/v1/messaging/threads/{id}/drafts or threadId.
Related
- App guide, Profile: connect the accounts that feed the Inbox.
- Rate limits: the per-provider budgets for reads and sends.