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.
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:
You can upload only one catalog per WhatsApp Business Account (WABA), but the same catalog can belong to multiple phone numbers.
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.
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.
.png?alt=media&token=6432d341-5a08-4ac9-aa06-8efa0e71b98b)
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.
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}}"
}
]
}
]
}
}
}
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" },
...
]
}
]
}
}
}
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.
Type | Description |
---|---|
Businesses in India have different regulatory requirements. Please see more information in the Business Help Center.
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:
POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
?is_catalog_visible=<IS_CATALOG_VISIBLE>
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 . |
curl -X POST 'https://graph.facebook.com/v16.0/106850078877666/whatsapp_commerce_settings?is_catalog_visible=true' \
-H 'Authorization
{
"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>)
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:
POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
?is_cart_enabled=<IS_CART_ENABLED>
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 . |
curl -X POST 'https://graph.facebook.com/v16.0/106850078877666/whatsapp_commerce_settings?is_cart_enabled=true' \
-H 'Authorization: Bearer EAAJB...'
{
"success": true
}
To get an individual business phone number's commerce settings, use the following endpoints:
GET /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
Placeholder | Sample Value | Description |
---|---|---|
<BUSINESS_PHONE_NUMBER_ID> | 106850078877666 | Business phone number ID. |
curl -X GET 'https://graph.facebook.com/v16.0/106850078877666/whatsapp_commerce_settings' \
-H 'Authorization: Bearer EAAJB...'
{
"data": [
{
"is_cart_enabled": true,
"is_catalog_visible": true,
"id": "727705352028726"
}
]
}
Last modified 16d ago