Skip to main content

Using WhatsApp Catalogs

Last updated: 15 July 2025

If you use a WhatsApp business account to sell goods or services, connect a catalog to it. The catalog will help you showcase and sell your products or services directly in the WhatsApp app.

How to Connect a Catalog to a WhatsApp Business Account​

  1. Make sure that you have created an account on the WhatsApp Business platform. If not, create it. www.facebook.com
  2. Create a catalog in the Commerce Manager. Your company should own or have access to the catalog. www.facebook.com
  3. Make sure that you have permission to manage the catalog. www.facebook.com
  4. Go to the Meta Business Suite settings or to the company settings in Business Manager. business.facebook.com
  5. Connect the created catalog to your WhatsApp business account by following the Meta instructions. www.facebook.com

Sending and Receiving Messages about Catalog Items via the edna Pulse API​

File IconSending Messages via API File IconMessage Examples

Outgoing Message with One Product​

info

The message should contain the catalog and product IDs in the Commerce Manager.

JSON example for sending an outgoing message with one product from the catalog
{
    "requestId": "test-001",
    "cascadeId": "3",
    "subscriberFilter": {
        "address": "35000000000",
        "type": "PHONE"
    },
    "content": {
        "whatsappContent": {
            "contentType": "PRODUCT",
            "header": {
                "text": "Catalog"
            },
            "text": "Choose the best offer",
            "catalog": {
                "id": "377932094379589",
                "product": {
                    "id": "yxtgwrkdy9"
                }
            }
        }
    }
}

Outgoing Message with a Group of Products​

info

The message should contain the catalog and product IDs in the Commerce Manager.

JSON example for sending an outgoing message with a group of products from a catalog
{
    "requestId": "test-001",
    "cascadeId": "8",
    "subscriberFilter": {
        "address": "35000000000",
        "type": "PHONE"
    },
    "content": {
        "whatsappContent": {
            "contentType": "PRODUCT_LIST",
            "header": {
                "text": "Catalog"
            },
            "text": "Choose the best offer",
            "catalog": {
                "id": "377932094379589",
                "sections": [
                    {
                        "title": "Sneakers",
                        "products": [
                            {
                                "id": "yxtgwrkdy9"
                            },
                            {
                                "id": "5k0l3pwczd"
                            }
                        ]
                    },
                    {
                        "title": "T-shirts",
                        "products": [
                            {
                                "id": "5k0l3pwczd"
                            }
                        ]
                    }
                ]
            }
        }
    }
}

Incoming Message with a Question about the Product​

The incoming message will contain the catalog and product IDs in the Commerce Manager.

Incoming Message with a Basket of Selected Items​

The incoming message will contain the IDs of the catalog and products in the Commerce Manager, the number of products in the basket, the price and currency of each product.