--- title: WhatsApp Business Cloud troubleshooting slug: whatsapp-business-cloud-troubleshooting docTags: createdAt: 2026-04-17T14:37:32.475Z --- Some of the errors that you might encounter when using WhatsApp Business Cloud. :::ExpandableHeading ### I get an error choosing 'Connect a WhatsApp Business app' while establishing the connection in Make Select the **Connect a WhatsApp Business app** option when [creating the connection in Make](docId\:GUsgXhzpmkDyyjETseYv6) only if you are already have the WhatsApp Business app installed on your mobile phone. If your phone number is not yet linked to the WhatsApp Business app on your device, choosing this option will result in an error. ::: :::::ExpandableHeading ### I see a “number already connected” or similar error when choosing 'Connect a WhatsApp Business app' while establishing the connection These errors may occur if the phone number you're trying to connect is already linked to another WhatsApp Business Account or business portfolio. **How to fix it?** ::::WorkflowBlock :::WorkflowBlockItem Open [Meta Business Suite](https://business.facebook.com/). ::: :::WorkflowBlockItem Check whether this phone number has already been connected under a different business portfolio or WhatsApp account. ::: :::WorkflowBlockItem If it is connected, either: - Use the correct portfolio, or - Remove the existing connection before attempting to connect it again in Make. ::: :::: ::::: ::::::ExpandableHeading ### I do not see my WhatsApp Business account in the dropdown list This usually happens because a WhatsApp Business Account cannot be managed simultaneously by multiple 'Partners'. **How to fix it?** :::::WorkflowBlock :::WorkflowBlockItem Open [Meta Business Suite](https://business.facebook.com/). ::: :::WorkflowBlockItem Go to **Settings **(gear icon) > **Accounts **> **WhatsApp Accounts**. ::: :::WorkflowBlockItem Select the relevant WhatsApp Business Account. ::: :::WorkflowBlockItem In the **Users** section in the left sidebar, click the **Partners** tab. ![](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/zRGEfruqVVHLo8t7jPdan-20260319-091335.png) ::: :::WorkflowBlockItem If your WhatsApp account is already connected to other chat platforms and you want to proceed with a Make connection, click the **three dots** next to the partner, and select **Remove from Business portfolio** to disconnect it completely. ::: ::::WorkflowBlockItem If the partner still appears in that list, click **Manage** and remove the access. :::hint{type="warning"} The WhatsApp account will stop working with that other platform once you remove the access. ::: :::: :::WorkflowBlockItem Return to Make, and try to create the connection again. ::: ::::: If you still cannot see your WhatsApp Business account in the dropdown list after following the steps above, you may need to perform a **phone number migration**. For more details, refer to the Whatsapp Business Platform [documentation](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup/). :::hint{type="warning"} Migrating your phone number to Make as a Solution Partner means the phone number will no longer work on any other platforms where it is currently connected. ::: **How to migrate your number?** ::::WorkflowBlock :::WorkflowBlockItem In the Make connection flow, select the option **Create a WhatsApp Business account**. ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/Whi7gVghHJJ8OnV3eBb6w_.blob" size="60" width="1600" height="1326" position="center" darkWidth="1600" darkHeight="1326" showCaption="false"} This will lead you to create a new WhatsApp Business Account. We strongly recommend using all the details of your existing WhatsApp Business Account. ::: :::WorkflowBlockItem Follow the dialog to add the phone number in question. You will need to complete **2FA verification** via Text Message or Phone Call. ::: :::WorkflowBlockItem You will receive a prompt confirming the migration. Follow the on-screen instructions to complete the process. ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/KIXKTKjD7_Qy7SZXBVOeh_.blob" size="70" width="1600" height="1354" position="center" darkWidth="1600" darkHeight="1354" showCaption="false"} ::: :::: :::hint{type="info"} If you complete the process but the connection is not created, it may be due to a timeout. Simply try the process again; it is usually much faster the second time. ::: **What happens to my data?** [According to Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup/): - Your business phone number, display name, quality rating, messaging limit, and Official Business Account status are all preserved. - All eligible templates are automatically duplicated and granted the same statuses. - All media previously uploaded to your business phone number can continue to be used. :::::: :::ExpandableHeading ### This account is not registered This error usually appears when the number you are trying to send a message from is not yet registered in the WhatsApp Cloud API. **How to fix it?** Use the **Register a Sender** module to register your number before sending a message. Once the number is registered, the **Send a Message **module will work as expected. ![](https://api.archbee.com/api/optimize/4CkrlJIBl1di_p1x71ery--VeuzHtJYXRfhNr1Iy8hb-20250908-151224.png) ::: ::::ExpandableHeading ### WhatsApp API - Error 500 code 13100 The user gets an error 500 from the module, and the **DevTool > Response Body** shows error code 131000. ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/sWykEgKIZcm3kAyJmdvGe_image.png" size="70" width="851" height="713" darkWidth="851" darkHeight="713" position="center" showCaption="false"} :::hint{type="info"} You can only initiate new chats via **Send a Template** module. Only after sending a templated message to a specific customer and receiving a response from the customer, you can use this **Send a Message** module to send a non-templated message to the customer. ::: :::: :::::ExpandableHeading ### Webhook not set up for phone number migration **Error:** `[400] [100] (#100) Invalid parameter. Cannot Migrate Phone Number: The WhatsApp destination account must have webhooks set up.` ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/iFUqiTSdjgeYhB2KtqyVQ_.blob" size="50" width="448" height="476" position="center" darkWidth="448" darkHeight="476" showCaption="false"} This error occurs during a phone number migration if the destination WhatsApp Business Account does not have an active webhook configuration. Meta requires an active webhook to facilitate the secure transfer of the number. **How to fix it:** ::::WorkflowBlock :::WorkflowBlockItem In your Make scenario, add a **WhatsApp Business Cloud** > **Watch Events** module. ::: :::WorkflowBlockItem Click **Create a webhook** and follow the prompts to save it. ::: :::WorkflowBlockItem Once the webhook is created, return to the connection/migration flow and **retry the migration**. ::: :::: ::::: :::::ExpandableHeading ### Invalid blueprint / incompatible account while saving a scenario **Error:** `Invalid blueprint: Provided account is not compatible with the whatsapp-business-cloud:sendMessage module.` ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/fmotZAsV0DHCMYOCsPzS6_.blob" size="50" width="492" height="225" position="center" darkWidth="492" darkHeight="225" showCaption="false"} This error typically occurs when you attempt to save a scenario containing a WhatsApp Business Cloud module that is linked to an invalid or outdated connection. It can also happen if the connection was updated but the individual modules in the scenario haven't acknowledged the change. **How to fix it?** ::::WorkflowBlock :::WorkflowBlockItem Open the configuration of each **WhatsApp Business Cloud** module in your scenario. ::: :::WorkflowBlockItem Click the **three-dot menu** (next to the Connection field) and select **Refresh form**. ::: :::WorkflowBlockItem Ensure a valid connection is selected in the dropdown. ::: :::WorkflowBlockItem Repeat these steps for every WhatsApp module in the scenario. ::: :::WorkflowBlockItem Save the scenario again. ::: :::: ::::: :::::ExpandableHeading ### Payment method is missing on the WhatsApp account **Error:** `[400] [100] (#100) Invalid parameter. Cannot Migrate Phone Number: Your WhatsApp Business Account does not have payment method set up.` ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/1yT10KnZgsNVdAFzXEI5n_.blob" size="50" width="447" height="251" position="center" darkWidth="447" darkHeight="251" showCaption="false"} This error occurs during a phone number migration when the destination WhatsApp Business Account lacks a valid payment method. Even if you are within the free tier limits, Meta requires billing information to be configured for the account to be fully active for migration. **How to fix it?** ::::WorkflowBlock :::WorkflowBlockItem Log in to your **[Meta Business Suite](https://business.facebook.com/)**. ::: :::WorkflowBlockItem Navigate to **All Tools** > **Billing & payments**. Ensure you have selected the correct **Business Account** in the dropdown menu. ::: :::WorkflowBlockItem Under **Payment Methods**, click **Add Payment Method** and follow the prompts to link a valid card or account. ::: :::WorkflowBlockItem Once the payment method is successfully added, return to Make and retry the migration operation. ::: :::: :::hint{type="info"} After adding the payment method, it may take a few minutes for Meta to update the status of your account. If the error persists immediately, wait a short moment and try again. ::: ::::: :::::ExpandableHeading ### Two-step verification blocks certificate creation **Error:** `[400] [100] Invalid parameter. Cannot Create Certificate. Please ensure two-factor authentication is disabled.` ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/FgytBbpYPI3E_GPAl4UcZ_.blob" size="60" width="467" height="214" position="center" darkWidth="467" darkHeight="214" showCaption="false"} This error occurs when attempting to create a connection or migrate a number that still has **Two-step verification** enabled within the WhatsApp settings. This security layer prevents Make from generating the necessary security certificate to manage your messages. **How to fix it?** ::::WorkflowBlock :::WorkflowBlockItem Log in to your **[Meta Business Suite](https://business.facebook.com/)**. ::: :::WorkflowBlockItem Go to **All Tools** > **WhatsApp Manager**. ::: :::WorkflowBlockItem In the left sidebar, click **Phone numbers**. ::: :::WorkflowBlockItem Find the phone number you are trying to connect and click the **Settings** (gear icon) in the **Tools** column. ::: :::WorkflowBlockItem Select **Two-step verification**. ::: :::WorkflowBlockItem Click **Disable Two-step verification**. An email will be sent to the administrator to confirm this action. Once disabled, return to Make and rerun the connection or migration step. ::: :::: ::::: ::::::ExpandableHeading ### Account not registered **Error:** `[400] [133010] (#133010) Account not registered` ::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/UWJBsBf8yq-P2xYnzf3BC_.blob" size="50" width="415" height="184" position="center" darkWidth="415" darkHeight="184" showCaption="false"} This error occurs when a phone number has been added to your Facebook Business Portfolio but hasn't been officially registered as a sender on the WhatsApp Business Platform. The number is known to Meta but is not yet active for sending or receiving messages through Make. **How to fix it?** :::::WorkflowBlock :::WorkflowBlockItem In your Make scenario, add the **WhatsApp Business Cloud > Register a Sender** module. ::: :::WorkflowBlockItem Select the **Connection** and the **Phone Number ID** you are trying to use. ::: ::::WorkflowBlockItem Provide a **PIN**. :::hint{type="info"} If you don't have an existing PIN, you can create a new one. ::: :::: :::WorkflowBlockItem Run the module once manually. ::: :::WorkflowBlockItem After the module runs successfully, your number is fully registered. You can now delete the **Register a Sender** module and retry your original workflow. ::: ::::: ::::::