> ## 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.

# Connect WhatsApp

> Connect your WhatsApp Business number, send estimates, invoices and reminders by WhatsApp, and chat with customers from the Inbox.

Connect WhatsApp to send estimates, invoices, reminders and "on my way" messages from your own business number, and to talk to customers in the [Inbox](https://support.jomioz.com/help/inbox.md).

Connecting WhatsApp does not depend on your plan. You need an active subscription or trial. You connect **one WhatsApp number** to one Jomioz account, and a number can only be connected to one Jomioz account at a time.

## Before you start

You need three things:

* A **Meta (Facebook) login** that can manage your business.
* A **WhatsApp Business account**. You can create it during the connect steps if you do not have one.
* A **phone number** to use for WhatsApp.

You also need permission to change company settings. If **Connect WhatsApp** is grayed out, ask someone who has it.

> [!NOTE]
>
> Jomioz connects your number through Meta's WhatsApp Business Platform, not through the WhatsApp phone app. Pick a number you are happy to use for business messages through Jomioz. If Meta refuses a number, use a different one.

## Connect your number

**1. Open WhatsApp**

Go to **Settings → Integrations → WhatsApp**. The section is called **Connect WhatsApp Business**.
If the page says **WhatsApp connection is not available yet**, WhatsApp is not switched on for your account. Contact support.

**2. Click Connect WhatsApp**

The page says: "Connect your WhatsApp Business account. You will be redirected to finish Meta verification, then return here."
Click **Connect WhatsApp**. You are sent to Meta.

**3. Finish the Meta steps**

Sign in with Facebook, choose or create your WhatsApp Business account, and choose the phone number. Follow Meta's screens until they send you back.

**4. Come back to Jomioz**

A page says **Finishing WhatsApp connection…**. Then you see **WhatsApp connected** and you land on the WhatsApp page.

**5. Wait for Meta to approve the templates**

As soon as you connect, Jomioz sends Meta the message templates it needs (see [Message templates](#message-templates)). Until Meta approves them, the page says **Templates in review** and sending stays off. Meta usually answers within minutes, but it can take longer.

If something goes wrong, you see one of these messages and nothing is connected:

| You see | What it means |
| - | - |
| WhatsApp signup was canceled or the Facebook login was denied. | You closed the Meta screens or did not allow access. Connect again. |
| WhatsApp did not return the connection details. Try connecting again. | The return from Meta was incomplete. Connect again. |
| WhatsApp connection failed. Try connecting again. | A general failure. Connect again. |
| This workspace already has a WhatsApp number. Disconnect it before connecting another. | You can only have one number. Disconnect the current one first. |
| That WhatsApp number is already connected to another workspace. | Another Jomioz account uses this number. Disconnect it there first, or use a different number. |
| That WhatsApp number is already connected to another account. Disconnect it there first. | The same, for a number tied to another account. |

## What the page shows

The status at the top of the page, and on **Settings → Integrations**, is one of these:

| Status | What it means |
| - | - |
| **Not available** | WhatsApp is not switched on for your account. Contact support. |
| **Not connected** | No number is connected. |
| **Connecting** | The number is connected and Jomioz is still setting it up. Check again in a moment. |
| **Templates in review** | The number is connected, but Meta has not approved the required templates yet. Sending stays off. |
| **Connected** | The number is connected and the required templates are approved. You can send. |
| **Templates turned down** | Meta refused one of the required templates. Waiting will not fix it. See [Message templates](#message-templates). |
| **Disconnected** | Meta cut the connection. Customer messages have stopped and sending is off. Connect again. |
| **Needs attention** | Meta reports a problem with the number. The panel says what. |

Once a number is connected, the page also shows:

* **Connected number**: the number you connected.
* **WhatsApp Business account**: the ID of your account at Meta.
* **Needs attention**: a warning from Meta, in red, when there is one.
* **Status detail** and **Last checked**.

**Refresh status** asks Meta again. It sends any templates that are missing, brings in Meta's latest answers, and checks the account's health. Use it after you fix something in Meta. Jomioz also updates this page by itself when Meta sends a template answer or a warning.

The **Settings → Communications** page only lists the status of each channel and links back here. You connect and disconnect on the Integrations page.

## Message templates

WhatsApp has a strict rule. A business can only start a conversation, or write after 24 hours of silence, with a **message template** that Meta has approved. Jomioz sends Meta the templates for you.

You do not write them. They are short and plain, and they come in English, Spanish and French. Meta reviews each one. This usually takes minutes, but it can take longer.

| Template | What it is for |
| - | - |
| Estimate to review | Sending an estimate, and estimate follow-ups. |
| Invoice to pay | Sending an invoice, resending it, and reminders. |
| Tech on the way | The **On my way** message. |
| Visit update | A visit scheduled, changed or canceled, and appointment reminders and proposals. |
| Customer hub | The sign-in link to your customer's Client Hub. |
| Save card | Asking a customer to save a payment method. |
| Agreement to sign | Sending a service agreement. |
| Customer notice | Everything else, and Inbox messages you send after the 24 hours are over. |

Things to know:

* **Only three must be approved** before the page says **Connected**: the estimate, invoice and "on the way" templates. The others can still be in review.
* **Each message goes out in the customer's language.** It uses the language on the customer, or your default under **Settings → Customer language** (see [Customers and messaging](https://support.jomioz.com/settings/messaging.md)). English is used when nothing is set. Only English, Spanish and French are available.
* **Meta can change a template's type.** If Meta decides a template is a marketing message, Jomioz stops using it for the everyday messages above.
* **A template that is not approved is not used.** While Meta is still looking at it, the page shows **Templates in review**. If it stays in review for a long time, click **Refresh status** and check the account in Meta Business Suite.
* **If Meta turns a template down**, the page shows **Templates turned down** in amber and a red message such as: "Meta turned down the estimate message template, so sending stays off. Waiting will not fix this. Contact support and we will fix it." The office also gets a notification, **WhatsApp message templates turned down**, once. Contact support, because the wording of the templates is set by Jomioz.
* If the matching template is not approved, Jomioz tries the general **Customer notice** template. If that is not approved either, it tries a plain message, which Meta only allows for some numbers. If none works, the send fails with: "Your WhatsApp number is connected. Meta is still reviewing the message templates, so a new message stays off until they are approved."

## The 24-hour window

WhatsApp gives you a **24-hour window** to chat freely with a customer. It opens when the customer sends you a message, and it restarts every time they message you again. Your own messages do not restart it.

| | Window open | Window closed |
| - | - | - |
| Thread label in the Inbox | **Chat open** | **Waiting for reply** |
| Write a text message | Yes, as normal. | Yes. It goes out as the approved **Customer notice** template with your text inside. |
| Send a photo or PDF | Yes. | **No.** The customer has to reply first. |
| React with an emoji | Yes. | No. |

When the window is closed, the box says: "They need to reply before you can chat freely or send photos. This message still goes through." After they reply, the window opens again.

Estimates, invoices and reminders always use their own template, even when the window is open.

## What Jomioz sends by WhatsApp

For most of these you choose WhatsApp, email, or both. WhatsApp only works once your number is connected and Meta has approved the templates.

* **Estimates and invoices** when you send them, and invoice reminders.
* **Service agreements** for signing.
* **Visit messages**: a job scheduled, changed or canceled, and appointment proposals.
* **On my way**.
* **Visit reminders**, set up under [Jobs](https://support.jomioz.com/settings/jobs.md) and [Service plans](https://support.jomioz.com/settings/service-plans.md).
* **Review requests** and other [automations](https://support.jomioz.com/settings/automations.md).
* **Client Hub** sign-in links and requests to save a card.

Connecting WhatsApp does not switch any of these on. It only makes WhatsApp available to them.

**Who does not get a message:**

* A customer whose phone number is marked as blocked.
* A customer who has notifications turned off. Some automations let you choose to send anyway.
* A customer with no mobile number saved.

If you send an estimate **by WhatsApp only** and WhatsApp cannot be used, Jomioz stops before sending and tells you why, so you can share the estimate link instead. If you choose **Email and WhatsApp**, the email goes and a WhatsApp problem shows as a warning.

> [!NOTE]
>
> Jomioz does not process "STOP" replies for you. A customer is treated as agreeing to messages unless notifications are turned off for them. Make sure you have your customers' permission to message them, and turn notifications off for anyone who asks you to stop.

## When customers reply

Every message a customer sends to your WhatsApp number arrives in the [Inbox](https://support.jomioz.com/help/inbox.md) as a conversation, whether or not Jomioz can match it to a customer. You also get a notification.

* **Known customer.** Jomioz matches the sender's number to the mobile and phone numbers saved on your customers. If it matches, the conversation shows the customer's name.
* **Unknown number.** The conversation still appears, titled with the phone number. Use **Link customer** to attach it to a customer. A message from an unknown number also opens a **request** under **Requests**, so it is not lost.
* **Photos and files** the customer sends are saved in Jomioz.
* **Edits and deletes.** If a customer edits a message, the text updates. If they delete it, the bubble says **Message removed**.

## When a message fails

WhatsApp can accept a message first and refuse it later. When that happens, the message shows **Failed** in the thread and you get a **Message not delivered** notification when it was an estimate or an invoice. The reason is written in plain words:

| Reason shown | What to do |
| - | - |
| "…your WhatsApp Business account cannot start conversations yet. Fix the payment method and finish business verification in Meta, then try again." | Open Meta Business Suite. Add a payment method and finish business verification. Meanwhile share the link or send by email. After a block, Jomioz waits 15 minutes before it tries one message again. |
| "…the customer has not replied in the last 24 hours, so only an approved template can be sent." | The window is closed. Wait for them to reply, or use a template message. |
| "…the number is not on WhatsApp or cannot receive it. Check the customer's mobile number." | Fix the number on the customer, or use email. |

Jomioz does not resend a failed message automatically. Send it again once the cause is fixed. A failed estimate or invoice stays marked as sent. Only the delivery failed.

If you send a message from the Inbox and it is refused straight away, you see a short message instead:

| You see | What to do |
| - | - |
| Your WhatsApp connection has expired. Reconnect it in Settings → Integrations, then send again. | Reconnect on **Settings → Integrations → WhatsApp**, then send again. |
| WhatsApp does not allow this message right now. | The window is closed or Meta refused it. Wait for the customer to reply. |
| WhatsApp is limiting how fast you can send. Wait a moment and try again. | Wait a minute. |
| WhatsApp is temporarily unavailable. Try again in a minute. | Try again shortly. |

## Warnings about your number

Meta can warn you about your number. Jomioz shows the warning under **Needs attention** on the WhatsApp page, and sends the office a **WhatsApp number needs attention** notification when it is urgent:

* Meta raised a critical alert.
* Meta lowered your daily sending limit.
* Meta rated your number's quality as red or medium.

These are decisions by Meta. Open **Meta Business Suite** to see why. When Meta clears the warning, it disappears from Jomioz too.

## Disconnect and reconnect

**To disconnect**, open **Settings → Integrations → WhatsApp** and click **Disconnect**. Jomioz asks: "Disconnect WhatsApp from this workspace? Outbound messages will stop until you connect again."

What happens:

* Jomioz stops sending WhatsApp messages. Estimates, invoices and reminders go by email instead where you chose that.
* Your old conversations and messages stay in the Inbox.
* New customer messages to that number no longer arrive in Jomioz.
* Your WhatsApp Business account at Meta is not deleted.

**To reconnect**, click **Connect WhatsApp** again. Jomioz checks your templates again and does not resend approved ones.

**If Meta cuts the connection** (for example someone removed Jomioz's access in Meta), Jomioz tells you in three places so you do not have to find out from a quiet Inbox:

* The office gets a **WhatsApp disconnected** notification: "Meta cut the WhatsApp connection, so customer messages have stopped. Connect it again under Settings → Integrations."
* The WhatsApp card and page show **Disconnected** in amber.
* The page shows a red message: "Meta cut your WhatsApp connection, so customer messages have stopped and sending is off. Connect again to fix it."

Click **Connect WhatsApp** to fix it. Connecting again, or choosing **Disconnect** yourself, clears the message.

## Limits

| | Limit |
| - | - |
| Length of a message | 4,000 characters. |
| Photos | JPEG or PNG, up to 8 MB. |
| Files | PDF, up to 25 MB. |
| Photos and files | Only while the 24-hour window is open. |
| Photos and files a customer sends you | Up to 25 MB each. |
| Reactions | One emoji: 👍 ❤️ 😂 😮 😢 🙏. |
| Inbox list | The 100 most recent conversations, and the 200 latest messages in a thread. |

## Cost

* **Jomioz.** The app shows no per-message fee and no limit on the number of WhatsApp messages. Connecting is not tied to a plan.
* **Meta.** Meta may charge your own WhatsApp Business account for some conversations, depending on Meta's current prices for your country. Keep a payment method set up in Meta Business Suite. If it is missing or declined, Meta refuses to start conversations, and you see the "cannot start conversations yet" message above. Check Meta's pricing page for the details.
* **AI.** The AI draft button needs the Pro plan. The [AI receptionist](https://support.jomioz.com/help/inbox-receptionist.md) and the draft button both use your monthly AI allowance, which you can see under **Settings → Plan & billing**.

## Troubleshooting

| Problem | Try this |
| - | - |
| The **Connect WhatsApp** button is grayed out. | You need permission to change company settings. Ask someone who has it. |
| The page says **Templates in review** for a long time. | Click **Refresh status**. Open Meta Business Suite and check that the account is verified and has a payment method. |
| The page says **Templates turned down**. | Meta refused a template. Contact support. Waiting will not fix it. |
| The page says **Disconnected**. | Meta cut the connection. Click **Connect WhatsApp** again. |
| Estimates or invoices do not send by WhatsApp. | The page must say **Connected**. Check that the customer has a mobile number and has not turned notifications off. |
| A customer's replies do not show in the Inbox. | Check that the page is **Connected**. If it says **Disconnected** or **Not connected**, connect again. If it says **Needs attention**, read the message. |
| A new message cannot be sent to a customer. | Check that you are connected and the templates are approved. The customer's mobile number must be saved. |
| You see **Needs attention** with a quality warning. | Open Meta Business Suite and read Meta's explanation. |

See also: [Inbox](https://support.jomioz.com/help/inbox.md), [AI receptionist for messages](https://support.jomioz.com/help/inbox-receptionist.md), [Customers and messaging](https://support.jomioz.com/settings/messaging.md).


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