Set Up and Send WhatsApp Commerce Catalogues in Convo

WhatsApp Commerce Catalogues bring your product inventory directly into the chat window. Customers can browse product cards with images, prices, and descriptions — and add items to a shopping cart — without ever leaving WhatsApp. Convo’s catalogue API lets you create and manage that inventory programmatically, connect it to your WhatsApp Business Account (WABA), and send interactive product messages that turn conversations into conversions.

WhatsApp supports several catalogue verticals beyond retail: commerce, destinations, hotels, flights, home_listings, and vehicle_offers. Choose the vertical that best matches your industry when creating a catalogue.

Getting Started with Catalogues

Create a catalogue

Create a new catalogue container. This registers the catalogue in Meta’s Commerce Manager and associates it with your Convo project.

POST https://connect.api-wa.co/project-apis/v1/project/{project_id}/create-catalog

Header	Value
`X-API-WA-Project-API-Pwd`	`YOUR_API_PASSWORD`
`Content-Type`	`application/json`

{
  "name": "Summer Collection 2024",
  "vertical": "commerce",
  "default_image_url": "https://example.com/default-product.jpg"
}

The response includes the new catalog_id. Save it — you’ll need it for every subsequent step.

Connect to WhatsApp (WABA)

Link your catalogue to your WhatsApp Business Account so products become visible on your WhatsApp profile and in interactive messages.

POST https://connect.api-wa.co/project-apis/v1/project/{project_id}/connect-meta-catalog

{
  "catalogueId": "738763614338341"
}

A catalogue can only be connected to one WABA at a time. Only one catalogue can be active per WABA.

Add products

Add individual products to the catalogue. Each product needs a unique retailer_id — this is what you reference in interactive messages when you want to surface a specific item.

POST https://connect.api-wa.co/project-apis/v1/project/{project_id}/create-product

{
  "catalogId": "738763614338341",
  "name": "Premium T-Shirt",
  "category": "Clothing",
  "currency": "INR",
  "price": "89900",
  "retailer_id": "tshirt-001",
  "image_url": "https://example.com/tshirt.jpg",
  "description": "100% cotton premium T-shirt",
  "url": "https://example.com/products/tshirt-001",
  "brand": "MyBrand",
  "sale_price": "69900"
}

Field	Description
`price`	Price in the smallest currency unit (paise for INR, cents for USD)
`sale_price`	Optional discounted price, also in smallest currency unit
`retailer_id`	Your internal SKU or product ID — must be unique within the catalogue
`url`	Product page URL opened when a customer taps “View on website”

Send a product message

Send an interactive product card directly in a conversation. The recipient sees the product image, name, price, and an Add to Cart button.

POST https://connect.api-wa.co/project-apis/v1/project/{project_id}/messages

{
  "to": "917089379345",
  "type": "interactive",
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "interactive": {
    "type": "product",
    "body": {
      "text": "Here's what you were looking at:"
    },
    "action": {
      "catalog_id": "738763614338341",
      "product_retailer_id": "tshirt-001"
    }
  }
}

Multi-Product Messages

A product_list message lets you display multiple products grouped into labelled sections in a single message — perfect for sending a “you might also like” carousel or a category browse view.

{
  "to": "917089379345",
  "type": "interactive",
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "interactive": {
    "type": "product_list",
    "header": {
      "type": "text",
      "text": "Summer Picks Just for You"
    },
    "body": {
      "text": "Browse our latest arrivals and tap any product to learn more."
    },
    "footer": {
      "text": "Free shipping on orders above ₹999"
    },
    "action": {
      "catalog_id": "738763614338341",
      "sections": [
        {
          "title": "Tops",
          "product_items": [
            {"product_retailer_id": "tshirt-001"},
            {"product_retailer_id": "polo-002"}
          ]
        },
        {
          "title": "Bottoms",
          "product_items": [
            {"product_retailer_id": "jeans-010"},
            {"product_retailer_id": "shorts-011"}
          ]
        }
      ]
    }
  }
}

You can include up to 30 products across a maximum of 10 sections in a single product_list message.

Sync Catalogue

If you manage your product inventory directly in Meta’s Commerce Manager (or via a third-party feed), use the sync endpoint to pull those changes into Convo. Sync catalogue metadata and product listings:

GET https://connect.api-wa.co/project-apis/v1/project/{project_id}/sync-catalogue

This endpoint returns the updated state of your catalogue after the sync completes. Run it after any bulk product import in Commerce Manager to make the new items available for messaging.

Get Started

Core Concepts

Guides

Set Up and Send WhatsApp Commerce Catalogues in Convo

Getting Started with Catalogues

Multi-Product Messages

Sync Catalogue

​Getting Started with Catalogues

​Multi-Product Messages

​Sync Catalogue

Getting Started with Catalogues

Multi-Product Messages

Sync Catalogue