Skip to main content

Setup Errors & Solutions

Overview​

Setting up a WhatsApp Business Account using the Chakra Chat Embedded Signup (ES) flow. However, users do face errors during the process and need assistance to fix them immediately.

WhatsApp API Setup: Common Errors and Their Resolution​

Error 1: Phone isn't eligible​

  • Error message: Your phone number isn't eligible to connect to the WhatsApp Business Platform. More activity on the WhatsApp Business App is needed to help determine eligibility.
  • **Cause: **Meta requires the phone number to have been actively used on the WhatsApp Business App for at least 7 days to establish credibility. New or recently registered numbers may not meet eligibility criteria.
  • Resolution: Actively use the WhatsApp Business App for at least 7 days (preferably longer, up to 1–2 months) to establish messaging history and credibility. Engage in regular communication with customers to demonstrate consistent usage.

Error 2: Phone registered to existing WhatsApp​

  • Error message: This number is registered to an existing WhatsApp account. To use this number, disconnect it from the existing account. Then, return to this page and re-enter the number.
  • **Cause: **Meta restricts the immediate reuse of a phone number previously registered with a WABA account. A cooldown period of 1–2 months is required to re-establish the number’s eligibility in the WhatsApp Business App.
  • Resolution: If the phone number was previously used for a WABA, delete the WABA account via the provider’s platform or from the WhatsApp Manager. Download the WhatsApp Business App, sign up with the same number, and use it actively for 1–2 months to build credibility.

Error 3: Facebook API is not initialized​

  • Error message: Facebook API is not initialized
  • Cause: This is a temporary issue during the launch of the embedded signup flow
  • Resolution: Do a hard refresh, Windows (Ctrl + F5) or macOS (Shift + Command + R) and try clicking on Continue with Facebook