Common official WhatsApp connection errors and fixes

When a connection fails, the dashboard shows Meta's reason and the fix. These are the most common cases:

During Meta's window

• The number is still registered in a WhatsApp app (2494064): to keep the app, choose Keep my WhatsApp Business app. If you were already on the coexistence path, you picked "Add a new number"; retry and pick your existing number.
• The number is not on the WhatsApp Business app (2655095): move the number to WhatsApp Business first, or connect it as a new number.
• Pairing with the phone did not finish (4563001 / 4563004): update WhatsApp Business, keep the phone online and enter the new code as soon as it appears.
• The account is shared with another provider (2655093): remove the old partner in Meta Business Suite, then retry.
• The number is linked to Automatic Events (3441061): turn off Automatic Events for this number in Meta Business Suite.
• Meta's verification is temporarily down (2388091): wait one hour, then retry.

After connecting: "Activation incomplete"

The message appears on the connect page with a Retry activation button:

• The number is still in use on WhatsApp: delete the account in the app (Settings → Account → Delete my account), wait 3 minutes, then retry. Do not do this if you want coexistence.
• Two-step verification is on (133005): turn it off in the app (Settings → Account → Two-step verification), retry, then turn it back on.
• Too many attempts (133016): wait a full 72 hours, then try once.
• A step is waiting in the WhatsApp Business app (133010 with coexistence): open the app → "Connect to the Business Platform" → Confirm → enter the code, then retry the same day.

What happens next?

When a retry works, the WhatsApp card turns Connected (Official). If the same error keeps coming back, send a screenshot of the message to support and we will finish it with you.