Seeing an error such as this one indicates that this phone number has been used with another WhatsApp Business API provider in the past. If this is the case, to resolve this, you should follow the onboarding flow for “migrating an existing WhatsApp phone number from my current provider”, being sure to exit the WhatsApp embedded onboarding process after Step 2.
​

If this phone number has not been used with another WhatsApp Business API provider, this may indicate that the phone number has been used in an Android, iPhone, or Business application version of WhatsApp. You should follow steps 3 to 7 under the Learn more link of the error to disconnect the number from that WhatsApp account, then you should be able to retry our onboarding process successfully. Chat history will be lost on disconnection here so be sure to change it beforehand.
​

If neither of these options are the case for you then contact us and we can try manually connecting WhatsApp for you if you share with us your WhatsApp account ID and phone number.

You can check for this code in the console of your browser while going through the sign up process. If this error was during the phone number migration set up path, it could be that the migration has successfully occurred. You may instead be able to follow the “I’m integrating WhatsApp for the first time” set up path instead, selecting the new WhatsApp accounts that were created during the migration set up.

If this still fails, we can try manually connecting WhatsApp.

If you are unable to save your business profile settings and are receiving a 500 error back in your browser console, it's likely a validation error returned to us by WhatsApp on the profile setting you are trying to update. There are some details on the restrictions such as maximum number of characters here.

Check if number is fully verified by Meta, it has to be before you can connect it to Intercom so knowing that its successfully connected is important here. The number might already be in use with the WhatsApp Business app. In that case, you need to delete it from your app. If both of these checks fail then contact us and we'll try manually connect the number.

Contact Intercom customer support for help with this error.

Ensure that your whatsapp number is connected from the app store installation page. If this fails, contact Intercom Customer Support.

Check if number is fully verified by Meta, it has to be before you can connect it to Intercom. Contact customer support if this doesn't resolve the issue.

This error appears to be related to words that are not allowed to be written on Facebook in the title or description. It might be related to the values being entered into the fields. This Facebook developers post might be worth checking out.

Typically see this for numbers provisioned by third parties. Attempting the migration onboarding steps here will help but if not, contact our Customer Support.

This is an error which requires you to contact Meta Support in order to resolve.

Make sure the code which is shown to you is a WhatsApp account ID. Facebook does have requirements that must be met before migrating to Whatsapp Business Account. You can find them here.

This is usually flagged by Meta due to any phone migration error. Check the Meta docs for more details.

If you're running into this error, try following the steps below in order to connect your WhatsApp account.

This is the window that you should close 👇

Then: