Products and Catalogs

You can only send a product message up until 24 hours after receiving a message from the user. If you have not received a message from the user within this time, you will need to start a new conversation by sending a Template message.
You can showcase and share your products and services with your customers via WhatsApp for them to browse items and add to a cart without leaving the chat. 
To use products and catalogs in your WhatsApp Business API account, please follow the next steps.
Businesses in India have different regulatory requirements. Please see more information in the Business Help Center.
How to create your Catalog and start sending Product messages
Step 1: Upload Inventory to Facebook
First, you need to upload your inventory to Facebook. You can use the API or Facebook’s Commerce Manager to do that.
Your inventory needs to be uploaded to Facebook in a catalog format — see About Catalogs for more information.
If you already have a Facebook catalog set up, we suggest that you leverage that catalog for WhatsApp commerce use cases.
If you need to create a catalog, there are two possibilities:
​Create a catalog using the Commerce API​
​Create a catalog using the Commerce Manager​
You can upload only one catalog per WhatsApp Business Account (WABA), but the same catalog can belong to multiple phone numbers.
2. Connect the catalog to a WABA
Owned WABAs (accounts created via Embedded Signup)
To connect a catalog to your WhatsApp business account:
Go to Business Manager and select your business 
Click 
​
Click WhatsApp Manager
Click Catalog 
Click Choose a Catalog. From the drop-down menu, select the catalog that you want to connect 
Click View Catalog if you want to view or manage the catalog
Click Connect Catalog
The catalog is connected to your WhatsApp business account. You can start sending Single Product Messages and Multi Product Messages to your customers and receive responses from them.
360dialog owned WABAs (accounts created via Classic Signup)
If the WABA is owned by 360dialog (which happens if you were onboarded using the Classic Signup Process), we will connect the Catalog to your WhatsApp Business API account for you. 
You will need to first create your own Facebook catalog (if you don't have one). Then you will need to give us permission to manage it —these permissions are controlled via Business Manager and Commerce Manager as shown in the screenshot below.
Please file a support ticket to receive 360dialog's Facebook Business Manager ID and inform us of this connection.
3. Share Products with Customers
Use Multi and Single Product Messages to send products to customers.
Businesses have two options to share products when chatting with their customers:
Multi Product Messages: Messages containing a selection of up to 30 items from a business’ inventory.
Single Product Messages: Messages with a single product item from the business’ inventory. The product is displayed in a Product Detail Page (PDP) format.
Both Multi-Product Messages and Single Product Messages are types of interactive messages.
If the WABA is registered in On-premise API
Example to send a Product Message
POST https://waba.360dialog.io/v1/messages
​
{
    "recipient_type": "individual",
    "to": "{{destination_wa_id}}",
    "type": "interactive",
    "interactive": {
        "type": "product",
        "body": {
            "text": "text-body-content"
        },
        "footer": {
            "text": "text-footer-content"
        },
        "action": {
            "catalog_id": "{{catalog_id}}",
            "product_retailer_id": "{{SKU-1}}"
        }
    }
}
​
Example to send a Multi-Product Message
POST https://waba.360dialog.io/v1/messages
​
{
    "recipient_type": "individual",
    "to": "{{destination_wa_id}}",
    "type": "interactive",
    "interactive": {
        "type": "product_list",
        "header": {
            "type": "text",
            "text": "text-header-content"
        },
        "body": {
            "text": "text-body-content"
        },
        "footer": {
            "text": "text-footer-content"
        },
        "action": {
            "catalog_id": "{{catalog_id}}",
            "sections": [
                {
                    "title": "the-section-title",
                    "product_items": [
                        {
                            "product_retailer_id": "{{SKU-1}}"
                        },
                        {
                            "product_retailer_id": "{{SKU-2}}"
                        }
                    ]
                },
                {
                    "title": "the-section-title2",
                    "product_items": [
                        {
                            "product_retailer_id": "{{SKU-1}}"
                        }
                    ]
                }
            ]
        }
    }
}
If the WABA is registered in Cloud API
Example to send a Product Message
POST https://waba-v2.360dialog.io/v1/messages
​
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{destination_wa_id}}",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "{{catalog_id}}",
      "product_retailer_id": "{{SKU-1}}"
    }
  }
}
​
Example to send a Multi-Product Message
POST https://waba-v2.360dialog.io/v1/messages
​
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header":{
      "type": "text",
      "text": "HEADER_CONTENT"
    },
    "body": {
      "text": "BODY_CONTENT"
    },
    "footer": {
      "text": "FOOTER_CONTENT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "sections": [
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
​
        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}
​
4. Receive Responses From Customers
Track webhooks to get questions and orders from customers.
Catalogs and Carts
Businesses can display their catalogs on the chat thread, on the business profile, and share catalog links with customers.
Shared WABAs created with Integrated Onboarding can enable or disable the shopping cart and the catalog using the Graph API. If the WABA is on OBO (On Behalf Of) model, please file a support ticket and we will enable it for you. 
By default, the shopping cart is enabled and the storefront icon is hidden for all business phone numbers associated with a WhatsApp Business Account.
The instructions provided here are related to the Graph API. Please refer to Meta's Graph API guide or contact our Support Team for assistance.
Requirements
Type
Description
​Access Tokens​
​User or System User.
​Permissions​
​whatsapp_business_management​
Businesses in India have different regulatory requirements. Please see more information in the Business Help Center.
Enable/Disable Catalog
When enabled, the catalog storefront icon and catalog-related buttons appear in conversation and business profile views:
When the catalog is disabled, the storefront icon and catalog-related buttons will not appear in any views and the catalog preview with thumbnails will not appear in the business profile view.
By default, the catalog will be off. To turn on the visibility of your catalog within the WhatsApp chat thread and your business profile to showcase your products, follow the steps described below:
Request Syntax
POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
  ?is_catalog_visible=<IS_CATALOG_VISIBLE>
Parameters
Placeholder
Sample Value
Description
<BUSINESS_PHONE_NUMBER_ID>
106850078877666
Business phone number ID.
<IS_CATALOG_VISIBLE>
true
Boolean. 
​
Set to true to show catalog storefront icon or false to hide it.

Default value is false.
Sample Request
curl -X POST 'https://graph.facebook.com/v16.0/106850078877666/whatsapp_commerce_settings?is_catalog_visible=true' \
-H 'Authorization
Sample Response
{
  "success": true
}
If you disable the catalog, wa.me links to your catalog, as well as the View catalog button that appears when you send your catalog link in a message will display an Invalid catalog link warning when tapped.
To direct your customers to your catalog, you can send them a message with a link to your catalog (generated by following the format: https://wa.me/c/<biz_phone_number>)
Enable/Disable Cart
By default, customers can add a product to their cart, or amend quantities directly from the list or product details page. When enabled, cart-related buttons appear in the conversation, catalog, and product details views.
When it is disabled, customers can see products and their details, but all cart-related buttons will not appear in any view.
To turn off the ability for customers to add products to their cart, follow the steps below:
Request Syntax
POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
  ?is_cart_enabled=<IS_CART_ENABLED>
Parameters
Placeholder
Sample Value
Description
<BUSINESS_PHONE_NUMBER_ID>
106850078877666
Business phone number ID.
<IS_CART_ENABLED>
true
Boolean. 

Set to true to enable cart or false to disable it. 

Default value is true.
Sample Request
curl -X POST 'https://graph.facebook.com/v16.0/106850078877666/whatsapp_commerce_settings?is_cart_enabled=true' \
-H 'Authorization: Bearer EAAJB...'
Sample Response
{
  "success": true
}
Get Business Settings
To get an individual business phone number's commerce settings, use the following endpoints: 
Request Syntax
GET /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
Parameters
Placeholder
Sample Value
Description
<BUSINESS_PHONE_NUMBER_ID>
106850078877666
Business phone number ID.
Sample Request
curl -X GET 'https://graph.facebook.com/v16.0/106850078877666/whatsapp_commerce_settings' \
-H 'Authorization: Bearer EAAJB...'
Sample Response
{
  "data": [
    {
      "is_cart_enabled": true,
      "is_catalog_visible": true,
      "id": "727705352028726"
    }
  ]
}
​

Type	Description
Access Tokens	User or System User.
Permissions	whatsapp_business_management

Placeholder	Sample Value	Description
`<BUSINESS_PHONE_NUMBER_ID>`	`106850078877666`	Business phone number ID.
`<IS_CATALOG_VISIBLE>`	`true`	Boolean. Set to `true` to show catalog storefront icon or `false` to hide it. Default value is `false`.

Placeholder	Sample Value	Description
`<BUSINESS_PHONE_NUMBER_ID>`	`106850078877666`	Business phone number ID.
`<IS_CART_ENABLED>`	`true`	Boolean. Set to `true` to enable cart or `false` to disable it. Default value is `true`.

Placeholder	Sample Value	Description
`<BUSINESS_PHONE_NUMBER_ID>`	`106850078877666`	Business phone number ID.

Last modified 16d ago