# Common Errors & Troubleshooting ## 1. **Coexistence Errors** #### WhatsApp Channel Shows Not Connected This issue usually occurs when the WhatsApp channel fails to establish a proper connection due to incomplete verification or account restrictions. #### Possible Causes * Meta Business Account is under review or disconnected * Business verification is incomplete * Coexistence policy validation failed #### Resolution * Complete Business Verification from under **Security Center** * Ensure business details match submitted documents * Check account quality in * Contact support if the issue persists {% hint style="info" %} You can visit the [**Business Verification**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#business-verification) and [**Check Account Quality**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#check-account-quality) sections to understand how to complete these steps. {% endhint %} #### Coexistence Gets Auto-Disconnected This happens when Meta automatically disconnects the channel due to policy or quality issues. #### Possible Causes * Policy violations * Poor quality rating * Interrupted signup * Session timeout #### Resolution * Review account quality in * Ensure account status is approved before reconnecting {% hint style="info" %} You can visit the [**Check Account Quality**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#check-account-quality) section to learn how to verify and resolve issues. {% endhint %} ### Embedded Signup Shows Successful but Not Fully Connected Even if signup appears successful, backend onboarding may remain incomplete, causing messaging to fail. #### Possible Causes * Signup shows successful * WhatsApp Business app shows connected * Meta shows pending * Messaging not working #### Resolution * Re-register the number from * Ensure all steps complete without interruption {% hint style="info" %} You can visit the [**Retry Onboarding**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#retry-onboarding-embedded-signup) section for detailed steps. {% endhint %} ### Login Succeeds but Channel Disconnects Later This is usually related to browser or session issues rather than account configuration. #### Possible Causes * Cache or cookies issues * Pop-ups blocked * Session expired #### Resolution * Use a supported browser (Chrome recommended) * Enable pop-ups * Retry onboarding from * Clear browser cache before retrying {% hint style="info" %} You can visit the [**Retry Onboarding**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#retry-onboarding-embedded-signup) section for step-by-step guidance. {% endhint %} ## **2. New Number connection Errors** ### Channel Status Shows Pending This indicates that Meta onboarding is still in progress or verification is incomplete. #### Possible Causes * Business verification pending * Backend registration incomplete * Account under review #### Resolution * Complete verification via * Wait up to 24 hours for Meta processing * Retry onboarding if status does not update {% hint style="info" %} You can visit the[ **Business Verification** ](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#business-verification)section to complete the process. {% endhint %} ### Channel Connection Fails During Setup This occurs when onboarding is interrupted or required steps are not completed. #### Possible Causes * Verification incomplete * Signup interrupted #### Resolution * Complete business verification from * Retry onboarding via {% hint style="info" %} You can visit the [**Business Verification**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#business-verification) and [**Retry Onboarding** ](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#retry-onboarding-embedded-signup)sections for guidance. {% endhint %} ### OTP Not Received OTP issues are generally caused by formatting errors or telecom restrictions. #### Possible Causes * Incorrect number format * OTP delay or block #### Resolution * Enter number without "+" or spaces * Retry using SMS or voice option in * Check DND/SMS blocking with telecom provider {% hint style="info" %} You can visit the [**OTP Troubleshooting**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#otp-troubleshooting) section for more details. {% endhint %} ### Number Verification Fails This happens when the number is already linked to a WhatsApp account. #### Possible Causes * Number linked to WhatsApp app * Not eligible for API #### Resolution * Delete the WhatsApp account from mobile * Wait 24–48 hours before retrying {% hint style="info" %} You can visit the [**Remove Number from WhatsApp**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#remove-number-from-whatsapp) section to understand the steps. {% endhint %} ### Number Already in Use This indicates that the number is actively associated with another WhatsApp account. #### Possible Causes * Active WhatsApp Personal/Business account #### Resolution * Delete existing WhatsApp account * Retry after 24–48 hours {% hint style="info" %} You can visit the [**Remove Number from WhatsApp**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#remove-number-from-whatsapp) section for detailed steps. {% endhint %} ## **3. Common Errors** ### Number Already Connected with Another Partner This occurs when the number is already linked to another BSP. #### Possible Causes * Existing partner integration * Number previously onboarded elsewhere #### Resolution * Go to → **Accounts → WhatsApp Accounts** * Open the **Partners** section and remove the existing partner * If using coexistence, disconnect from WhatsApp Business app * Retry onboarding {% hint style="info" %} You can visit the [**Remove Existing Partner**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#remove-existing-partner) and[ **Remove Partner from WhatsApp Business App**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#remove-partner-from-whatsapp-business-app-coexistence) sections to complete this process. {% endhint %} ## **4. Meta Errors** ### Business Does Not Meet Policy Requirements This error indicates non-compliance with WhatsApp policies. #### Resolution * Ensure website is live and publicly accessible * Verify business details are accurate * Submit review via {% hint style="info" %} You can visit the [**Request Review**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#request-review-appeal) section to understand how to raise an appeal. {% endhint %} ### Currency Mismatch in WABA This happens when the payment method currency differs from the WABA currency. #### Resolution * Create a new WABA from {% hint style="info" %} You can visit the [**Create / Access WABA**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#create-access-whatsapp-business-account-waba) section for detailed steps. {% endhint %} ### Security PIN Mismatch (2FA Issue) This occurs when an incorrect PIN is entered. #### Resolution * Use correct PIN or reset 2FA via {% hint style="info" %} You can visit the [**Create / Access WABA**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#create-access-whatsapp-business-account-waba) section for guidance. {% endhint %} ### Unsupported Post Request This is usually a temporary onboarding issue. #### Resolution * Retry onboarding via * Create new WABA if issue persists {% hint style="info" %} You can visit the [**Retry Onboarding**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#retry-onboarding-embedded-signup) section for steps. {% endhint %} ### WABA Limit Exceeded Meta limits the number of WABAs per Business Manager. #### Resolution * Delete unused WABAs or create a new Business Manager via {% hint style="info" %} You can visit the [**Create / Access WABA**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#create-access-whatsapp-business-account-waba) section for more details. {% endhint %} ### WABA Temporarily Banned / Permanently Disabled This occurs due to policy violations or poor quality rating. #### Resolution * Check status in * Request review via * Create new WABA if permanently disabled {% hint style="info" %} You can visit the [**Check Account Quality**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#check-account-quality) and[ **Request Review**](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#request-review-appeal) sections to proceed. {% endhint %} ### Business Restricted This is usually due to invalid or non-compliant website details. #### Resolution * Submit review request via {% hint style="info" %} You can visit the[ **Request Review** ](/setting-up-guide/whatsapp-tips-and-tricks/meta-business-suite-setup-and-configuration.md#request-review-appeal)section for guidance {% endhint %} ### The website you entered seems broken. Check the URL to make sure it's correct.
If you are seeing this error, it means the **Facebook Crawler (Bot)** is unable to access your webpage. Even if the website loads correctly in your browser, the crawler cannot access it to verify your business and confirm whether it is eligible to use WhatsApp messaging services. **Common reasons for this error:** * Open Graph (OG) tags are missing from your website * robots.txt file is missing or blocking Facebook crawlers * Your website is not accessible from a US server location, possibly blocked by your hosting provider #### **Diagnose the Issue** Go to the Facebook Sharing Debugger tool and enter your website URL: 👉 This will show you the exact error so you can troubleshoot accordingly. #### **If you see a 403 error and Open Graph data is empty:** Your website is blocking the Facebook crawler. You will need to whitelist the `facebookexternalhit` bot on your server or via your hosting provider's firewall settings. Additionally, Open Graph tags are missing from your homepage. Add them to your website's `` section. Replace the details with your own information. If you are unsure how to do this, please contact your developer or hosting company for assistance. ```html ``` #### If error related to robots.txt block If the error indicates that your robots.txt file is blocking the Facebook crawler, you must add the following code to your robots.txt file. If you are unsure how to update this, please contact your web developer or hosting company for assistance. ```html User-agent: * Allow: / ``` #### If error related block access You must ensure that your website is accessible from the **US region**, as the Facebook crawler bot accesses your webpage from US-based servers. Your hosting provider's firewall or security settings may be restricting access from outside your country. To resolve this, contact your hosting provider or technical team and request them to: * Whitelist US region IP addresses * Check and disable any geo-blocking rules that may be restricting international access to your website #### How to check whether the issue is resolved Once your applied the necessary changes, please wait for **5 to 10 minutes** then you can visit and input your domain then click on "Scrape Again" button and if you are seeing no error and returns 200 as shown below this means everything is good, you can resume the onboarding step now.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.pickyassist.com/setting-up-guide/whatsapp-tips-and-tricks/common-errors-and-troubleshooting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.