Operações disponíveis
Provision WhatsApp deployment
This API request provisions a WhatsApp cluster. Once provisioned, the cluster progresses through the following deployment stages: INITIALIZING, CREATING_CLUSTER and CLUSTER_CREATED. When the CLUSTER_CREATED stage is reached an OTP voice call or SMS is sent to the specified number and the deployment status becomes CODE_SENT. When the OTP is received, call the Verify API to complete the process.
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
44The international dialing code of the number being provisioned
8675309The WhatsApp number being provisioned.
AbCdEFGHiJK123456The certificate, which you can retrieve from your WhatsApp Business dashboard.
Note this value is refreshed whenever you click the View button.
smsThe method for delivering the OTP
smsvoice123456789123WABA ID of the WhatsApp Number
123456Required if you previously set a PIN when creating a WhatsApp number.
Exemplo Solicitação
{
"country_code": "44",
"number": "8675309",
"vname_certificate": "AbCdEFGHiJK123456",
"method": "sms",
"waba_id": "123456789123",
"pin": "123456"
}aaaaaaaa-bbbb-cccc-dddd-0123456789abThe Deployment id
The WhatsApp Business Account (WABA) ID of the WhatsApp number
44The international dialing code of the deployment e.g. 44 for the United Kingdom.
7700900000The phone number of the deployment (minus the international dialing code) e.g. 7700900000
abcd1234The API key associated with the deployment.
The current status of the deployment
INITIALIZINGThe current status of the deployment.
INITIALIZINGCREATING_CLUSTERCLUSTER_CREATEDCODE_SENTWRONG_CODECODE_VERIFIEDFINALIZINGREADYERRORDELETINGDELETEDInitializing deploymentDescription of the deployment status e.g. Invalid vname certificate
Exemplo Resposta
{
"deployment_id": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
"waba_id": "string",
"country_code": "44",
"number": "7700900000",
"api_key": "abcd1234",
"current_state": {
"title": "INITIALIZING",
"detail": "Initializing deployment"
}
}Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
aaaaaaaa-bbbb-cccc-dddd-0123456789abThe Deployment id
The WhatsApp Business Account (WABA) ID of the WhatsApp number
44The international dialing code of the deployment e.g. 44 for the United Kingdom.
7700900000The phone number of the deployment (minus the international dialing code) e.g. 7700900000
abcd1234The API key associated with the deployment.
The current status of the deployment
INITIALIZINGThe current status of the deployment.
INITIALIZINGCREATING_CLUSTERCLUSTER_CREATEDCODE_SENTWRONG_CODECODE_VERIFIEDFINALIZINGREADYERRORDELETINGDELETEDInitializing deploymentDescription of the deployment status e.g. Invalid vname certificate
Exemplo Resposta
{
"deployment_id": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
"waba_id": "string",
"country_code": "44",
"number": "7700900000",
"api_key": "abcd1234",
"current_state": {
"title": "INITIALIZING",
"detail": "Initializing deployment"
}
}Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
Operações disponíveis
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
smssmsvoiceExemplo Solicitação
{
"method": "sms"
}Verify OTP
When a code is successfully verified, WhatsApp Manager will move the number from a CODE_VERIFIED state to a FINALIZING state where additional checks are made and it is assigned to your API Key. Once this is complete it will enter a READY state and the number is ready to use.
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
674639OTP being submitted for verification
Exemplo Solicitação
{
"code": "674639"
}Operações disponíveis
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
1139about your businessText to display in your profile's About section - max 139 characters.
1256123 main streetYour business address - max 256 characters.
1256your business descriptiona description of your business - max 256 characters
1128you@example.comYour business' email - max 128 characters
Food and GroceryYour business' industry - must be recognized by WhatsApp.
AutomotiveBeauty, Spa and SalonClothing and ApparelEducationEntertainmentEvent Planning and ServiceFinance and BankingFood and GroceryPublic ServiceHotel and LodgingMedical and HealthNon-profitProfessional ServicesShopping and RetailTravel and TransportationRestaurantOtherYour business' websites maximum of 2 websites, max website length: 256
Exemplo Resposta
{
"about": "about your business",
"address": "123 main street",
"description": "your business description",
"email": "you@example.com",
"vertical": "Food and Grocery",
"websites": [
"https://example.com"
]
}Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
1139about your businessText to display in your profile's About section - max 139 characters.
1256123 main streetYour business address - max 256 characters.
1256your business descriptiona description of your business - max 256 characters
1128you@example.comYour business' email - max 128 characters
Food and GroceryYour business' industry - must be recognized by WhatsApp.
AutomotiveBeauty, Spa and SalonClothing and ApparelEducationEntertainmentEvent Planning and ServiceFinance and BankingFood and GroceryPublic ServiceHotel and LodgingMedical and HealthNon-profitProfessional ServicesShopping and RetailTravel and TransportationRestaurantOtherYour business' websites maximum of 2 websites, max website length: 256
Exemplo Solicitação
{
"about": "about your business",
"address": "123 main street",
"description": "your business description",
"email": "you@example.com",
"vertical": "Food and Grocery",
"websites": [
"https://example.com"
]
}1139about your businessText to display in your profile's About section - max 139 characters.
1256123 main streetYour business address - max 256 characters.
1256your business descriptiona description of your business - max 256 characters
1128you@example.comYour business' email - max 128 characters
Food and GroceryYour business' industry - must be recognized by WhatsApp.
AutomotiveBeauty, Spa and SalonClothing and ApparelEducationEntertainmentEvent Planning and ServiceFinance and BankingFood and GroceryPublic ServiceHotel and LodgingMedical and HealthNon-profitProfessional ServicesShopping and RetailTravel and TransportationRestaurantOtherYour business' websites maximum of 2 websites, max website length: 256
Exemplo Resposta
{
"about": "about your business",
"address": "123 main street",
"description": "your business description",
"email": "you@example.com",
"vertical": "Food and Grocery",
"websites": [
"https://example.com"
]
}Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
https://www.example.com/img.pngURL pointing to a .png or .jpg. Image must be minimum 192px. max 640px x 640px. max 5MB.
Exemplo Solicitação
{
"image_url": "https://www.example.com/img.png"
}Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
your-publisher-nameThe name of the publisher of the third-party stickerpack.
your-sticker-pack-nameThe name of the stickerpack.
https://itunes.apple.com/app/id3133333The link to the stickerpack in the Apple iOS App Store. The link follows the format https://itunes.apple.com/app/idXXXXXXXXX. To get your App Store link, refer to the instructions at https://stackoverflow.com/questions/4137426/get-itunes-link-for-app-before-submitting
https://play.google.com/store/apps/details?id=com.exampleThe link to the stickerpack in the Google Play store. The link follows the format https://play.google.com/store/apps/details?id=com.example where com.example is your app's package name.
Exemplo Solicitação
{
"publisher": "your-publisher-name",
"name": "your-sticker-pack-name",
"ios_app_store_link": "https://itunes.apple.com/app/id3133333",
"android_app_store_link": "https://play.google.com/store/apps/details?id=com.example"
}Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
sticker-pack-namesticker-pack-publisherhttps://play.google.com/store/apps/details?id=com.examplehttps://itunes.apple.com/app/id3133333Exemplo Resposta
{
"stickerpacks": [
{
"name": "sticker-pack-name",
"publisher": "sticker-pack-publisher",
"android_app_store_link": "https://play.google.com/store/apps/details?id=com.example",
"ios_app_store_link": "https://itunes.apple.com/app/id3133333"
}
]
}Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
idThe ID for the sticker media.
[
"🐥",
"😃"
]An array of the emojis included in the stickerpack.
Exemplo Solicitação
{
"image_data_id": "id",
"emojis": [
"🐥",
"😃"
]
}Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
Autenticação
| Chave | Descrição | Onde | Exemplo |
|---|---|---|---|
| Authorization | Seu token JSON da Web. | Headers | Bearer <JWT> |
Erros
A seguir, apresentamos uma lista não exaustiva de códigos de erro que podem ocorrer durante o uso desta API.
Esses códigos são adicionais aos que constam em nosso site códigos de erro genéricos.
| Código | Informações |
|---|---|
| number-in-use | Descrição Cannot use number because it's already in use by another deployment. Resolução Use the existing deployment. |
| invalid-json | Descrição The request body did not contain valid JSON Resolução Send a JSON request body, including a Content-Type header of application/json |
| unprocessable | Descrição Parameters were valid JSON but something was missing or wrongly formatted Resolução Fix the incorrect request parameters and try again |
| unprocessable-profile-update | Descrição Parameters were valid JSON but something was missing or wrongly formatted Resolução Fix the incorrect request parameters and try again |
| throttled | Descrição Too many requests have been made on this endpoint Resolução Wait a moment and try again |
| verification-failed | Descrição Verification step failed. Either because the provided code was incorrect or because too many attempts have been made Resolução Try again with the correct OTP, or call resend-otp |
| conflict-deployment-state | Descrição Deployment could not be modified because it is currently in a transitional state. Resolução If the deployment is transitioning into the state you want it in no action is required. If the state is |
| conflict-resend-otp | Descrição Could not resend OTP because the current state of the deployment did not allow it Resolução The deployment has either already finished, or is in an error state (in which case you should delete it and run it again). |