WhatsApp Business API for eCommerce – WhatsApp Catalog API (Step by Step Guide)

whatsapp catalog api

The WhatsApp Catalog API lets WhatsApp businesses showcase their products and/or services to their end-users in the form of a catalog and receive orders with the help of the ‘Add to Cart’ feature.

Here’s how it looks like-

whatsapp business catalog trigger
Multi-Product message example

whatsapp business single product listing
Menu triggered when user clicks on Start Shopping

product details on whatsapp business api
Single Product message example

multi product whatsapp message example
Product Detail Page example

 

Steps to use the Product Catalog on WhatsApp Business API –

Step 1: Creates a catalog on the Commerce Manager.

Step 2: Assign the Catalog to your WhatsApp Business Account (only one Catalog allowed per WABA).

Step 3: Business then sends single or multiple product messages to customers using the Catalog API.

Step 4: Receive responses from customers via Webhooks.

Note: If the WABA is Indian (+91 phone number), the business’s e-commerce compliance is necessary.

Please read – How to comply with the laws for selling online in India using WhatsApp Business API

 

Step 1:Create a Catalog on the Commerce Manager

A catalog can be created in 2 ways –

  • Using the API
  • Using the Commerce Manager Interface

In this article, we will discuss the second approach to use the Commerce Manager Interface to create a Catalog and upload your inventory of items-

You can follow this process.

Create a New Catalog

  1. Go to Commerce Manager.

  2. Start creating your catalogue:
    • If this will be your first catalogue, click Get Started. Select Create a catalogue and then click Get Started.
    • If you already have at least one catalogue, you’ll see all of your catalogues listed. Select + Add Catalogue to create a new one.

  3. Select the type of inventory you advertise or sell, then click Next.

  4. E-commerce (products) only: Choose how you want to add items to your catalogue:
    • Select Upload product info if you plan to add items yourself in Commerce Manager.
    • Select Connect a partner platform if you host your items on a partner platform that has an integration with Facebook. Select a platform and follow the link to its website to complete setup and import items to Facebook. Learn more about importing items from a partner platform.

  5. Select the Business Manager account that your catalogue belongs to. This unlocks more ways to use your catalogue than selecting a personal account and enables you to assign other people permission to work on the catalogue. To select a Business Manager account, you must be a business admin.

  6. Enter a name for your catalogue.

  7. Click Create.

Now, you can add items to your Catalog.

Add items in Commerce Manager

There are three main ways to add items to your catalogue in Commerce Manager:

  • Manual: Add items using a manual form in Commerce Manager.

  • Data feed: Upload a data feed (spreadsheet file) to add items in bulk. You can upload a file once or set up scheduled uploads to happen on a regular basis. We support CSV, TSV and XML file formats as well as Google Sheets.

  • Facebook pixelImport and update items automatically from your website. This method is more complex to set up. You may need help from a developer to install microdata tags on your website.

 

Once you’ve added the items to your Catalog, this is what it looks like-

image 14
Items added in your Catalog under Commerce Manager

 

Step 2: Assign the Catalog to your WhatsApp Account

On your Facebook Business Settings Page, look for your WhatsApp Account and click on “WhatsApp Manager”.

image 15
Navigate to WhatsApp Manager from Facebook Business Settings Page

On WhatsApp Manager, click on “Catalog” from the left navigation.

 

image 16

 

Click on “Choose Catalog”.

 

image 17

 

Click on “Connect Catalog” after selecting the Catalog.

 

image 18

 

Once the Catalog is connected, this is the view.

 

image 19

Step 3: Send Product Messages using API

Both Single-Product and Multi-Product Messages are a part of the “interactive message” under WhatsApp APIs.

 

The Official Guide to sending these messages can be found here.

To set up the API, you must get the latest Postman Collection from this link.

On the Postman Collection, these APIs are available under the “Messages” folder.

image 20

 

To send the product messages, you would require the below parameters.

  • catalog_id – You can find it on your Commerce Manager. After selecting your catalog, you can copy the Catalog ID from your browser URL as follows.
image 23
Finding catalog ID from Commerce Manager on Facebook
  • product_retailer_id – This is found on the Commerce Manager below each item.
image 24
Finding product_retailer_id from Commerce Manager on Facebook

Sending Single Product Message

 

API Request Sample-

{ 
    "recipient_type": "individual",
    "to" : "{{Recipient-WA-ID}}",
    "type": "interactive",
    "interactive": {
        "type": "product",
        "action": {
            "catalog_id": "334921974886038",
            "product_retailer_id": "t5jdph6mgc"
        },
        "body":{
            "text": "Handpicked, locally sourced fruits that are cold-pressed for maximum flavour. Natural ingredients. No Added Preservatives."
        },
        "footer":{
            "text": "Same Day Delivery in Bengaluru"
        }
    }
}
image 21
API Request & Response for Single Product Message

 

image 22
Sample Single Product Message received via API

 

Sending Multi-Product Message

 

API Request Sample-

{ 
    "recipient_type": "individual",
    "to" : "{{Recipient-WA-ID}}",
    "type": "interactive",
    "interactive": {
        "type": "product_list",
        "header":{
            "type": "text",
            "text": "View Beverages"
        },
        "body":{
            "text": "Handpicked, locally sourced fruits that are cold-pressed for maximum flavour. Natural ingredients. No Added Preservatives."
        },
        "footer":{
            "text": "Same Day Delivery in Bengaluru"
        },
        "action": {
            "catalog_id": "334921974886038",
            "sections": [
                {
                    "title": "Fresh Juices",
                    "product_items": [
                        {"product_retailer_id": "q2tusgkywy"},
                        {"product_retailer_id": "t5jdph6mgc"}
                    ]
                },
                {
                    "title": "Beverages",
                    "product_items": [
                        {"product_retailer_id": "q2tusgkywy"},
                        {"product_retailer_id": "t5jdph6mgc"}
                    ]
                }
                ]
        }
    }
}

 

image 25
Multi-Product Message Example

The above guide has been prepared to assume you have access to WhatsApp’s Official Business APIs from a WhatsApp API Provider.

If you do not have access to WhatsApp APIs, you can get the same very easily.

How to get WhatsApp Business API?

To get WhatsApp API Access, you need to follow these steps –

  1. Get a Phone Number (should not have an existing WhatsApp Account).

  2. Signup for a WhatsApp API Provider such as WATI. You can signup here.

  3. Complete Facebook Business Verification.

Here’s a full guide to understand how you can get WhatsApp Business APIs.

 

About WATI

WATI is a Multi-Agent WhatsApp Support Tool with a No-Code Chatbot Builder. It is built on WhatsApp APIs.

Powered by Clare.AI Limited – WhatsApp’s Official API Partner since 2019.

Share This Post

Share on facebook
Share on linkedin
Share on twitter
Share on email

Leave a Comment

More To Explore