Step 1: Register a number
This API allows you to add a number to your account, in order to use "Step 2: Create account" API.
In order to use the number, we must verify the number. you can request verification code by SMS or phone call.
Important Remarks
The number you wish to register must not be installed on any WhatsApp phone. it must be a new number.
Do not attempt to request a code more than 3 times or Facebook might block the request for 1 hour to avoid abuse.
If you want to use phone call, please make sure you are able to dial the number yourself and the number does not have IVR operator. make sure that a call can go through smoothly and you are able to answer the phone call. the phone call will be received from a strange country code or unknown number make sure those numbers are not blocked on your phone.
Registered phone numbers will wait in your account for 90 days. During this time you must create an account with that number. if you did not create an account with that phone number, after 90 days you will have to re-register the number again.
You can register and keep up to 500 numbers in your account waiting to be connected.
This process is a two parts process.
Part 1 : you register the number by asking the code for verification. after submitting the registerNumber API, you will get SMS or a phone call with 6 digits verification code.
Part 2: you verify the code you received. now the number is verified and belongs to you.
Part 1
Settings:
URL | https://partners.99digital.co.il/api/whatsapp/registerNumber |
Method | JSON via POST |
Header | Authorization: Bearer {{access_token}} *The access_token can be received from settings->get access token API. |
Body:
Parameter | Description / Example | Maximum length | Remarks | mandatory | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
The whatsapp number you wish to register | use country code and the following numbers. no + for example: 972501234567 | yes | ||||||||||||||||||||||
method | 1 for SMS 2 for phone call | 1 | If both options are available for your number, we recommend using SMS, as its more stable way and not based on answering a phone call | yes | ||||||||||||||||||||
language |
| 1 | the language of the SMS / voice call to get the verification code. (For SMS, in some cases, it will be sent in English regardless of what was selected in language). | Yes | ||||||||||||||||||||
comment | A free text for you to use along with the number registration | 100 | numbers and letters only | No |
Response:
{
"status": "OK",
"whatsapp": "972501234567",
"reason": 1
}
Response-Explain:
Parameter | Description | ||||||||||||||||||||||||
status | OK or FAIL "OK" means the SMS or phone call has been sent. "Fail" means error. | ||||||||||||||||||||||||
The whatsapp number | |||||||||||||||||||||||||
reason | 'reason' is the status explanation in case of FAIL
|
Part 2
Settings:
URL | |
Method | JSON via POST |
Header | Authorization: Bearer {{access_token}} *The access_token can be received from settings->get access token API. |
Body:
Parameter | Description / Example | Maximum length | Remarks | mandatory |
|---|---|---|---|---|
The same WhatsApp number you used for verify the code on registerNumber API | use country code and the following numbers. no + for example: 972501234567 | yes | ||
code | 6 digits code | 6 | 6 digits numbers only. remove any hyphens if the code received by SMS contains any | yes |
Response:
{
"status": "OK",
"whatsapp": "972501234567",
"expiration": "1737109621",
"reason": 1
}
Response-Explain:
Parameter | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
status | OK or FAIL "OK" means verification successful "Fail" means error. | ||||||||||||||||||
The whatsapp number | |||||||||||||||||||
expiration | The expiration timestamp, 90 days from now. | ||||||||||||||||||
reason | 'reason' is the status explanation in case of FAIL
|