> ## 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 on the same number

Connect your WhatsApp Business App number to use the app and Cloud API together. Follow the setup below to keep the app active while adding bitbybit.

> [accordion] Watch the connection walkthrough
>
> [WhatsApp Business App connection walkthrough](https://www.youtube.com/embed/ihnNUrOFfYQ)

## 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. **Review history-sharing options.** Before connecting, check what history and contacts your selected setup offers to share, any consent it requires, and its limits. After setup, verify the data you need in bitChat. Do not assume every contact, message or attachment was 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. Complete the [business and phone-number checks](https://knowledge.bitbybit.studio/integrations/whatsapp-cloud-api.md) Meta requests for your account and chosen connection.

**1. Access Integrations**

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

![WhatsApp Business App card in Integrations](https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01094709.png?fit=max\&auto=format\&n=cHM4z2t-1XWdSut8\&q=85\&s=9bf2abc5eb36f5f7c96c11b5eebfbd51)

**2. Connect your Meta account**

Continue to Meta from the connection screen.

![Meta account connection screen](https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01095444.png?fit=max\&auto=format\&n=cHM4z2t-1XWdSut8\&q=85\&s=01a2b58bd0bfe62359986796d609fe55)

**3. Connect your Facebook account**

Sign in with the Facebook account that has access to your business.

![Facebook account connection screen](https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01100536.png?fit=max\&auto=format\&n=cHM4z2t-1XWdSut8\&q=85\&s=7912b3bd2c034ab9660429f6c11885a5)

**4. Start connecting to bitbybit**

Continue the connection flow in Meta.

![Start of the bitbybit connection flow](https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01100952.png?fit=max\&auto=format\&n=cHM4z2t-1XWdSut8\&q=85\&s=bd5098dc4fb3e06adeb8ba5d5ab72170)

**5. Choose your Business Portfolio**

Choose your Business Portfolio and fill in all the information.

![Business Portfolio selection and information fields](https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01101744.png?fit=max\&auto=format\&n=cHM4z2t-1XWdSut8\&q=85\&s=54412acc73264af92266022878d1eb81)

> [!NOTE]
>
> If your business has multiple portfolios, choose the portfolio you want to integrate.

**6. Choose to connect with WhatsApp Business**

Select the WhatsApp Business option.

![Option to connect with WhatsApp Business](https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01112005.png?fit=max\&auto=format\&n=cHM4z2t-1XWdSut8\&q=85\&s=da9e326911fcaed0d2d3a36655397a63)

**7. Insert your WhatsApp Business number**

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

![WhatsApp Business number entry](https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01112127-Copy.png?fit=max\&auto=format\&n=cHM4z2t-1XWdSut8\&q=85\&s=52fae5a1d12e2278a159345fc8ff9332)

**8. Scan the QR code**

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

![QR code for sharing contacts and chats](https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-11-01113512.png?fit=max\&auto=format\&n=cHM4z2t-1XWdSut8\&q=85\&s=1feab3cfe14c25dfa28507990a80611c)

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"**.

**9. Set up your timezone**

Choose the timezone for your business.

![Timezone selection during connection](https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/images/Screenshot2025-11-01114914.png?fit=max\&auto=format\&n=WlT_6AuzhITpdgTf\&q=85\&s=6ecd4b8f6e01cf666b9df404975d1041)

**10. Confirm the connection**

Complete the final connection confirmation.

![Connection confirmation in the setup flow](https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/images/Screenshot2025-11-01115517.png?fit=max\&auto=format\&n=WlT_6AuzhITpdgTf\&q=85\&s=b0a1bd3be2f16c7f944401f56a6b5d33)

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

![Connect to Business Platform confirmation in the WhatsApp Business App](https://mintcdn.com/asmaraku/WlT_6AuzhITpdgTf/images/Screenshot2025-11-01115927.png?fit=max\&auto=format\&n=WlT_6AuzhITpdgTf\&q=85\&s=b0b4773a61195824bd1037853cdfbb30)

> [!NOTE]
>
> As with the Cloud API, you still need to [add a payment method](https://knowledge.bitbybit.studio/integrations/whatsapp-cloud-api.md#step-6-add-a-payment-method) to unlock all messaging features.

## Feature comparison

Available history and contacts depend on the sharing options, consent, and limits shown during setup. Verify the data you need in bitChat after connecting. See [Meta's onboarding documentation](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/) for current platform behavior.

| Feature | What changes after connecting to Cloud API |
| :- | :- |
| 1:1 chats and contacts | Sharing depends on your setup and consent. Verify imported messages, attachments, and contacts in bitChat. |
| Group chats | Do not assume group history is imported or synchronized. |
| Temporary message features | Edit and revoke are unavailable. Disappearing messages, view-once messages, and live location are not supported. |
| Broadcast lists and calls | New broadcast lists are disabled, and existing lists become read-only. Voice and video calls are not supported through Cloud API. |
| Business and messaging tools | Catalogs, orders, status, greeting and away messages, quick replies, labels, profiles, and channels remain in the Business App but are not supported through Cloud API. |

## Related

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


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