Common Issues During WhatsApp Signup: Troubleshooting Guide

Summary

Setting up WhatsApp Business API through WhatsTeam should be a straightforward process, but certain situations can cause complications during signup. Whether your number is already connected to another Business Solution Provider (BSP), registered on a personal WhatsApp account, or linked to a different Meta portfolio, each scenario requires a specific resolution path.

This comprehensive guide walks you through the most common issues encountered during WhatsApp signup and provides clear, step-by-step instructions to resolve them so you can get your business up and running on WhatsTeam as quickly as possible.

Pre-Integration Checklist

Before starting the WhatsApp signup process on WhatsTeam, make sure you have the following items ready. Completing this checklist beforehand will save you time and prevent the most common blockers.


• A valid phone number: This number must be able to receive either SMS or voice calls for verification. It should not currently be active on the standard WhatsApp or WhatsApp Business mobile app unless you plan to migrate it.
• A Meta Business Account: You need an active Meta Business Account (formerly Facebook Business Manager). If you do not have one, it will be created during the Embedded Signup flow.
• Business verification documents: Prepare your legal business documentation such as business registration certificates, tax identification numbers, or articles of incorporation.
• Admin access to Meta Business Suite: If you already have a Meta Business Account, ensure you have administrator-level permissions.
• Two-Factor Authentication (2FA) disabled: If the phone number is currently used on a WhatsApp mobile app, disable 2FA in the app settings before proceeding.
• Browser requirements: Use a modern browser (Chrome, Firefox, Edge) with pop-ups enabled for the Meta login flow.


Tip: Having all these items prepared before you begin will dramatically reduce the likelihood of encountering errors during the signup process.

Number Connected to Another Business Platform

One of the most frequent issues occurs when your phone number is already registered with another WhatsApp Business Solution Provider (BSP). WhatsApp enforces a strict one-provider-per-number policy, meaning a single phone number can only be active on one BSP at any given time.


How to Identify This Issue

You will typically see one of the following error messages during signup:

• "This number is registered to an existing WhatsApp account"
• "Cannot migrate phone number. The WhatsApp account that this number is registered isn't set up correctly."
• "Phone number is already in use by another WhatsApp Business API client"

Why This Happens

This situation arises when:

1. Your number was previously connected to a different BSP (such as Twilio, MessageBird, or 360dialog) and was never formally disconnected.
2. Your number is still active on the WhatsApp Business mobile app.
3. A previous employee or agency set up the number on a different platform without your knowledge.


Resolution Overview

The resolution depends on your current setup. You have two main paths:

1. Cloud API Path: Fully disconnect the number from the current provider and re-register it on WhatsTeam.
2. Coexistence Path: If you want to keep your number active on the WhatsApp Business mobile app while also using it through WhatsTeam's API.

Both paths are described in detail in the following sections.

Switching Between BSPs

If your number is currently managed by another BSP and you want to move it to WhatsTeam, you need to perform a formal migration. This process involves coordination between your current provider, Meta, and WhatsTeam.


Before You Switch

1. Inform your current BSP: Some providers require advance notice before releasing a number. Check their documentation or contact their support team.
2. Export your templates: WhatsApp message templates are tied to the WhatsApp Business Account (WABA), not the BSP. If you are moving to a new WABA, you will need to recreate your templates.
3. Note your messaging limits: Your current messaging tier (1K, 10K, 100K, or unlimited) may or may not transfer depending on whether you keep the same WABA.
4. Back up conversation data: Active conversations and chat history are managed by the BSP. Export any data you need before initiating the switch.

Migration vs. Fresh Start


Recommendation: Whenever possible, migrate using the same WABA to preserve your messaging limits and template approvals. This is especially important for businesses with high daily message volumes.

Delete Number from Current WhatsApp Account

Before you can register your number on WhatsTeam, you must remove it from its current WhatsApp account. The process differs depending on whether your number is on the Cloud API or you plan to use Coexistence mode.

Cloud API Path

The Cloud API path involves completely removing the number from its current WhatsApp registration so it can be freshly registered on WhatsTeam.


Step 1: Access Meta Business Suite

1. Go to business.facebook.com and log in with your admin account.
2. Navigate to Settings in the left sidebar.
3. Click on WhatsApp Accounts under the Business Settings menu.


Step 2: Locate Your Phone Number

1. Select the WhatsApp Business Account that contains your phone number.
2. Click on the Phone Numbers tab.
3. Find the number you want to remove from this account.


Step 3: Delete the Phone Number

1. Click on the phone number to select it.
2. Click the Delete button (trash icon) next to the number.
3. Confirm the deletion when prompted.
4. Wait at least 5 minutes for Meta's systems to fully process the removal.


Warning: Deleting a phone number from a WABA is permanent. All message history, active conversations, and pending messages associated with that number will be lost. Make sure you have exported any necessary data before proceeding.

Step 4: Verify the Number Is Released

1. Go back to the Phone Numbers tab.
2. Confirm the number no longer appears in the list.
3. If the number still appears, wait a few more minutes and refresh the page.


Step 5: Clear the WhatsApp Mobile App (If Applicable)

If the number was also used on the WhatsApp or WhatsApp Business mobile app:

1. Open the WhatsApp app on your phone.
2. Go to Settings > Account > Delete my account.
3. Enter your phone number and confirm the deletion.
4. Uninstall the app to prevent automatic re-registration.


Coexistence Path

The Coexistence path allows you to keep using the WhatsApp Business mobile app on your phone while simultaneously connecting the same number to WhatsTeam through the Cloud API. This is ideal for businesses that want to maintain their existing WhatsApp presence while gaining API capabilities.


Step 1: Ensure You Are Using WhatsApp Business App

Coexistence only works with the WhatsApp Business app (green icon with a "B"), not the standard WhatsApp consumer app. If you are using the regular WhatsApp app, you must first migrate to the WhatsApp Business app.


Step 2: Disable Auto-Reply Features

Before connecting through Coexistence, disable all auto-reply features in your WhatsApp Business app:

1. Open the WhatsApp Business app.
2. Go to Settings > Business Tools > Away Message and turn it off.
3. Go to Settings > Business Tools > Greeting Message and turn it off.
4. Go to Settings > Business Tools > Quick Replies and review them (these can stay active but be aware they may conflict with API automations).

Step 3: Do Not Delete the Number

Unlike the Cloud API path, you should not delete the number from the mobile app. The number stays active on the app while you connect it to WhatsTeam through the Embedded Signup process.

Step 4: Proceed to WhatsTeam Signup

With the mobile app still active, proceed to the WhatsTeam signup process. During the Embedded Signup, select the Coexistence option when prompted. Detailed steps for this process are covered in our dedicated Coexistence guide.


Create a New WhatsApp Account

If you are starting fresh or your previous account cannot be recovered, you will need to create a new WhatsApp Business Account. There are two primary methods to do this through WhatsTeam.

Embedded Sign-Up Through WhatsTeam

The Embedded Signup (ES) flow is the fastest and most recommended method. It creates your Meta Business Account and WhatsApp Business Account in a single streamlined process directly within the WhatsTeam platform.


Step 1: Navigate to WhatsTeam Settings

1. Log in to your WhatsTeam account at whats.team.
2. Go to Settings > WhatsApp Connections.
3. Click the Connect a New Number button.

Step 2: Start the Embedded Signup

1. A Meta login window will appear.
2. Log in with your Facebook account credentials.
3. If you do not have a Meta Business Account, one will be created automatically during this process.


Step 3: Create or Select a Business Portfolio

1. Choose Create a new Business Portfolio if this is your first time, or select an existing one from the dropdown.
2. Enter your business name exactly as it appears on your legal documents.
3. Click Continue.


Step 4: Create a WhatsApp Business Account

1. Choose Create a new WhatsApp Business Account.
2. Enter a display name for your business (this is what customers will see).
3. Select your business category from the dropdown menu.
4. Click Continue.

Step 5: Add Your Phone Number

1. Enter the phone number you want to register.
2. Select your preferred verification method: SMS or Voice Call.
3. Enter the verification code when you receive it.
4. Click Verify.


Step 6: Complete the Setup

1. Review all the information you provided.
2. Accept the terms and conditions.
3. Click Finish Setup.
4. You will be redirected back to the WhatsTeam dashboard where your new connection will appear.


Via Meta Business Portfolio

If you prefer to create your WhatsApp Business Account directly through Meta before connecting to WhatsTeam, you can do so via the Meta Business Suite.


Step 1: Access Meta Business Suite

1. Go to business.facebook.com.
2. Log in with your Facebook admin account.
3. Navigate to Settings > Business Settings.

Step 2: Create a WhatsApp Business Account

1. In the left sidebar, click Accounts > WhatsApp Accounts.
2. Click the Add button.
3. Fill in the required details: account name, currency, and time zone.
4. Click Create.


Step 3: Add a Phone Number

1. Inside your new WABA, go to the Phone Numbers tab.
2. Click Add Phone Number.
3. Enter the number and verify it via SMS or voice call.

Step 4: Share Access with WhatsTeam

1. In your WABA settings, go to the Partner or Solution Provider section.
2. Add WhatsTeam as a solution provider using the WhatsTeam Business Manager ID.
3. Grant the required permissions (manage phone numbers, manage templates, send messages).

Step 5: Connect in WhatsTeam

1. Return to the WhatsTeam dashboard.
2. Go to Settings > WhatsApp Connections.
3. Click Connect Existing Account.
4. Select the WABA you just created from the list.


Link WhatsApp Business Account to Portfolio (Coexistence)

When using Coexistence mode, you may need to link your WhatsApp Business Account to a specific Meta Business Portfolio. This step ensures that the WABA is properly associated with your business identity and that billing, permissions, and compliance are correctly configured.


When Is This Required?

• You created a WABA through Embedded Signup and need to assign it to a different portfolio.
• You are setting up Coexistence and Meta requires the WABA to be under a verified portfolio.
• Your business has multiple portfolios and you need to consolidate your WhatsApp accounts.

How to Link

1. Open Meta Business Suite and go to Business Settings.
2. Navigate to Accounts > WhatsApp Accounts.
3. Select the WABA you want to link.
4. Click Assign Partner or Add People/Partners.
5. Enter the Business Portfolio ID where you want the WABA to reside.
6. Confirm the assignment and wait for Meta to process the change (this can take up to 24 hours).


Verify the Link

After linking, verify that:

• The WABA appears under the correct portfolio in Meta Business Settings.
• All phone numbers within the WABA are visible and active.
• Template approvals and messaging limits are intact.
• WhatsTeam can still access the WABA through the connection.


Register Number Again Under New Account

In some cases, you may need to register a phone number that was previously used on a different WhatsApp account. This process requires careful execution to avoid errors.


Prerequisites

Before attempting to re-register a number:

1. Ensure the number is fully deleted from any previous WhatsApp account (Cloud API, On-Premises API, or mobile app).
2. Wait the required cooling period. After deletion, Meta enforces a waiting period that can range from a few minutes to 24 hours depending on the account history.
3. Verify number ownership. You must be able to receive SMS or voice calls on the number during the verification step.

Step-by-Step Re-Registration

Step 1: Confirm Deletion

Go to Meta Business Suite and verify the number does not appear under any WhatsApp Business Account. If it still shows up, complete the deletion process described earlier in this guide.


Step 2: Initiate Fresh Signup on WhatsTeam

1. Log in to your WhatsTeam account.
2. Navigate to Settings > WhatsApp Connections.
3. Click Connect a New Number.
4. Follow the Embedded Signup flow as described in the "Create a New WhatsApp Account" section above.

Step 3: Verify the Number

1. When prompted, enter the phone number.
2. Select SMS or Voice Call for verification.
3. Enter the OTP code you receive.
4. If the code fails to arrive, wait 60 seconds and try the alternative verification method.


Step 4: Confirm Successful Registration

1. After verification, the number should appear in your WhatsTeam dashboard with an Active status.
2. Send a test message to confirm the connection is working properly.
3. If the registration fails with an error about the number still being in use, wait an additional 30 minutes and try again.


Frequently Asked Questions

How long does it take to release a number from another BSP?

The release process is usually instant once you delete the number from the previous WABA. However, in some cases, Meta's systems may take up to 24 hours to fully propagate the change. If you still encounter issues after 24 hours, contact WhatsTeam support at support@whats.team.

Can I use the same number on both WhatsApp Business App and Cloud API?

Yes, this is exactly what Coexistence mode enables. You can keep using the WhatsApp Business mobile app while also sending and receiving messages through WhatsTeam's API. However, there are some feature limitations in Coexistence mode. Refer to our dedicated Coexistence guide for full details.

What happens to my message templates when I switch BSPs?

If you keep the same WABA, your approved templates will be preserved. If you create a new WABA, you will need to submit all templates for approval again, which can take up to 24 hours per template.

Will I lose my messaging limit tier when re-registering?

If you delete a number from a WABA and register it under a new WABA, your messaging limit resets to the default tier (typically 1,000 business-initiated conversations per 24 hours). To preserve your messaging tier, migrate the number within the same WABA whenever possible.

I keep getting "Code couldn't be sent" during verification. What should I do?

This error usually indicates a temporary issue with Meta's verification service. Try the following:

1. Wait 5-10 minutes and try again.
2. Switch between SMS and voice call verification methods.
3. Ensure the number is not on a VoIP service that blocks short codes.
4. Check your browser's developer console for additional error details.
5. If the problem persists, contact WhatsTeam support with your browser console logs.

My number shows as "Pending" after signup. Is this normal?

Yes, a brief "Pending" status is normal while Meta processes the registration. This typically resolves within 5-15 minutes. If the status remains "Pending" for more than an hour, try refreshing your connection in the WhatsTeam dashboard or contact support.