Catalogue & Product messages

Catalog message

Catalog messages are messages that allow you to showcase your entire product catalog within WhatsApp. When a user taps the View catalog button, your product catalog appears within WhatsApp.

In the example below, we send a catalog message.

{
    "messages": {
        "msg": [
            {
                "body": {
                    "type": "auto",
                    "content": "Fallback Text"
                },
                "to": [
                    {
                        "number": "0031612345678"
                    }
                ],
                "from": "0031687654321",
                "allowedChannels": [
                    "WhatsApp"
                ],
                "richContent": {
                    "conversation": [
                        {
                            "interactive": {
                                "type": "catalog_message",
                                "body": {
                                    "text": "Check our product catalog!"
                                },
                                "footer": {
                                    "text": "Enjoy nice products!"
                                },
                                "action": {
                                    "name": "catalog_message"
                                }
                            }
                        }
                    ]
                }
            }
        ]
    }
}

Product messages

WhatsApp Product Messages let you easily share products with your customers. There are two options:

Product List Messages: These messages include a selection of up to 30 items from a business's inventory.
Single Product Messages: These messages showcase a single product item from the business's inventory, presented in a Product Detail Page (PDP) format.

When your customers receive these product messages, they can add items to a shopping cart, send the cart to your business, and share products with their contacts on WhatsApp.

Keep in mind that to send these messages, you need to link a WhatsApp Business number to a corresponding Facebook Business page. Also, make sure to add your products to a catalog using the Commerce Manager for effective distribution of product messages. For more details about product catalogs, visit WhatsApp commerce guide.

In the example below, we send a single product message.

{
    "messages": {
        "msg": [
            {
                "body": {
                    "type": "auto",
                    "content": "Fallback Text"
                },
                "to": [
                    {
                        "number": "00316012345678"
                    }
                ],
                "from": "00316098765432",
                "allowedChannels": ["WhatsApp"],
                "richContent": {
                    "conversation": [
                        {
                            "interactive": {
                                "type": "product",
                                "body": {
                                    "text": "Do you want to enjoy the fun of a new mousepad?"
                                },
                                "footer": {
                                    "text": "Limited edition, only 1 per order."
                                },
                                "action": {
                                    "catalog_id": "catalog-id",
                                    "product_retailer_id": "product-id-in-catalog"
                                }
                            }
                        }
                    ]
                }
            }
        ]
    }
}

In the example below, we send a product list message.

{
    "messages": {
        "msg": [
            {
                "body": {
                    "type": "auto",
                    "content": "Fallback Text"
                },
                "to": [
                    {
                        "number": "00316012345678"
                    }
                ],
                "from": "00316098765432",
                "allowedChannels": ["WhatsApp"],
                "richContent": {
                    "conversation": [
                        {
                            "interactive": {
                                "type": "product_list",
                                "body": {
                                    "text": "Hi customer! We have some new products in stock!"
                                },
                                "header": {
                                    "type": "text",
                                    "text": "New products"
                                },
                                "action": {
                                    "catalog_id": "catalogid-from-commercemanager",
                                    "sections": [
                                        {
                                            "title": "Products",
                                            "product_items": [
                                                {
                                                    "product_retailer_id": "product-id-in-catalog"
                                                },
                                                {
                                                    "product_retailer_id": "product-id-in-catalog"
                                                },
                                                {
                                                    "product_retailer_id": "product-id-in-catalog"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            }
                        }
                    ]
                }
            }
        ]
    }
}