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

# WhatsApp Business App

> Connect your WhatsApp Business App number to bitbybit so WhatsApp Cloud API runs alongside your app while your chat history is preserved

Connecting the WhatsApp Business App lets the WhatsApp Business App and the Cloud API run at the same time on one number. You can move to an API-based solution without deactivating your current account, so your chat history is preserved.

For a step-by-step walkthrough, visit [our YouTube channel](https://www.youtube.com/@bitbybit.studio/videos).

<iframe width="560" height="315" src="https://www.youtube.com/embed/ihnNUrOFfYQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; fullscreen" allowfullscreen />

## Why connect this way

1. **Flexibility and cost-efficiency.** Use the app for personal, one-on-one chats while the API handles automation, agents, and high-volume broadcasts. This mix optimizes costs.
2. **No lost data.** Adopt the API without deactivating your account. Messages are mirrored and synced between both platforms, preserving conversation history, and contacts are imported automatically. You can also import up to 6 months of 1:1 chats and 2 weeks of multimedia history. Group chats are not imported.
3. **Scalability and professionalism.** Manage a high volume of messages through the API while keeping a single, professional number for a seamless customer experience.

## Before you start

1. A valid [Facebook Business](http://business.facebook.com/) account.
2. An active **WhatsApp Business App** phone number.
3. A completed [Meta verification](/integrations/whatsapp-cloud-api) process, covering both phone number verification and business verification.

## Step 1: Access Integrations

Navigate to the [Integrations](https://app.bitbybit.studio/integrations) dashboard and select **WhatsApp Business App**.

<img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01094709.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=9bf2abc5eb36f5f7c96c11b5eebfbd51" alt="Screenshot 2025-11-01 094709.png" width="668" height="686" data-path="images/Screenshot2025-11-01094709.png" />

## Step 2: Connect your Meta account

<img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01095444.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=01a2b58bd0bfe62359986796d609fe55" alt="Screenshot 2025-11-01 095444.png" width="708" height="424" data-path="images/Screenshot2025-11-01095444.png" />

## Step 3: Connect your Facebook account

<img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01100536.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=7912b3bd2c034ab9660429f6c11885a5" alt="Screenshot 2025-11-01 100536.png" width="584" height="706" data-path="images/Screenshot2025-11-01100536.png" />

## Step 4: Start connecting to bitbybit

<img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01100952.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=bd5098dc4fb3e06adeb8ba5d5ab72170" alt="Screenshot 2025-11-01 100952.png" width="500" height="597" data-path="images/Screenshot2025-11-01100952.png" />

## Step 5: Choose your Business Portfolio

Choose your Business Portfolio and fill in all the information.

<img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01101744.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=54412acc73264af92266022878d1eb81" alt="Screenshot 2025-11-01 101744.png" width="1286" height="766" data-path="images/Screenshot2025-11-01101744.png" />

<Note>
  If your business has multiple portfolios, choose the portfolio you want to integrate.
</Note>

## Step 6: Choose to connect with WhatsApp Business

<img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01112005.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=da9e326911fcaed0d2d3a36655397a63" alt="Screenshot 2025-11-01 112005.png" width="499" height="598" data-path="images/Screenshot2025-11-01112005.png" />

## Step 7: Insert your WhatsApp Business number

Enter the WhatsApp Business number you want to integrate with bitbybit.

<img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01112127-Copy.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=52fae5a1d12e2278a159345fc8ff9332" alt="Screenshot 2025-11-01 112127 - Copy.png" width="486" height="586" data-path="images/Screenshot2025-11-01112127-Copy.png" />

## Step 8: Scan the QR code

Scan the QR code from your **WhatsApp Business App**.

<img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01113512.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=1feab3cfe14c25dfa28507990a80611c" alt="Screenshot 2025-11-01 113512.png" width="1280" height="767" data-path="images/Screenshot2025-11-01113512.png" />

1. Look at your screen for the **"Share Contacts and Chats"** pop-up, which displays a QR code.
2. Go to your WhatsApp Business App and find the message from **Facebook Business**.
3. Open the message, click **"Connect"**, then confirm by clicking **"Connect to the Business Platform"**.

## Step 9: Set up your timezone

<img src="https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/images/Screenshot2025-11-01114914.png?fit=max&auto=format&n=WlT_6AuzhITpdgTf&q=85&s=6ecd4b8f6e01cf666b9df404975d1041" alt="Screenshot 2025-11-01 114914.png" width="632" height="766" data-path="images/Screenshot2025-11-01114914.png" />

## Step 10: Confirm the connection

<img src="https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/images/Screenshot2025-11-01115517.png?fit=max&auto=format&n=WlT_6AuzhITpdgTf&q=85&s=b0a1bd3be2f16c7f944401f56a6b5d33" alt="Screenshot 2025-11-01 115517.png" width="1301" height="767" data-path="images/Screenshot2025-11-01115517.png" />

To check that your WhatsApp account is connected to bitbybit, your WhatsApp Business App shows a confirmation screen. You can also find it in **Settings → Account → Connect to Business Platform**.

<img src="https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/images/Screenshot2025-11-01115927.png?fit=max&auto=format&n=WlT_6AuzhITpdgTf&q=85&s=b0b4773a61195824bd1037853cdfbb30" alt="Screenshot 2025-11-01 115927.png" width="378" height="728" data-path="images/Screenshot2025-11-01115927.png" />

<Note>
  As with the Cloud API, you still need to [add a payment method](/integrations/whatsapp-cloud-api#step-6-add-a-payment-method) to unlock all messaging features.
</Note>

## Feature comparison

The table below outlines the features available for each type of WhatsApp business setup: the standard **WhatsApp Business App**, the **WhatsApp Business App connected to Cloud API**, and the fully integrated **WhatsApp Cloud API**. It also highlights how certain features change once a business is onboarded to the Cloud API. Source: [Meta's onboarding documentation](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/).

| Existing feature on the WhatsApp Business App                                                           | Changes after onboarding to Cloud API                                                                        | Supported on Cloud API?                                                                                                                                                |
| :------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Individual (1:1) chats                                                                                  | Message Edit/Revoke is no longer supported.                                                                  | Supported. All chat messages in the most recent 6 months can be synchronized. Messages sent and received are mirrored between the Cloud API and WhatsApp Business App. |
| Contacts                                                                                                | No change.                                                                                                   | Supported. All contacts with a WhatsApp number can be synchronized.                                                                                                    |
| Group chats                                                                                             | No change.                                                                                                   | Not supported. Group chats will not be synchronized.                                                                                                                   |
| Disappearing messages                                                                                   | Disappearing messages will be turned off for all individual (1:1) chats.                                     | Not supported.                                                                                                                                                         |
| View once message                                                                                       | View once messages will be disabled for all individual (1:1) chats.                                          | Not supported.                                                                                                                                                         |
| Live location message                                                                                   | Live location messages will be disabled for all individual (1:1) chats.                                      | Not supported.                                                                                                                                                         |
| Broadcast lists                                                                                         | Broadcast lists will be disabled. You cannot create new Broadcast Lists, and existing ones become read-only. | Not supported.                                                                                                                                                         |
| Voice and video calls                                                                                   | No change.                                                                                                   | Not supported.                                                                                                                                                         |
| Business tools (for example catalog, orders, status)                                                    | No change.                                                                                                   | Not supported.                                                                                                                                                         |
| Messaging tools (for example marketing messages, greeting message, away message, quick replies, labels) | No change.                                                                                                   | Not supported.                                                                                                                                                         |
| Business profile (for example business name, address, website)                                          | No change.                                                                                                   | Not supported.                                                                                                                                                         |
| Channels                                                                                                | No change.                                                                                                   | Not supported.                                                                                                                                                         |

## Related

* [WhatsApp Cloud API](/integrations/whatsapp-cloud-api) — full automation, templates, and Campaigns at scale
* [WhatsApp Sandbox](/integrations/whatsapp-sandbox) — test features with your own number
