WABA Profile Info

There are multiple ways to update and check the profile info.

In the 360Dialog Client Hub

The client can update their WABA profile information in their 360Dialog Client Hub.

Users can manage their Profile Info on the WABA manager page in the Profile section.

In the 360Dialog Partner Hub

The partners can update the client´s WABA profile information in their 360Dialog Partner Hub.

Users can manage the client´s Profile Info on the WABA manager page in the Profile section.

Using the API

You can use the following endpoints to update the WhatsApp account's photo and business profile information.

Every request to the WhatsApp API needs to be authorized using API Key authentication. Adding the D360-API-KEY header with your API Key as a value will permit you.

POST https://waba-v2.360dialog.io/whatsapp_business_profile

Use the endpoint to configure the following business profile settings: business address, business description, email for business contact, business industry, and business website.

If you only need to update a couple of fields with new information, you can make a request that changes only the necessary fields. You can use the profile_picture_handle parameter to update the profile photo.

HANDLE_OF_PROFILE_PICTURE is the URL obtained from the Resumable Upload API.

Request example

curl -X POST 'https://waba-v2.360dialog.io/whatsapp_business_profile' -H 'D360-API-KEY: YOUR_API_KEY' -d '{ "messaging_product": "whatsapp", "about": "ABOUT", "address": "ADDRESS", "description": "DESCRIPTION", "vertical": "INDUSTRY", "email": "EMAIL", "websites": [ "https://WEBSITE-1", "https://WEBSITE-2" ], "profile_picture_handle": "HANDLE_OF_PROFILE_PICTURE" }'

Request Body

Name
Type
Description

address

string

Address of the business. Maximum of 256 characters.

description

string

Description of the business. Maximum of 512 characters.

email

string

Email address (in valid email format) to contact the business. Maximum of 128 characters.

vertical

string

Industry of the business. Must be one of these accepted values: UNDEFINED / OTHER / AUTO / BEAUTY / APPAREL / EDU / ENTERTAIN / EVENT_PLAN / FINANCE / GROCERY / GOVT / HOTEL / HEALTH / NONPROFIT / PROF_SERVICES / RETAIL / TRAVEL / RESTAURANT / NOT_A_BIZ

The business vertical cannot be set back to an empty value after it is create

websites

array of strings

URLs (including http:// or https://) associated with the business (e.g., website, Facebook Page, Instagram). Maximum of 2 websites with a maximum of 256 characters each.

about

string

Optional.

The business's About text. This text appears in the business's profile, beneath its profile image, phone number, and contact buttons.

*String cannot be empty.

*Strings must be between 1 and 139 characters.

*Rendered emojis are supported however their unicode values are not.

*Emoji unicode values must be Java- or JavaScript-escape encoded.

*Hyperlinks can be included but will not render as clickable links.

*Markdown is not supported.

{
    // Response
}

Resumable Upload API for Profile Pictures

The Resumable Upload API allows you to upload profile pictures to the Cloud API. Once uploaded, you can use a file's handle to update your profile picture handle.

Please note that to access and utilize the Resumable Upload API, it is mandatory to include the 360dialog-API-key within the header.

Step 1: Create a Session

Send a POST request that describes your file to the endpoint /uploads.Upon success, an upload session ID will be returned that you can use in the next step to initiate the upload.

Request Syntax

POST-https://waba-v2.360dialog.io/uploads
  &file_length={file-length}
  &file_type={file-type}

​Parameters

Parameter
Description

file_length int64

The file length in bytes

file_type RegexParam

The MIME type of the file to be uploaded

Response

  • {id} — Upload session ID.

Sample Request

curl -X POST \
 "https://waba-v2.360dialog.io/uploads?file_length=109981&file_type=image/png"

Sample Response

{
    "id": "upload:MTphd..."
}

Step 2: Initiate Upload

Initiate the upload session by sending a POST request and append your upload session {id} along with the authentication header. Upon success, a file handle {h},is returned that you can then use the {h} value to update your profile picture.

Request Syntax

POST waba-v2.360dialog.io/{session_id}  
--header 'file_offset: 0'
--data-binary @{file-name}

Placeholder Values

  • {session_id} — Upload session ID returned in step 1.

  • {file-name} — Name of the file to upload.

Response

{
  "h": "{h}"
}

Response property values:

  • {h} — The uploaded file's file handle

Sample Request

curl -X POST \
 "https://waba-v2.360dialog.io/upload:MTphd..." \

Sample Response

{
    "h": "2:c2FtcGxl..."
} 

You can then use the Update Business Profile information endpoint to update the profile photo using the {h} value.

Retrieve Business Profile information

GET https://waba-v2.360dialog.io/whatsapp_business_profile?fields=about,address,description,email,profile_picture_url,websites,vertical

Use this edge to retrieve the information available in the Business Profile: business address, business description, email for business contact, business industry, and business website.

Request example

GET https://waba-v2.360dialog.io/whatsapp_business_profile?fields=about,address,description,email,profile_picture_url,websites,vertical'

Request Body

Name
Type
Description

address

string

Adress of the business. Maximum of 256 characters.

description

string

Description of business. Maximum of 512 characters.

vertical

string

Industry of the business. Must be one of these accepted values: UNDEFINED / OTHER / AUTO / BEAUTY / APPAREL / EDU / ENTERTAIN / EVENT_PLAN / FINANCE / GROCERY / GOVT / HOTEL / HEALTH / NONPROFIT / PROF_SERVICES / RETAIL / TRAVEL / RESTAURANT / NOT_A_BIZ

The business vertical cannot be set back to an empty value after it is create

email

string

Email address (in valid email format) to contact the business. Maximum of 128 characters.

websites

array of strings

URLs (including http:// or https://) associated with the business (e.g., website, Facebook Page, Instagram). Maximum of 2 websites with a maximum of 256 characters each.

A successful response includes the profile object containing the business profile data.

{
  "data": [{
    "messaging_product": "whatsapp",
    "address": "ADDRESS",
    "description": "DESCRIPTION",
    "vertical": "INDUSTRY",
    "email": "EMAIL",
    "websites": [
       "https://WEBSITE-1",
       "https://WEBSITE-2"
     ],
     "profile_picture_url": PROFILE_PICTURE_HANDLE
  }]
}

Last updated

Was this helpful?