WABA Profile Info
This document describes how to manage your WABA Profile Info
In the 360dialog Client Hub
You can update your WABA profile information in the 360dialog Client Hub.
In the API
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 /whatsapp_business_profile?fields=about,address,description,email,profile_picture_url,websites,vertical'
Request Body
address
string
Address of the business. Maximum of 256 characters
description
String
Description of business. Maximum of 512 characters.
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 created.
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.
A successful response includes the profile
object containing the business profile data.
{
"data": [{
"about": "ABOUT",
"address": "ADDRESS",
"description": "DESCRIPTION",
"email": "EMAIL",
"messaging_product": "whatsapp",
"profile_picture_url": "https://URL",
"websites": [
"https://WEBSITE-1",
"https://WEBSITE-2"
],
"vertical": "INDUSTRY",
}]
}
Update Business Profile Information
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 which changes only the necessary fields.
You can use the profile_picture_handle parameter to update the profile photo. HANDLE_OF_PROFILE_PICTURE is 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
vertical
array
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
URLs associated with the business.
string
Email address (in valid email format) to contact the business. Maximum of 128 characters
description
string
Description of the business. Max 512 characters.
address
string
Address of the business. Maximum of 256 characters
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 and essentially large files to the Cloud API. Once uploaded, you can use a file's handle fetched in step 2 to update your profile_picture_handle
.
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
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.
Please review the official WhatsApp docs for the full list of acceptable parameter values.
Last updated
Was this helpful?