---
title: "Connect WhatsApp Business app to Kommo"
slug: "whatsapp-business-app-connect"
description: "Connect the WhatsApp Business app to Kommo to sync chats, import recent conversations, and manage messaging from one place while keeping app-based chats free."
updated: 2026-04-23T08:49:20Z
published: 2026-04-23T08:49:20Z
canonical: "support.kommo.com/whatsapp-business-app-connect"
---

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

# Connect WhatsApp Business app to Kommo

> [!NOTE]
> **What you’ll need:**
> 
> - A Kommo account (any plan or 14-day trial).
> - WhatsApp Business app (version 2.24.17 or newer).
> - A Facebook Business Portfolio (or create one during setup). [See Meta’s guide for instructions](https://www.facebook.com/business/help/1710077379203657?id=180505742745347).
> - A phone number with a supported country code.
> 
> **Keep in mind:**
> 
> - New WhatsApp Business app accounts are not immediately eligible for. This feature is designed for businesses already actively using the app and looking to scale with new tools. We recommend using the WhatsApp Business app for a while before onboarding, as eligibility depends on tenure and messaging quality.
> - Only chats that were active within the last 30 days will be imported. Each chat will include messages that are no older than 30 days.

To connect WhatsApp Business app to Kommo, follow these steps:

1. Go to **WhatsApp Business**. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-oen418e3.png)
2. Click **+Install. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-1otp7ae7.png)**
3. Click Link **WhatsApp Number →** Click **Next. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-gsy10vqu.png)**
4. Choose **WhatsApp Business app** and click **Continue with Facebook**. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-a9ci35vp.png)
5. Click **Continue with Facebook.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-r61sirlq.png)**
6. Log in with your **personal Facebook account** and click **Get Started**.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-d8rsn0yg.png)
7. Select an existing or create a new Facebook Business Portfolio. Select **Connect WhatsApp Business app**. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-akc6hhtw.png)
8. Enter your **phone number →** Click **Next. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-g7els2em.png)**

If you see an eligibility error during onboarding, it means your account doesn’t meet Meta’s active account criteria yet. Keep using the WhatsApp Business app actively for a while to become eligible or contact Meta support. [Kommo support](https://api.whatsapp.com/send/?phone=14159141403&text&type=phone_number&app_absent=0) can also reach out to Meta, but the eligibility is solely their decision.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-01v1k3ft.png)
9. Confirm your **WhatsApp Business account →** Click **Next.** Open **WhatsApp Business App**, then:
  - Receive a **QR Code message.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-1l3fgo4p.png)**
  - Tap **Scan QR Code** in the app.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-8ikhs4vd.png)
10. Choose whether to **share chat history** with **WhatsApp Business.** If you choose **Share chats** your chat history and contacts will be imported into Kommo and can be viewed there.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-mz27l5k1.png)
11. Scan the QR code and review the access request in Kommo, then **click Continue.**![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-kdacvdto.png)
12. Ensure **WhatsApp Business App** is successfully connected.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-84x4f7bp.png)
13. Click **Finish.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-zjsdbb4n.png)**
14. A data import message will appear in your WhatsApp Business widget. After about 10–15 minutes, once the import is complete, the message will disappear and your phone number status will update to **Connected**.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-t4qs7rb7.png)

## Connecting from WhatsApp Lite

1. Go to **WhatsApp Business**. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-eljnpfhb.png)
2. Click **+Install. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-g0qlfc1n.png)**
3. You’ll see the phone number previously used in your WhatsApp Lite. If multiple numbers are connected, select the one you want to migrate. Then click **Migrate**. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-b13y9l1g.png)
4. Click **Continue with Facebook**.**![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-m4c2j2wo.png)**
5. Log in with your **Facebook account** and click **Get started**.![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-v6jgx4aq.png)
6. Choose your existing **Business portfolio or create a new one**, then click **Next**. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-s9wvdjqt.png)

Continue with steps **4–12** from the WhatsApp Business App connection section. Once you're back in Kommo, the setup continues with one of two paths:

### If you don’t have templates to transfer

A final setup window appears. Click **Finish** to complete the process. **![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-945d72iy.png)** A data import message will appear in your WhatsApp Business widget. Once the import is complete, the message will disappear and the phone number status will change to **Connected**. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-is5lson1.png)

### If you have templates previously used in Kommo

You’ll see a window to select templates to submit to Meta for approval. Click the blue template counter to open the selection modal.

![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-bajs9e6l.png)

After selecting your templates, click **Confirm.**

![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-b0x8wed2.png) Click **Continue**.

![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-tfdl6381.png)

Wait for Meta to review your templates. Keep in mind:

- Templates keep their original content and structure.
- A *Wa* prefix is added to their names.
- Approval usually takes from a few minutes to several hours.
- Rejected templates must be edited or recreated to meet Meta’s guidelines.

To check the status, go to **WhatsApp Business > Connect > Templates**.

![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-q4tx5bea.png)

Approved merged templates will show the **Approved** status.

[Learn more about how templates work](/v1/docs/manage-whatsapp-business-message-templates).

### **What happens with chat import?**

- **If merging is NOT selected, but *Share chats* is selected (Step 10 above):** chat history and contacts from the WhatsApp Business app are imported into Kommo.
- **If** **merging is selected AND *Share chats* is also selected:** If you are using WhatsApp Lite, all existing chats and leads are already there, so Source merging takes priority over chat import. To prevent duplicate chats, Kommo does not initiate the import.

[Learn more about source merging and the transition from WhatsApp Lite to WhatsApp Business.](/v1/docs/connect-previously-used-numbers-to-whatsapp-business)

## Import contacts

> [!WARNING]
> Important: The import process can take up to 24 hours.

You can enable and disable contact importing for WhatsApp Business app. Currently, it is enabled by default. To find the enable/disable setting:

1. Go to **Integration marketplace> WhatsApp Business. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-0guflmhr.png)**
2. Click **Accounts. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-i46brocf.png)**
3. Click the settings symbol next to the number needed. ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-xjsxve6r.png)The profile will open, and the next steps will vary depending on whether you're a new WhatsApp Business app user or have previously used the app:

- New users can freely enable/disable contact syncing by clicking **Import contacts**: ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-hcyogck2.png)
- Existing users will need to reconnect their numbers to use this functionality. During this reconnection, leads may not arrive, and automations will be paused: ![](https://cdn.document360.io/56933ead-06fc-4574-95de-8fa458a5db1d/Images/Documentation/coex-waca-hub--spokes-image-bdcxok5a.png)

## Related

- [WhatsApp Business overview](/whatsapp-business-overview.md)
- [WhatsApp Marketing Messages API overview](/whatsapp-marketing-messages-api-overview.md)
- [Troubleshoot WhatsApp message errors](/troubleshoot-whatsapp-message-errors.md)
- [Connect WhatsApp Business to Kommo](/connect-whatsapp-business-to-kommo.md)