Number Registration

Are you having difficulties registering your phone number for WhatsApp Business API? See the below information on how to troubleshoot number registration.

When I trigger the code I get an error...

The #1 reason why number registration will fail is because there is an active WhatsApp installation associated with the number. i.e.: The phone number is registered with a non-enterprise account (either WhatsApp or WhatsApp for Business).

The old account will need to be fully deleted to make this phone number available to register.

Uninstalling the app from a device is not sufficient, any previous WhatsApp account must be fully deleted.

To delete your account

  1. Open WhatsApp.

  2. Tap More options > Settings > Account > Delete my account.

  3. Enter your phone number in full international format and tap DELETE MY ACCOUNT.

  4. Select a reason for why you're deleting your account in the dropdown.

  5. Tap DELETE MY ACCOUNT.

For more information on how to delete your account, please follow this guide.

How to check if a number is linked to WhatsApp

You can test to see if a WhatsApp number is linked to an active non-enterprise account. Simply send a test message to the number in question. If the number is Sent (1 tick) or Delivered (2 ticks) it means that there is still a non-enterprise account linked.

Registration on timeout...

Facebook does not permit multiple registration attempts in quick succession. Please allow a 2 mins timeout between registration attempts. After 3 successive registration attempts, Facebook will initiate a 2 hour timeout period.

Common error responses from Facebook

Timeout This means that Facebook has put the registration on "timeout".

{
"data": {
"code": 1005,
"details": "Please wait 1 hour(s) 38 minute(s) before trying again",
"title": "Access denied"
},
"meta": {
"developer_message": "Trigger registration error",
"http_code": 403,
"success": false
}
}

Solution: Wait until the timeout phase has lapsed and try again.

Number linked to non-enterprise account, biz_link_error This means the previous WhatsApp installation was uninstalled from the device but not fully deleted.

{
"data": {
"code": 1005,
"details": "Unknown error: biz_link_info_invalid_payload",
"title": "Access denied"
},
"meta": {
"developer_message": "Trigger registration error",
"http_code": 403,
"success": false
}
}

Solution: Reinstall WhatsApp and then fully delete it.

Number linked to active non-enterprise account:

{
"data": {
"code": 1005,
"details": "This number has not been approved for an enterprise. Please contact support for more info.",
"title": "Access denied"
},
"meta": {
"developer_message": "Trigger registration error",
"http_code": 403,
"success": false
}
}

Solution: Fully delete WhatsApp from the device.

Error verifying the number

{
"data": {
"code": 1005,
"details": "There was an error verifying this phone number.Please try again later.",
"title": "Access denied"
},
"meta": {
"developer_message": "Trigger registration error",
"http_code": 403,
"success": false
}
}

This means that the registration has been locked. In the case, please contact support and we will reset the registration state.

Ongoing number registration issues

360Dialog is not responsible for issues relating to number registration. It is the responsibility of the phone number owner to make sure that there is no non-enterprise account (active or inactive) linked to the number at the time of registration to the WhatsApp Business API. The 360Dialog support team also have the right to refuse number registration troubleshooting for numbers that have failed multiple registration attempts.