Graph API Version

    Whats App Business Phone Number Whatsapp Business Profile

    Reading

    Get a WhatsApp Business Phone Number's business profile data.

    Requirements

    TypeDescription

    Access Tokens

    User, System User, or Business Integration System User

    Permissions

    whatsapp_business_management

    Example

    Graph API Explorer
    GET /v23.0/{whats-app-business-phone-number-id}/whatsapp_business_profile HTTP/1.1
    Host: graph.facebook.com
    /* PHP SDK v5.0.0 */
    /* make the API call */
    try {
      // Returns a `Facebook\FacebookResponse` object
      $response = $fb->get(
        '/{whats-app-business-phone-number-id}/whatsapp_business_profile',
        '{access-token}'
      );
    } catch(Facebook\Exceptions\FacebookResponseException $e) {
      echo 'Graph returned an error: ' . $e->getMessage();
      exit;
    } catch(Facebook\Exceptions\FacebookSDKException $e) {
      echo 'Facebook SDK returned an error: ' . $e->getMessage();
      exit;
    }
    $graphNode = $response->getGraphNode();
    /* handle the result */
    /* make the API call */
    FB.api(
        "/{whats-app-business-phone-number-id}/whatsapp_business_profile",
        function (response) {
          if (response && !response.error) {
            /* handle the result */
          }
        }
    );
    /* make the API call */
    new GraphRequest(
        AccessToken.getCurrentAccessToken(),
        "/{whats-app-business-phone-number-id}/whatsapp_business_profile",
        null,
        HttpMethod.GET,
        new GraphRequest.Callback() {
            public void onCompleted(GraphResponse response) {
                /* handle the result */
            }
        }
    ).executeAsync();
    /* make the API call */
    FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                                   initWithGraphPath:@"/{whats-app-business-phone-number-id}/whatsapp_business_profile"
                                          parameters:params
                                          HTTPMethod:@"GET"];
    [request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                          id result,
                                          NSError *error) {
        // Handle the result
    }];
    If you want to learn how to use the Graph API, read our Using Graph API guide.

    Parameters

    This endpoint doesn't have any parameters.

    Fields

    Reading from this edge will return a JSON formatted result:

    { "data": [], "paging": {} }

    paging

    For more details about pagination, see the Graph API guide.

    Error Codes

    ErrorDescription
    131031Business Account locked
    100Invalid parameter
    131000Something went wrong
    80008There have been too many calls to this WhatsApp Business account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
    104Incorrect signature
    133010The account is not registered
    131057Business Account is in maintenance mode
    190Invalid OAuth 2.0 Access Token
    200Permissions error
    102Session key invalid or no longer valid

    Creating

    You can't perform this operation on this endpoint.

    Updating

    You can update a WhatsAppBusinessProfileSanitized by making a POST request to /{whats_app_business_phone_number_id}/whatsapp_business_profile.

    Requirements

    TypeDescription

    Access Tokens

    User, System User, or Business Integration System User

    Permissions

    whatsapp_business_management

    Parameters

    ParameterDescription
    about
    string

    The business's About text.

    • 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.

    Maximum 139 characters.

    address
    string

    Business address. Maximum 256 characters.

    description
    string

    Business description.

    • 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.

    Maximum 512 characters.

    email
    string

    Business email address. Must be in valid email format. Maximum 128 characters.

    messaging_product
    enum {WHATSAPP}

    Set to whatsapp.

    Required
    profile_picture_handle
    string

    Profile picture media asset handle, generated via the Resumable Upload API.

    vertical
    enum {OTHER, AUTO, BEAUTY, APPAREL, EDU, ENTERTAIN, EVENT_PLAN, FINANCE, GROCERY, GOVT, HOTEL, HEALTH, NONPROFIT, PROF_SERVICES, RETAIL, TRAVEL, RESTAURANT, ALCOHOL, ONLINE_GAMBLING, PHYSICAL_GAMBLING, OTC_DRUGS}

    Business category. These values map to the following strings, which are displayed in the business profile in the WhatsApp client.

    • ALCOHOL = Alcoholic Beverages
    • APPAREL = Clothing and Apparel
    • AUTO = Automotive
    • BEAUTY = Beauty, Spa and Salon
    • EDU = Education
    • ENTERTAIN = Entertainment
    • EVENT_PLAN = Event Planning and Service
    • FINANCE = Finance and Banking
    • GOVT = Public Service
    • GROCERY = Food and Grocery
    • HEALTH = Medical and Health
    • HOTEL = Hotel and Lodging
    • NONPROFIT = Non-profit
    • ONLINE_GAMBLING = Online Gambling & Gaming
    • OTC_DRUGS = Over-the-Counter Drugs
    • OTHER = Other
    • PHYSICAL_GAMBLING = Non-Online Gambling & Gaming (E.g. Brick and mortar)
    • PROF_SERVICES = Professional Services
    • RESTAURANT = Restaurant
    • RETAIL = Shopping and Retail
    • TRAVEL = Travel and Transportation

    websites
    array<URI>

    URLs associated with the business, such as a website, Facebook Page, or Instagram profile. Strings must be prefixed with http:// or https://.

    • Maximum of 2 strings
    • Maximum 256 characters per string

    Return Type

    This endpoint supports read-after-write and will read the node to which you POSTed.
    Struct {
    success: bool,
    }

    Error Codes

    ErrorDescription
    100Invalid parameter
    200Permissions error
    131000Something went wrong
    131031Business Account locked
    131009Parameter value is not valid
    190Invalid OAuth 2.0 Access Token
    133010The account is not registered
    80008There have been too many calls to this WhatsApp Business account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.

    Deleting

    You can't perform this operation on this endpoint.