> ## 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 Cloud API

> Connect WhatsApp Cloud API to bitbybit, from Meta Business verification and phone setup to adding a payment method and profile picture

WhatsApp Cloud API unlocks full automation, message templates, and broadcast Campaigns at scale. This guide covers the whole connection, from verifying your Meta Business Manager to adding a payment method and setting your profile picture.

Check the requirements below before you start so the process runs smoothly.

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/9mkCIy6MzLg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; fullscreen" allowfullscreen />

## Requirements before you start

* **Verified Meta Business Manager.** Your business must be verified by Meta with legal documents.
* **Admin access to Meta Business Manager.** You must have full control access in your Business Manager account.
* **A clean, unused phone number:**
  * Not currently used on any WhatsApp account, personal or business.
  * Able to receive SMS or phone calls for verification.
* **Business details ready:** business name, address, website or social media page, and email, plus legal documents (NPWP, SIUP, or equivalent).

<Warning>
  If your number is already active on WhatsApp, you must delete that WhatsApp account first. Follow [steps 3–5 of this process](https://developers.facebook.com/docs/whatsapp/on-premises/get-started/migrate-existing-whatsapp-number-to-a-business-account).
</Warning>

<Tip>
  Use a **new phone number** that has never been used on WhatsApp to ensure a smooth process.
</Tip>

## Create a Meta Business Manager

Skip this section if you already have a Meta Business Manager account.

1. Go to [business.facebook.com](http://business.facebook.com) and create a new Business Account.
2. Complete your business information and verify your email address.

<Warning>
  Make sure your Facebook account has **Full Control (Admin Access)** in **Business Settings → People**. This is required to continue the integration process.
</Warning>

### Verify your Business Manager

1. In **Business Settings**, go to **Security Center → Business Verification**.
2. Submit your legal business documents, such as NPWP, SIUP, or other equivalent documents as required.

<Warning>
  Business verification is mandatory to unlock full WhatsApp Cloud API access and use it for real customer messaging.
</Warning>

## Step 1: Access Integrations

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

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08dd4_66ea7da570f8e3beace6f779_AD_4nXcwSOk5VSCE80F6VLfH8itQy8V5rvaIB2K18hZHvpR4oa6X0LW0J9slI6EQ_fXJpM8t8fbMIu0amqx3DZX_YGTi-xIb_Kz8C5PwtavVBs_e8osflehX3c5u0MNJ7EZrpDkPzysP-kmYMqhXH-Swn1g8CV3i.png)

## Step 2: Connect your Facebook account

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/677cf076c370844afa6ee140_AD_4nXfWE9QU6xkpCBLjCvp-Q2MKs9WSm7cSUR1Z7_QuaWhWQsS-VD8I79S66LZldHfy-GzBikWqG8wBo9xxAYdToIgcz_5qvVoVfwm8JQ-d0Nw7G5GqPNdQUomVIE1x61hEgPft8rWtoQ.png)

1. Click **"Continue as your Facebook Account"**.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08de4_66ea7da4e9f6501794ec8f13_AD_4nXfmST4UcmewREfxGVVNuT-eIgvOHE5DyhGGJbj97gDiWm4hIZ4LsEdpjD1d_nFS3kLyxzcjpvjlWX5ltnUi0KE19CrZc_gfygTCtdHlqiMGfH48-7R6GJhS9adSRauES0hTKby6NH8D8JmxcpFLeTC-MPel.png)

2. Click **"Get started"**.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08dfb_66ea7da4489cc0a4a6fc4d3a_AD_4nXfdNd0acCJYgSy5XtwkvUfuY_zf8HDIoBconyYM0hD6NvCC2182ahONNod6pnDMh_M9GKNQ_R84qFm5HLvffp0HogIZ2W8qZjUVDRrkkkU8qH9ij3lbQHMqrAVWeskVTC1Lc9gFBMxBl0qqGA3gZG73cPk7.png)

## Step 3: Fill in your business information

<Note>
  This step is only necessary if you are creating a new Facebook Business Manager account.
</Note>

On **"Fill in your business information"**, click the **"Business portfolio"** dropdown and choose one of the following.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08ddd_66ea7da4b7004f0c73a59a0c_AD_4nXcwDB3Prhf_J5GG1mO2qKu3rx902yoClrUXaNyFYlStd8gMPYIikbtR6soF9LU9czZPQ9jehJEXM5RsLlTAOCVNxRYKoDHzlII4QLWRZyqKxwKcpzhxEeDJ4a_rxLtVlAEtWcbib4iXjxU7Uwx360Y40aZ0.png)

* **Create a business portfolio**, then fill in "Business name", "Business email", "Business website or profile page", and "Country".

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08dda_66ea7da436b088acb36dabba_AD_4nXfBPq2BEqdtztaRnmDhhUqtn8EwhpFkGCbvrhERmiFmVpIEZlwL4q1j9LNwGS_vp9QnvStTGjau62ffpl_lupFhuaXuykYEHFjkN6ytw_jNkPxUnku0-YoB_VP0HXv7vagHufmoY9IIxsmbsUJe5OX3XA8.png)

* Or select an **existing business portfolio** from the dropdown, which auto-fills the form.

Click **"Next"**.

### Create or select your WhatsApp Business Account

On **"Create or select your WhatsApp Business Account"**, use the **"Create a WhatsApp Business Account"** and **"Create or Choose WhatsApp Business Profile"** dropdowns to choose one of the following.

* Choose **"Create a WhatsApp Business Account"**, then **"Create a new WhatsApp Business Profile"**.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08dfe_66ea7da4c3b90a9271e54982_AD_4nXdt9oJpqyArXRJG8PQqcBc9gSu1K_iScFiZu2iSW-yQLyPZ1oZq9crYLrU3tlPIC63dtaTzwvdxqQ8u7Sg-yPFcDhfr2fwuBzuUhwQna1gvOgYFakZJ8OPej_yPHWtwxSFZA9VwSgCHoAMhSmOoopCtuZEP.png)

* Fill in "WhatsApp Business Account Name", "WhatsApp Business display name", and "Category", then click **"Next"**.

<Tip>
  Use the same **display name** as the branding on your website. [Check the display name guidelines](https://www.facebook.com/business/help/757569725593362).
</Tip>

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08de1_66ea7da4c0f47825f5bc5238_AD_4nXeXm6O-nQqdiD7KdD6r-o9kkJM6urAqy294WUOmTw5iNiGPa79TROlquj-QkwOXhdTRvOsJrJO0X2LrRjPlO9w_kMgT9vAi_2XqVdzLJLWQcrHbTSivjjrVB21CEP59fwrQb-OGPlhtfuvHY1OL03XTutT9.png)

* Or select an existing **"WhatsApp Business account"**, then in the **"Create or choose WhatsApp Business Profile"** dropdown, choose **"Create a new WhatsApp Business profile"**.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08df8_66ea7da4525bb69c0d6a4f9f_AD_4nXdkjDysr1vz0wLQnBQafYJd5WdeB69B2jh6Yhvk01heLANe5TfLjC_j6VoqgFBrQssbXxuZUTR-U2jiiSbStHc9mZXezkuhIABEmf6PP1-n_pCbcigBI3n_eloJM5J29o8n5r14NUm81kKHNUWkHTaZGC5X.png)

<Note>
  You can create multiple profiles on your WhatsApp Business account.
</Note>

## Step 4: Add a phone number for WhatsApp

Add the phone number you will connect to [bitbybit](https://app.bitbybit.studio/integrations). This number cannot be used simultaneously in the WhatsApp Business or WhatsApp consumer app.

Alternatively, get a free WhatsApp number: WhatsApp generates a +1 555 number to use exclusively for sending messages. It cannot start or receive calls or texts, and no verification is required. [This option is available for selected accounts](https://developers.facebook.com/docs/whatsapp/embedded-signup/#555-business-phone-numbers).

Enter a phone number to receive the verification code in **"Add a new or existing number"**, then click **"Next"**.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bdfe70aa720df08e44_66ea7da4f99ef4e8a84a839c_AD_4nXe61a2Nm_rG42OAKPD7zcEeTrlfOdBhvVaZFoSCBrYYsLE6v-eX4XdwyP5Dbb60GCYBtNcg6ylA9DK_de_XsKnYZiuKqGIW4QSbMwIxqiPDCbqPiJdpNm5Ga0LZCYhx2LC0PhbJedvEJ1t0q-paH2IpNjl2.png)

<Note>
  If the number is active on one of the WhatsApp apps, delete it from the app first. Follow [steps 3–5 of this process](https://developers.facebook.com/docs/whatsapp/on-premises/get-started/migrate-existing-whatsapp-number-to-a-business-account).
</Note>

## Step 5: Insert the verification code

Enter the verification code sent to your phone number.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08df5_66ea7da44dfeeddb123b6800_AD_4nXfNpUGSm892b4ekXK4afxjh83yR74BRZaTzRV7FOziHt9iSD-62XlQzmv93roDikkFJo7JimUvp3BQwyw-vufV69K9gpRi7XqpcvyuUC1srThdz8_757WONzNZRfe9BtlBeUr1RA6mCUZ-tYzoqiN8Bjuw.png)

<Warning>
  Make sure your phone number can receive SMS or phone calls for verification.
</Warning>

<Tip>
  Enable **two-factor authentication** for enhanced security.
</Tip>

## Step 6: Add a payment method

Complete the process by clicking **"Add payment method"**.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/6718b7bcfe70aa720df08dd7_66ea7da4ac7fd18cba60ec23_AD_4nXdtSUa4sXSKlLPBct5APXAgOvJArqctrFgBhootvJe7u5esW_BE1gZ0Hv15sn_qFAPjGgxcYL3C8QPmFNcCkR61YXiM2DRX2P97VjbkgTo0t_G7hq0zFuN8m84uCGRW-C-1lk21y43TeHidqjTFy11G28k.png)

<Warning>
  If you **skip** adding a payment method, your WhatsApp Cloud API will still be connected, but some features will be restricted, including message templates and Campaigns.
</Warning>

To fully activate your WhatsApp Cloud API and unlock all messaging features, add a payment method in Meta Business Manager:

1. Go to Business Settings at [business.facebook.com](https://business.facebook.com).
2. In the left sidebar, select **Settings** and click **WhatsApp Accounts**.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/685ba63930e1dc7bd06e6b4c_AD_4nXdVGgD5ifgQeROTejJS39yprpCQ6SEP-oMEXk087Jv0Dh-oRJT8i-QAa5nRTTWLLJJBT7mEz-Hv5HiNPvmpVmRPjrGVCqH2zlGYCUfoFqSJaARvUkHzY_lkq3xCMUC3_Tl9ZwzIDg.png)

3. Select the WhatsApp Business Account you just connected.
4. Scroll down and click **Payment Settings**.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/685ba63930e1dc7bd06e6b52_AD_4nXeuVSkVCk-CGVrCJVafqAxcBrrztSSKLyWFhoOjcje2u5ogbGNHK5lZ9y9VqNfZCim4k3ShJqFwl04_M284jy26a_zvSv_b4zp8PU7HtRHggYYJhAsECfrxTWqTzohpq9rqfSmPlg.png)

5. Click **Add Payment Method** and complete the required billing details.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/685ba63930e1dc7bd06e6b55_AD_4nXcoSVVSHp_PMDAXvmJkvh_irThZgrBGp8OJvyuQosooTFTPdw2YqNJIxYZlKXHqB76bhL1Cu4O4tTasD3JmRWvB7d1iIeXsNYWJVEDjs9_vr-XfYC90X2aGgk7hbhny0r45BqAD2A.png)

6. Fill in all business information as requested, including name, legal entity, and billing address.
7. After saving, make sure there are no alerts or warnings on the payment settings page.

## Step 7: Add a profile picture

Your profile picture is the first impression customers get when they message you. Many businesses use their logo to convey professionalism and trust; others show a signature product. You can add it either from bitbybit or from Facebook Business Manager.

<Tabs>
  <Tab title="From the bitbybit app">
    1. Go to [WhatsApp API Profile](https://app.bitbybit.studio/misc/whatsapp-api-settings?section=whatsapp-api-profile) settings.
    2. Click **"Upload image"** on Profile photo.

    ![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/67caacf9663829d003624dad_AD_4nXe2Z7BUNjXi3BdOOhrlIK475zB4Of1xBDMV9GqmTmDOH16hwO8aICTLo3GNnYc1JVC68U_M7C2jZsWwsYyQdX3jBZmf_43yz4uORzJdATt5PTO9l-Lok0dLFeC4Hpe8NCmC-5_O6w.png)

    3. Click **"Save changes"**.

    ![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/66ff4e96dd07492f0ca27318_66fe685d5d78b249df1e1da0_AD_4nXfMEwmXptvBBdLzfO3EOuB2nz-Jx9Z2kxQrFCB-ra5eKGv4mcrmBYlkXxIUEfNxIcFo514grcgpErcE6zCgQxvY5ld1RUDFcgMDPc_4q3Yr8PqwnTVec3-hIrTFq5FGJc4lfzn1bj3JlWeJHPfneFldX-pb.png)
  </Tab>

  <Tab title="From Facebook Business Manager">
    1. Go to [business.facebook.com/wa/manage/phone-numbers](https://business.facebook.com/wa/manage/phone-numbers/).

    2. **Select the phone number settings.** In the list of phone numbers you want to update, click the **Settings** icon.

           <img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-09-11100653.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=2d60c1a298ec5016b45583679d776e83" alt="Screenshot2025 09 11100653 Pn" width="1086" height="289" data-path="images/Screenshot2025-09-11100653.png" />

    3. **Navigate to profile settings.** On the Settings page, go to the **Profile** tab on the left, then click **"Choose file"**.

           <img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-09-11101104.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=3eef96f140e078582733d474baa84843" alt="Screenshot2025 09 11101104 Pn" width="1083" height="521" data-path="images/Screenshot2025-09-11101104.png" />

    4. **Upload your image** and wait for it to finish uploading. The picture should be at least 192px by 192px, in JPG or PNG format.

    5. **Preview and save.** Preview the image on the right side of the page, confirm it is correct, then click **"Save"**.

           <img src="https://mintcdn.com/asmaraku/cHM4z2t-1XWdSut8/images/Screenshot2025-09-11101156.png?fit=max&auto=format&n=cHM4z2t-1XWdSut8&q=85&s=9294d5d5d20e170bbdf4f1c2bd419fb1" alt="Screenshot2025 09 11101156 Pn" width="1084" height="424" data-path="images/Screenshot2025-09-11101156.png" />

    Your WhatsApp Cloud API profile picture is now live.
  </Tab>
</Tabs>

## Test your WhatsApp Cloud API connection

After setting up WhatsApp Cloud API and adding a payment method, send a test message using a **Campaign**, **Automation**, or **Chat Initiation** template. Follow these guides to create your template:

* **Campaign**: [Create a Message Template Campaign](/bitcrm/how-to-create-a-message-template-campaign-for-whatsapp-cloud-api)
* **Automation**: [Choose a Message Template for Automation](/bitcrm/how-to-create-a-message-template-for-whatsapp-cloud-api-automation)
* **Chat Initiation**: [Create a chat initiation template](/bitchat/how-to-create-a-chat-initiation-template)

Meta categorizes messages into conversation categories: Authentication, Marketing, Utility, and Service. Check [Meta's pricing details](https://business.whatsapp.com/products/platform-pricing).

Once your template is created, test it in [bitbybit's LiveChat](https://app.bitbybit.studio/bitchat/livechat) page to confirm it sends and receives successfully. The message you sent should appear on the bitbybit LiveChat page.

![](https://cdn.prod.website-files.com/659655f5b20d395a5c69efcf/67e4fa1ea378e5dd1d040d45_AD_4nXceWW6XfP7Tr_e3FpAWL7gW_-Z3OoHEk0dgFw2ROI3SggXuoBYOs2-2Q90Op3leHrVWCAtRPEE9u_B6e80gAidtQWkBcU4hCqCxlti0B3h59Z8E7-v1JLi2CfmMja0rKO22zVDSRw.jpeg)

<Check>
  If the message delivers successfully, your integration is complete.
</Check>

If it fails, recheck the steps above, especially your payment status and phone number verification.

## Related

* [WhatsApp Business App](/integrations/whatsapp-business-app) — keep using your WhatsApp Business App alongside the Cloud API
* [WhatsApp Sandbox](/integrations/whatsapp-sandbox) — test features with your own number
* [Fix "phone number is already linked"](/bitchat/how-to-fix-phone-number-already-linked)