Error starting WhatsApp Business Mobile Linking
Discover solutions to troubleshoot and resolve issues when starting WhatsApp Business Mobile Linking effectively.
Table of Contents
Symptom or Need
When attempting to register or link a phone number from Meta Business Suite (or Business Manager), the system displays the error: "Failed to register the number; invalid account linking. It could be due to a non-approved or pending WhatsApp Business Account." This prevents the activation of the WhatsApp connector for chat operations.
Context / Scenarios
Failure to register a number in Meta Business Suite. The system blocks the linking process due to an unapproved or pending WhatsApp account.
Response / Solution
1. Initial Operational Validations
It is necessary to document and verify the following service details:
- Operation Name and Operation Server.
- Percentage of Impact and Downtime Start Date.
- Affected Chat Routing.
- Affected WhatsApp Connector Number and Chat Server.
2. Resolution Steps based on Error Status
A. Business Verification
Meta restricts number linking if the business account has not completed the verification process.
- Go to Business Settings.
- Select Business Info.
- Check the "Verification Status". If it appears as "Not Started" or "Pending," upload the company's legal documents.
B. Acceptance of Terms and Conditions
In new accounts, there may be contracts or commerce policies that have not been formally accepted within Business Manager.
- Review notifications in the WhatsApp Manager dashboard within Meta.
- Look for a banner requesting to "Accept Terms" or commerce policies.
C. WhatsApp Business Account (WABA) Status
The WhatsApp Business Account (WABA) itself may be in a "Pending Review" state.
- In the WhatsApp Manager, verify that the account status appears in green (Approved/Active).
- If the status is "Draft" or "Pending Review," you must wait for Meta's approval before attempting registration.
D. Linking a Payment Method
Meta requires the WhatsApp account to be linked to a Credit Line or a valid payment method, even when operating within the free messaging tier.
- Go to the Payments section in Business Settings.
- Ensure the WABA has a valid payment method assigned.
E. Verify Number Ownership
- If the number was previously used in a WhatsApp App (standard or Business) on a mobile device, it must be completely deleted from that application before attempting registration in Business Manager.
Possible Causes
This error occurs when there are administrative or technical blocks within Meta's infrastructure. The main identified causes are:
- Lack of Verification: The Business Manager account has not completed the legal verification process.
- Pending Terms: Commerce policies or contracts awaiting formal acceptance.
- WABA Status: The WhatsApp Business Account is in "Draft" or "Pending Review" status.
- Ownership Conflicts: The number is still linked to a mobile app (Android/iOS) version of WhatsApp.
- Billing: Absence of a payment method associated with the WhatsApp account.