> ## Documentation Index
> Fetch the complete documentation index at: https://support.jomioz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbox

> Read and answer customer messages from WhatsApp, Facebook Messenger and Instagram in one place.

The **Inbox** is where messages from your customers arrive. WhatsApp, Facebook Messenger and Instagram all land here, as conversations. You read, reply, link the conversation to a customer, and turn it into a request if it is new work.

Google reviews are in the Inbox too, under **Reviews**. See [Connect Google Business](https://support.jomioz.com/integrations/google-business.md).

> [!NOTE]
>
> Coming soon: texts and calls from your own business number, in this Inbox. See [Phone and texting (coming soon)](https://support.jomioz.com/help/phone-coming-soon.md).

## Before you can use it

The Inbox is empty until you connect at least one channel:

* [Connect WhatsApp](https://support.jomioz.com/integrations/whatsapp.md)
* [Connect Facebook Messenger](https://support.jomioz.com/integrations/messenger.md)
* [Connect Instagram](https://support.jomioz.com/integrations/instagram.md)

Until then, the Inbox says **Connect messaging to use Inbox** with a **Set up messaging** button.

**Who can see it.** Anyone who can see reports, edit customers, or add and edit jobs. If you cannot see **Inbox** in the menu, ask the person who manages your team to change your role.

## Find your way around

**Inbox** is in the main menu, between **Schedule** and **Requests**. At the top you see **Inbox**, and a **Messages | Reviews** switch if Google Business is connected. **Messages** is the one on this page.

Next to it you see:

* **N unread**: how many messages are waiting.
* **AI receptionist**: opens the receptionist settings. See [AI receptionist for messages](https://support.jomioz.com/help/inbox-receptionist.md).
* **New message**: starts a WhatsApp message to a customer. It only appears when WhatsApp is connected and ready.

On a phone or a narrow screen, you see the list first. Open a conversation, and **Back to conversations** brings you back.

**Unread.** Every message from a customer adds 1 to that conversation's unread count, and so does a reaction. Opening the conversation marks it read. The number in the menu next to **Inbox** adds them up. It refreshes regularly.

**Live.** New messages appear on their own, without refreshing the page. If the live connection drops, the page keeps checking in the background.

## The conversation list

The list shows your **100 most recent conversations**, newest first. Each row shows:

* A picture or initials.
* The name: the customer's name if you have linked it, otherwise the sender's name, otherwise their phone number.
* A small **Facebook** or **Instagram** label for those channels. WhatsApp has no label.
* The start of the last message. Photos show as **📷 Photo**, videos as **🎬 Video**, voice as **🎵 Audio** and files as **📎 File**.
* The time: the clock time for today, the weekday for yesterday, then the day and month.
* A number badge when there are unread messages, and the name in bold.

**Search.** Type in **Search conversations**. It looks at the customer name, the sender name, the phone number and the last message.

**Channels.** The pills **All**, **WhatsApp**, **Facebook** and **Instagram** show only that channel. There is no unread filter.

If nothing matches, you see **No matching conversations** or **Nothing in this channel**.

> [!NOTE]
>
> Facebook and Instagram names and pictures come from Meta a little after the first message. Until then you may see an ID instead of a name.

## An open conversation

Click a row to open it. The top shows the name and, for WhatsApp, the phone number. On the right are:

* **Chat open** or **Waiting for reply**: whether the 24-hour window is open. See [The 24-hour window](#the-24-hour-window).
* **Open request**: when the conversation has a request. See [Requests from messages](#requests-from-messages).
* **Open customer** or **Link customer**. See [Link a customer](#link-a-customer).

Below it are the messages, oldest first, with day dividers (**Today**, **Yesterday**, then the date). You see the 200 latest. Your messages are colored by channel: green for WhatsApp, blue for Messenger, and a gradient for Instagram.

**Delivery words.** Every message of yours shows one:

| Word | Meaning |
| - | - |
| **Sending** / **Queued** | It is on its way. |
| **Sent** | It left Jomioz. |
| **Delivered** | It reached the customer's phone. |
| **Read** | The customer read it. |
| **Failed** | It did not arrive. See below. |
| **Received** | A message from the customer. |
| **Removed** | The customer deleted it. |

**If a message shows Failed**, there is no retry button. Fix the reason (see [WhatsApp: when a message fails](https://support.jomioz.com/integrations/whatsapp.md#when-a-message-fails)) and send the message again.

**Photos and files.** A photo shows inside the message. A file shows as a button with its name. Click it to open a viewer with **Save photo** or **Save file**.

**Reactions.** The small smiley on a message lets you react with 👍 ❤️ 😂 😮 😢 🙏. Click the same one again to remove it. A customer's reactions show as gray chips under the message. You can only react while the 24-hour window is open.

**Delete a message.** Click the bin on a message. It removes the message from **your Inbox only**: the customer still sees it, because a business cannot unsend a message from here. Choose **Delete** to remove it, or **Keep**. The text, the file and the reactions are cleared. The receptionist never reads a deleted message.

If a customer deletes or edits a message on their side, you see **Message removed** or the new text.

## Link a customer

A conversation is linked to a customer when:

* **WhatsApp:** Jomioz matches the sender's number to a phone number saved on a customer. This happens on every message, so a conversation links itself once the number matches.
* **Messenger and Instagram:** never automatically. Facebook and Instagram give a name, not a phone number.

To link one yourself, click **Link customer** at the top of the conversation, search in **Search customers**, and pick the customer. If a request exists for the conversation, it gets the customer too. After linking, the button changes to **Open customer**, which opens the customer's page.

Linking matters because the [AI receptionist](https://support.jomioz.com/help/inbox-receptionist.md) only books, moves or cancels visits for linked customers; anyone else gets answers and is handed to you. You cannot unlink a conversation once it is linked.

## Requests from messages

New work should not get lost in a chat. Jomioz opens a **request** under **Requests** when:

* The sender is **not a known customer**: always, on their first message.
* The sender is a **known customer** and the message looks like a **new request** (they want work, a price or a visit). "Thanks", "ok", an emoji or a message about a job that already exists does not open one.

A conversation only ever gets one request. The request has a short title written by AI, or a plain one such as **WhatsApp enquiry**, **Facebook enquiry** or **Instagram enquiry**. Its history says "Opened from a WhatsApp message". Use **Open request** at the top of the conversation to jump to it.

## Send a new WhatsApp message

**New message** starts a conversation. It is only for **WhatsApp**, and only when WhatsApp is connected and its templates are approved.

1. Click **New message**. The window is called **WhatsApp a customer**.
2. In **To**, search for a customer by name or phone, then pick one of the numbers saved on them. If they are not in your list, click **Create customer**. A mobile number is needed.
3. Write the message, up to 4,000 characters. **Rewrite with AI** tidies your words.
4. Send it. You see **WhatsApp sent.**

The window reminds you: "If they haven't written back yet, this still goes through. After they reply, you can chat freely and send photos." When the 24-hour window is closed, Jomioz sends your text inside a WhatsApp-approved template. See [Connect WhatsApp](https://support.jomioz.com/integrations/whatsapp.md#the-24-hour-window).

If it cannot be sent you see one of: **This customer has no mobile number for WhatsApp.**, **Connect WhatsApp before sending a message.**, a message that Meta is still reviewing the templates, or that your WhatsApp Business account cannot start conversations yet because of a payment method or business verification at Meta.

## Reply

Use the box at the bottom of an open conversation.

* Press **Enter** to send. **Shift + Enter** starts a new line.
* A message can be up to 4,000 characters.
* The round button sends. If it fails, you see **Could not send the reply** and the reason.
* The line under the box reminds you: "Enter to send · Shift+Enter for a new line · JPEG, PNG, or PDF".

**Attach a photo or PDF.** Click the paperclip, **Attach a photo or PDF**. JPEG and PNG up to 8 MB, PDF up to 25 MB. You can send a file with or without text. The text becomes the caption. **Remove attachment** takes it off before you send. The paperclip only shows while the 24-hour window is open.

### The 24-hour window

Messengers let you chat freely for 24 hours after the customer's last message. It restarts each time they write. The conversation says **Chat open** inside it and **Waiting for reply** outside it. What you can do is different by channel:

| Channel | Window closed |
| - | - |
| **WhatsApp** | Text still goes through, sent as an approved template with your text inside. No photos or files. If Meta is still reviewing the templates, you cannot start a new one until the customer messages you. |
| **Messenger and Instagram** | Text still goes through as a human follow-up. No photos or files. They have to message you first. |

The box tells you which one applies. More detail is on the channel pages.

### Generate with AI

The sparkle button next to the box drafts a reply for you.

1. Click it. Jomioz reads the last 8 messages and writes a short reply, using the customer's name.
2. The reply is written into the box a few words at a time. Nothing is sent.
3. Read it, change what you like, and send it yourself.
4. The sparkle changes into **Undo** and **Try again**. **Undo** puts back what was there before. **Try again** writes another one. **Cmd/Ctrl + Z** also undoes it. If you type in the box, your changes stay.

If the receptionist is set to **Assist** or **Live**, the draft also uses what the receptionist knows about your business and the customer's next visits. With the receptionist **Off**, it only uses the conversation. If it fails you see **Could not draft a reply**. Each draft uses your monthly AI allowance.

**Generate with AI** works on every plan. See [Jomioz AI](https://support.jomioz.com/help/ai.md).

### Suggested replies

If the [AI receptionist](https://support.jomioz.com/help/inbox-receptionist.md) is set to **Assist**, it prepares a reply when someone writes in. The box at the bottom is replaced by a card:

* **Ready to send**: "Nothing goes out until you press Send."
* The **Draft** is a text box. You can change it.
* If sending also books, moves or cancels a visit, or emails an invoice again, a line above **Send** says so, for example "Sending also books Tuesday, November 3, 9:00 AM – 10:00 AM." **Send** does that first, then sends the reply. If it can't (for example the time was just taken), nothing is sent and you see why.
* **Send** sends it. **Don't send** throws it away and changes nothing. You see **Reply sent** or **Reply discarded**.

You also get a **Reply ready to send** notification with the same two buttons and **View**. When a new message arrives, the old draft is replaced.

## Notifications

The office gets a notification for each message from a customer. The title is the person's name and the channel, for example "Dana · Messenger", and the text is the start of the message. It opens the conversation. If the message has no text it says "Sent a message with no text."

You also get **Reply ready to send** (Assist mode) and **Customer needs a person** (Live mode, and for emergencies in either mode), and **Message not delivered** when an estimate or invoice sent by WhatsApp bounces.

Two notifications warn you when messages might stop arriving: **WhatsApp disconnected**, **Messenger disconnected** or **Instagram disconnected** when Meta cuts a connection, and **WhatsApp message templates turned down** when Meta refuses a template. Each opens the page where you fix it.

## In the phone app (coming soon)

The Jomioz app for iPhone and Android is expected at the end of November. Until then, use [app.jomioz.com](https://app.jomioz.com) in your phone's browser.

The **Inbox** tab has the list, search, channel filter and conversations. Each row shows its unread count.

You can read, reply, **Generate with AI**, answer a suggested reply, link a customer, and delete a message by pressing and holding it.

The mobile app does not send photos or files (you can open the ones customers send), and it has no reactions, **New message** button, or receptionist settings. Use the web app for those.

## Limits

| | Limit |
| - | - |
| Conversations in the list | The 100 most recent. |
| Messages in a conversation | The 200 latest. |
| Length of a message | 4,000 characters. |
| Photos and files you send | JPEG or PNG up to 8 MB, PDF up to 25 MB, only inside the 24-hour window. |
| Photos and files you receive | Up to 25 MB each. |
| AI drafts | Up to 1,000 characters. |

## Troubleshooting

| Problem | Try this |
| - | - |
| The Inbox is empty. | Connect a channel first. See the links at the top of this page. If you had one connected, check **Settings → Integrations** for **Disconnected**. |
| You cannot see **Inbox** in the menu. | Ask the person who manages your team to change your role. |
| A new message has no name. | Messenger and Instagram names arrive a moment later. For WhatsApp, link the customer. |
| You cannot send a photo. | The 24-hour window is closed. |
| There is no **New message** button. | WhatsApp is not connected, or Meta has not approved the templates yet. |
| A message says **Failed**. | Read the reason on the [WhatsApp](https://support.jomioz.com/integrations/whatsapp.md#when-a-message-fails) page and send it again. |

See also: [AI receptionist for messages](https://support.jomioz.com/help/inbox-receptionist.md), [Connect WhatsApp](https://support.jomioz.com/integrations/whatsapp.md), [Connect Facebook Messenger](https://support.jomioz.com/integrations/messenger.md), [Connect Instagram](https://support.jomioz.com/integrations/instagram.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.