LogoLogo
Become a PartnerStatus Page
  • get started
    • Welcome to 360Dialog
    • Quickstarts
      • Register as a Meta Tech Provider
      • Add a WhatsApp Number
      • Set up Integrated Onboarding
      • Create a Message Template
      • Send a Message
      • (temp title) Getting started as a partner
    • Pricing & Billing
      • Payment Methods for BR: Pix & Boleto
      • Month Closing Invoice (MCI)
    • Get API Access
    • Tech Provider Program
      • Understanding the Meta Tech Provider Program
      • Becoming a Meta Tech Provider: A Step-by-Step Guide
  • MM Lite Beta Program
    • Onboarding
    • Sending Messages
    • Expected Errors & Programming Languages
    • MM Lite Sandbox Testing
      • Sending Messages using MM Lite Sandbox
      • Expected Erros & Programming Languages
  • Partner & Account Management
    • Solutions for Partners
      • Benefits for Partners
      • Partner Hub
      • WABA Management
    • Account Setup & Management
      • Prerequisites and best practices for account creation
      • Account Structure
      • Account Creation
  • Integrations & API Development
    • Webhook Events & Setup
      • Webhook Events (Partner & Messaging API)
      • Webhook Configuration & Management
    • Integration Best Practices
      • Architecture and Security
      • Best Practices for Designing Integrations
        • Design a Stable Webhook Receiving Endpoint
      • Sizing Your Environment Based on Expected Throughput
      • Design a Resilient Message Sending Service
      • Integrated Onboarding
        • Basic Integrated Onboarding
        • Custom Integrated Onboarding
        • Host Your Own Embedded Signup
      • API Key Authentication for the Partner API
  • API Reference
    • Messaging API
    • Messaging Health Status
    • Sandbox (Test API Key)
    • Differences Between Cloud API and On-Premise API for Partners
      • [will be deprecated] Messaging with On-Premise API
    • Partner API
  • WABA Management
    • Managing WABA Accounts
      • Using the Partner Hub to manage Clients and Channels
      • Using the Partner API to manage Clients and Channels
      • Partner Permission to Generate API Key
      • Checking Usage & Statistics
    • Phone Number & Hosting
      • Migrating a Phone Number
        • Migrate number from Meta or alternate BSP to 360Dialog
        • Migrate a phone number to a new WABA
        • Migrate a phone number to a new WABA to change messaging Currency
      • WhatsApp Coexistence
        • Coexistence Onboarding
        • Coexistence Webhooks
      • Hosting type Change (On-premise API to Cloud API)
    • WABA Profile & Compliance
      • Display Name Guidelines
      • WABA Profile Info
      • WABA Policy Enforcement
      • Business Account Verification
    • Partner change (between 360Dialog Partners)
    • WhatsApp Flows
    • Accelerated Onboarding
    • Business Account Verification
  • Messaging
    • Sending & Receiving Messages
      • Conversations
      • Receiving messages
      • Before sending a message
    • Message Types
      • Conversational Components
      • Checklist for Message Broadcasts and Campaigns
      • Text messages
      • Interactive messages
        • Single and Multi Product Messages
        • Location Request Messages
        • Address Messages (India and Singapore only)
      • Contacts & Location Messages
    • Template Messages
      • Template Library
      • Template Elements
      • Sending Template Messages
      • Authentication Templates
        • Zero-Tap Authentication Templates
        • One-Tap Autofill Authentication Templates
        • Copy Code Authentication Templates
      • Catalog Templates
      • Product Card Carousel Templates
      • Single-Product Message Templates
      • Coupon Code Templates
      • Limited-Time Offer Templates
      • Multi-Product Templates
    • Media Messages
      • Upload, retrieve or delete media
    • Messaging Health & Troubleshooting
      • Messaging Limits & Quality Rating
      • Errors While Messaging
      • Messages statuses
  • Commerce & Payments
    • Payments (India Only)
      • Receive WhatsApp Payments via Payments Gateway
      • Receive WhatsApp Payments via Payment Links
      • Order Details Template Message
    • Payments (Singapore Only)
      • Receive WhatsApp Payments via Stripe
    • Products and Catalogs
      • India Businesses: Compliance for Commerce
  • Support & Updates
    • Help & Troubleshooting
      • FAQ
      • Error Code Reference
      • User Support Documentation
        • Tutorials
          • Page How to Troubleshoot Login Issues in the 360dialog Hub
          • How to Report an Issue
          • How to Contact Support
        • How-To Guides
          • Raise a support request
          • Requesting a Status Update for Business Verification
        • Reference
          • Troubleshooting Embedded Signup Issues
          • Commerce Policy Checks for WhatsApp API Access
          • Support Availability & SLAs
          • Incident Issue Prioritization
          • Case Types Table
        • Explanation
          • Why Business Verification Takes Time
          • Why Some Issues Are Not Emergencies
          • Understanding the Support Process
      • Support with Meta
    • Imprint & Data Privacy
    • Product Updates & News
      • How to ensure your Template Messages will be received
      • Integrated Onboarding new look and Campaigns Best Practices
Powered by GitBook
On this page
  • How to create your Catalog
  • 1. Upload Inventory to Facebook
  • 2. Connect the catalog to a WABA
  • How to share Products with Customers
  • 1. Single and Multi Product Messages
  • 2. Catalog Messages
  • 3. Multi-Product Template Messages
  • 4. Catalog Link Messages
  • 5. Catalogs Template Messages
  • Catalogs and Carts
  • Get WhatsApp Commerce Settings
  • Update WhatsApp Commerce Settings
  • Empowering Catalogs
  • How to implement in your use case

Was this helpful?

  1. Commerce & Payments

Products and Catalogs

PreviousReceive WhatsApp Payments via StripeNextIndia Businesses: Compliance for Commerce

Last updated 11 months ago

Was this helpful?

The has specific conditions for which types of products can be sold via WhatsApp, detailed in the . Businesses not complying to these rules are at risk of having their WhatsApp accounts permanently banned.

Businesses can enable Catalogs to share products with customers using Multi and Single-Product messages or showcase their products and services to their customers in the WhatsApp App, allowing them to browse through and add items to their cart without leaving the conversation, providing a seamless and convenient shopping experience.

See below how to create and use Catalogs in your WhatsApp Business Account.

Businesses in India have different regulatory requirements. Please see more information in the .

How to create your Catalog

1. Upload Inventory to Facebook

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 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.

We recommend giving the catalog a unique name such as "Catalog Name" & “_” & "Catalog ID" so it is easier to locate while connecting it in Step 2. Example:

Catalog Name: "Summer Collection", Catalog ID: "14556734" → Unique Name: "Summer Collection_14556734" Catalog Name: "Books", Catalog ID: "24680988" → Unique Name: "Books_24680988"

2. Connect the catalog to a WABA

Owned WABAs (accounts created via Embedded Signup)

To connect a catalog to your WhatsApp business account:

  • Go to Business Manager and select your business

  • 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.

360dialog owned WABAs (accounts created via Classic Signup)

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.

How to share Products with Customers

After the Catalog is created and linked to the WABA, businesses have three options to share products when chatting with their customers:

  • Single and Multi Product Messages: Interactive messages containing a selection of up to 30 items from a business’ inventory.

  • Multi-Product Template Messages: Template messages containing information about up to 30 products from your ecommerce catalog, organized in up to 10 sections, in a single message.

  • Catalog Links: Messages containing catalog thumbnails and a link to their entire product catalog.

  • Catalog Messages: Free-form messages containing a button that, when tapped, displays your product catalog within WhatsApp.

  • Catalog Template Messages: Template messages containing a button that, when tapped, displays your product catalog within WhatsApp.

1. Single and Multi Product Messages

2. Catalog Messages

Catalog Messages is not available in India.

Catalog messages are free-form messages that allow you to showcase your product catalog entirely within WhatsApp. Catalog messages display a product thumbnail header image of your choice, custom body text, a fixed text header, a fixed text sub-header, and a View catalog button.

Properties

Placeholder
Description
Sample Value

<BODY_TEXT>

String

Required.

Text to appear in the message body.

Maximum 1024 characters.

Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase.

<FOOTER_TEXT>

String

Optional.

Text to appear in the message footer.

Maximum 60 characters.

Best grocery deals on WhatsApp!

<THUMBNAIL_PRODUCT_RETAILER_ID>

String

Required.

Item SKU number. Labeled as Content ID in the Commerce Manager.

The thumbnail of this item will be used as the message's header image.

If the parameters object is omitted, the product image of the first item in your catalog will be used.

2lc20305pt

Sample Request

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "16505551234",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": {
      "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "2lc20305pt"
      }
    },
    "footer": {
      "text": "Best grocery deals on WhatsApp!"
    }
  }
}

3. Multi-Product Template Messages

4. Catalog Link Messages

When sending a text message, businesses can use the optional preview_url set to true to have the message render a set of product catalog thumbnails of any URL in the message body string.

To assemble wa.me link, append the business's business phone number, including country code, to the end of the following string:

https://wa.me/c/

For example:

https://wa.me/c/15555455657

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.

5. Catalogs Template Messages

Catalogs and Carts

Businesses can display their catalogs on the chat thread, on the business profile, and share catalog links with customers.

Get WhatsApp Commerce Settings

GET https://hub.360dialog.io/api/v2 /partners/{partner_id}/clients/{client_id}/channels/{channel_id}/whatsapp_commerce_settings

Request Example

curl --request GET --url https://hub.360dialog.io/api/v2/partners/partner_id/clients/client_id/channels/channel_id/whatsapp_commerce_settings --header 'Accept: application/json' --header 'Authorization: '

{
  "data": [
    {
      "id": "1866604260365799",
      "is_cart_enabled": false,
      "is_catalog_visible": false
    }
  ]
}

Update WhatsApp Commerce Settings

POST https://hub.360dialog.io/api/v2 /partners/{partner_id}/clients/{client_id}/channels/{channel_id}/whatsapp_commerce_settings

Request Example

curl --request POST --url https://hub.360dialog.io/api/v2/partners/partner_id/clients/client_id/channels/channel_id/whatsapp_commerce_settings --header 'Accept: application/json' --header 'Authorization: ' --header 'Content-Type: application/json' --data '{ "is_cart_enabled": true, "is_catalog_visible": true }'

Request Body

Name
Type
Description

is_catalog_visible

boolean

Set to true to show catalog storefront icon or false to hide it. Default value is false.

is_cart_enabled

boolean

Set to true to enable cart or false to disable it. Default value is true.

{
  "meta": {
    "developer_message": "Whatsapp commerce settings successfully updated",
    "http_code": 200,
    "success": true
  }
}

Catalogs

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.

Carts

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.

Shopping Cart Experience

After viewing products, a customer can add them to their shopping cart and send that cart to a business. For the purposes of commerce on WhatsApp, a shopping cart:

  • Is unique to a person/business chat thread in a specific device: Only one cart is created per chat thread between customer and business and carts do not persist across multiple devices. Once a cart is sent, the customer can open another cart with the business and start the process again.

  • Has no expiration date: The cart persists in the chat thread until it is sent to the business. Once sent, the cart is cleared.

Customers can add up to 99 units of each single catalog item to a shopping cart, but there is no limit on the number of distinct items that can be added to a cart.

Once a cart has been sent, no edits can be made. Customers can send a new cart if they need new items, or would like to change their order. Businesses cannot send carts to customers.

Empowering Catalogs

How to implement in your use case

We've described below the tools used in this use case, so you can adapt and implement them in your Business to streamline your processes.

We are directly partnering with Meta to gain access to their beta programs and actively contribute to the development of a better product.

Please note that certain beta features may only be available for numbers in specific countries. If you're interested in participating in our beta programs, kindly get in touch with our Support team.

It is also important to note that the JioMart use case is very specific and this end-to-end integration was assembled exclusively for them, with some features that are still not available to beta programs. We are waiting for an ETA from Meta and will share more details soon.

Click

Please to receive 360dialog's Facebook Business Manager ID and inform us of this connection.

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 .

Both Multi-Product Messages and Single Product Messages are types of .

Once you have your use the WABA API to send this type of message. Use the endpoint with the following parameters:

Multi-Product Message templates can be used to open , meaning you can start a conversation using this template. See.

Businesses can send a link to their entire product catalog by assembling a wa.me link and including it in a standard .

Catalog templates arethat allow you to showcase your product catalog entirely within WhatsApp in the fisrt interaction. See

Shared WABAs created with Integrated Onboarding can enable or disable the shopping cart and the catalog using the Partner API. If the WABA is on OBO (On Behalf Of) model, please file a and we will enable it for you.

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, use the endpoint described above.

Meta has revolutionized the online shopping experience launching the first in partnership with JioMart powered by using Catalogs. The combination of integrations allows people in India to browse through JioMart's catalog, add products to their cart and pay to complete purchases, all within WhatsApp.

Start a conversation with users: You can engage and attract new customers to your business by utilizing for free messaging with a 72-hour care window or by enabling the . You can refer to our documentation to explore further these possibilities.

Share Catalog with the user: Any business can send a link to their entire product catalog by assembling a wa.me link and including it in a standard . For that, please refer to our documentation above to . The JioMart Catalog also contains Product Categories, Top Deals, and a search button. These are the features we're waiting for an ETA from Meta. Soon we will be able to share more information about them. However, it is already possible to add various products to your Catalog, since there is no limit on the number of products to showcase (even though we recommend keeping it below 100 items to improve the user experience while shopping until Categories are released).

Confirm the user's address for delivery: are currently available as a beta program for India and Singapore businesses. We will share more details whenever it is released for other regions. However, you can mimic the case for by using interactive messages or by using other location-based services.

Share billing options with the user: JioMart receives payments through . This feature is available only for India businesses using the 360dialog WhatsApp Business API with phone numbers only from India. This is also available for Singapore businesses on a different beta. If you are eligible and wish to take part in any beta program, please reach out to our team. Nevertheless, you can still generate payment links for your clients and include the link in a standard with buttons.

WhatsApp Business Messaging Policy
Commerce Policy
Business Help Center
About Catalogs
Create a catalog using the Commerce API
Create a catalog using the Commerce Manager
file a support ticket
sending a Template message
interactive messages
marketing conversations
Multi-Product Template Messages
text message
marketing templates
Catalogs Template Messages.
support ticket
End-to-End shopping experience
Address Messages
user's location
WhatsApp Payments API
text message
/messages
inventory connected,
Update WhastApp Commerce Settings
text message
enable catalogs
Click to WhatsApp Ads
Search Feature