If you're seeing an error during setup or your phone number cannot be connected, this guide explains the most common causes and how to resolve them.
Before you start
Before connecting your WhatsApp Business API channel, confirm the following prerequisites. These checks can help prevent common connection issues during setup.
-
Use your exact legal business details
The legal business name and address entered in the Business Info section of your Meta Business Portfolio must match your official business registration documents exactly. Even small differences in spelling or punctuation may delay verification.
-
Use an established Facebook account
Newly created Facebook accounts are more likely to be restricted by Meta during Business Portfolio creation. We recommend using an account that has been active for at least one month.
-
Ensure you have the correct admin permissions
The account used during setup must have “Full control” access to the Meta Business Portfolio in Meta Business Manager.
-
Enable two-factor authentication (2FA)
Meta may require administrators to enable 2FA before certain WhatsApp setup steps can be completed.
-
Complete your business information in Meta first
If your Meta Business Portfolio is missing required business details, the WhatsApp setup process may fail or prevent you from claiming a phone number.
⚠️ Note: The list below covers the most common issues that occur when connecting a phone number to the WhatsApp Business API through SleekFlow.
Some errors may originate from Meta’s setup process or account restrictions, which may require actions in Meta Business Manager or WhatsApp Manager. If the issue persists after following the steps below, contact our support team with a screenshot of the error message.
Common connection issues when connecting WhatsApp Business API
| Issues | Description | Possible cause and suggested solution |
| OTP not received | The verification code required to register your phone number was not received. |
Confirm that the phone number can receive SMS or voice calls, then request the verification code again. Avoid requesting the code repeatedly in a short period, as Meta may temporarily lock the registration flow after too many attempts. If you have already tried several times, wait 24–48 hours before retrying. Tip: If the SMS verification code does not arrive, try requesting the code via phone call instead. |
| The IVR problem | The verification call cannot reach the phone number directly. |
If the number has an IVR system or auto-attendant (for example “Press 1 for Sales”), the Meta verification system cannot navigate it. Temporarily disable the IVR so the call goes directly to a person or voicemail. |
| Wrong Business Portfolio selected | The wrong Meta Business Portfolio is selected. | Restart the connection process and make sure you select the correct Meta Business Portfolio during setup. Double-check the portfolio name before confirming the connection. |
| Phone number is still linked to the WhatsApp Business app | A phone number cannot be used in the WhatsApp Business app and the WhatsApp Business API at the same time. |
If you want to migrate the number to the API, delete the WhatsApp account from the WhatsApp Business app first. Go to Settings → Account → Delete my account, then restart the setup process in SleekFlow. |
| Cannot add phone number | The phone number cannot be registered during setup. |
This can happen if the WhatsApp Business Account is restricted or banned by Meta. Check the Account Quality dashboard in Meta Business Manager and submit an appeal if necessary. |
| WABA limit reached | Your business account has reached its phone number limit. |
Unverified Business Managers are currently limited to two phone numbers. Verify your Business Manager (BM) to increase your limit and messaging tiers. If needed, you may also create a new Business Manager. |
| Migration verification fails | Phone number migration from another WhatsApp Business API provider cannot complete. |
The previous provider may still have two-step verification (PIN) enabled for the phone number. Disable two-step verification with the current provider before starting migration. If the PIN was recently changed, Meta may require a cooldown period before migration can proceed. Also confirm the number can receive SMS or voice calls during the migration process. |
Common connection issues when connecting via WhatsApp Coexistence
| Issues | Description | Possible cause and suggested solution |
| Rate limit or generic connection error | An error occurs during the connection process, such as a rate limit or a generic connection failure. |
This may be caused by temporary platform instability, third-party provider limitations, or connection restrictions during setup. Take a screenshot of the exact error message or error code and share it with our support team. Include the phone number you are connecting, the time the error occurred, and whether you were using Co-existence (WhatsApp) to help our team investigate more quickly. |
| Existing chats do not fully sync | Not all previous WhatsApp conversations appear in SleekFlow after connecting Co-existence (WhatsApp). |
Co-existence has sync limitations, so only certain conversations can be imported. Typically, only recent 1:1 chats will sync to the platform. Group chats remain in the WhatsApp Business app. If your team requires full message history, contact support to review whether another integration setup may better fit your needs. |
| Connection disconnects after inactivity | The connection between SleekFlow and the WhatsApp Business app becomes inactive. | Meta requires the WhatsApp Business app to remain active when using Co-existence. To maintain the connection, open the WhatsApp Business app on the linked phone at least once every 13 days. |
| Standard Co-existence flow is too limiting for your volume | Some businesses may experience operational limitations when using an app-connected setup. |
Co-existence is designed for lightweight integrations and may not support high messaging volumes or advanced automation needs. If you require greater scalability or control, contact support to discuss whether a direct WhatsApp Cloud API connection is more suitable for your use case. |
| Phone number is not eligible | The phone number cannot be used for Co-existence setup. |
Meta requires the number to be active on the WhatsApp Business app for at least 7 days before it becomes eligible. Newly registered or low-activity numbers may not qualify immediately.
Use the number for regular customer conversations for at least 7 days (ideally 30–60 days) before retrying. Avoid deleting and re-registering the number, as this resets the activity history and delays eligibility. |
| Unsupported message type / message unavailable | Some messages appear as “message unavailable” in the platform. | This can happen when messages are sent from unsupported devices or environments that do not trigger webhook events. These messages may not be available in SleekFlow. In this case, view the message directly in the WhatsApp Business app. |
FAQs
Q: I want to use an already registered phone number
To use a phone number that's already registered with WhatsApp:
-
If registered with WhatsApp or WhatsApp Business app
Delete the WhatsApp account to make the phone number available for the WhatsApp Business Platform with SleekFlow. -
If registered with another WhatsApp Business Platform
In the WhatsApp Manager turn off two-factor authentication (2FA) for the number on the WhatsApp Business Platform. Register the phone number on SleekFlow after that. Contact your Solution Partner if you can't turn off 2FA by yourself.
Learn more about migrating an existing WhatsApp Business API account to SleekFlow.
Q: Why did the connection fail even after I completed the Meta steps?
The connection can still fail if the setup was not fully completed on Meta’s side. This may happen if the phone number was not fully registered, or the WhatsApp Business Account is still pending review or verification. Check that you completed every step in Meta and then try the connection again.
Q: Why can’t I complete phone number registration?
Phone number registration may fail if:
- The number is already linked to another WhatsApp setup
- The selected WhatsApp Business Account is unavailable
- The phone number or WABA has been restricted by Meta
The number cannot receive SMS or voice calls for verification
Confirm the number is not used elsewhere and check Meta Account Quality for restrictions before retrying.
Q: Why didn’t I receive the verification code?
Verification codes are sent by SMS or voice call during phone number registration.
If you did not receive the code:
- Confirm the phone number can receive international SMS or voice calls. Check that the number format is entered correctly
- Avoid requesting multiple codes in a short period, as Meta may temporarily block additional requests
- If SMS verification fails, try requesting the code via phone call
If you already retried multiple times, wait 24–48 hours before attempting again
Q: Can I verify a landline phone number?
Yes. Landline numbers can receive the verification code through a voice call.
However, verification may fail if the number uses an IVR or auto-attendant system. If possible, temporarily disable the IVR so the verification call can reach a person or voicemail directly.
Q: Can I connect a phone number that is still active in the WhatsApp Business app?
No. A phone number cannot be used in the WhatsApp Business app and WhatsApp Business API at the same time.
To migrate the number to the API:
- Open the WhatsApp Business app
- Go to Settings → Account
- Select Delete my account
After the account is removed, restart the API connection process.
Q: Why can’t I find my business portfolio after signing in?
If you can’t find your business portfolio during setup, you may be signed in to the wrong Meta account, you may not have the required access to that portfolio, or the portfolio may still be in the middle of setup or verification. If you have multiple portfolios, make sure you selected the right one in Meta Business Suite. Then confirm that your account has the necessary permissions and try the connection again.
Q: Why does my legal business name and address need to match my official documents?
Meta verifies your business using the Business Info details in your Meta Business Portfolio.
Even small differences in spelling, punctuation, or address format can delay or prevent verification. Make sure the business name and address match your official registration documents exactly.
Q: Why should I use an established Facebook account when creating a Meta Business Portfolio?
Newly created Facebook accounts are more likely to trigger Meta trust and safety checks.
Using an account that has been active for some time reduces the likelihood of restrictions when creating a business portfolio or connecting WhatsApp.
Q: What happens if my Meta Business Portfolio is not verified?
You may still be able to start the setup process, but:
- Your phone number limits and messaging tiers may remain restricted
- The account may have a higher risk of being restricted or banned
Completing business verification in Meta Business Manager unlocks higher messaging limits and improves account stability.
Q: Why is the QR code not working?
The QR code step can fail if the phone does not have the latest WhatsApp Business app version, or if the QR session has expired and needs to be restarted.
Q: Why am I seeing a rate limit or generic connection error?
If you see a rate limit error or a generic connection failure during setup, the issue may be temporary or caused by limitations in the current connection flow. Take a screenshot of the full error message or error code and share it with our support team so we can investigate more quickly.
Q: What should I do if the current setup flow feels too limited or unstable?
If the standard setup flow feels too restrictive or does not support your messaging volume reliably, you may want to consider switching to a direct WhatsApp Cloud API integration. This can help reduce dependency on intermediary setup limitations and may provide a more stable option for higher-volume use cases. Contact our support team if you’d like help evaluating this option.