WhatsApp Catalog and Product Messages with Exotel

whatsapp business users can share their products and services with customers by creating a catalog, which is displayed on their business profile the whatsapp catalog feature is a powerful tool designed to enhance the business experience within the whatsapp messaging platform with this feature, businesses can showcase their products and services visually appealingly, providing a seamless shopping experience for customers directly within the chat interface we will explore the key functionalities and benefits of the whatsapp catalog feature, guiding businesses on how to leverage this tool to maximize their online presence and streamline customer interactions key features product showcase businesses can display a rich catalog of their products and services, complete with images, descriptions, and prices each item in the catalog is presented in a visually engaging format, allowing customers to browse and discover products effortlessly categorized collections catalogs can be organized into different categories, making it easy for customers to navigate and find specific products of interest businesses can create and manage multiple collections, ensuring a well organized and user friendly shopping experience detailed product information comprehensive product details such as specifications, sizes, colors, and more can be included in the catalog this feature enables businesses to provide customers with all the necessary information they need to make informed purchasing decisions quick replies for seamless interaction customers can directly add the items to the cart or inquire about products directly through the catalog using the button businesses can set up predefined responses to common queries, ensuring efficient and prompt communication components the catalog message mainly consists of 4 components as presented in the below images a) mult product message & b) single product message when a customer taps the view catalog button, your product catalog appears within whatsapp customers that receive multi and single product messages can perform 3 main actions view products customers can see a list of products or just one product whenever a customer clicks on a specific item, we fetch the product's latest info and display the product in a product detail page (pdp) format currently, pdps only support product images — any videos and/or gifs added to the product won’t be displayed in the pdp add products to a cart whenever a user adds a product to the shopping cart, we fetch the item’s latest info if there has been a state change on any of the items, we display a dialog saying "one or more items in your cart have been updated" — see product updates for more information a cart persists in a chat thread between you and your customer until the cart is sent to you send a shopping cart to you after adding all needed items, customers can send their cart to you after that, you can define the next steps, such as requesting delivery info giving payment options using the free form messages, or connecting out exotel chatbot for a better solution limitations currently, these types of messages can be received on the following platforms ios 2 21 100 (multi product messages) and 2 21 210 (single product messages) android 2 21 9 15 (multi product messages) and 2 21 19 (single product messages) web the web client that supports these features has been launched 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 messages containing information about a single product or up to 30 products from your product catalog if the customer's app version does not support multi or single product messages, they will instead receive a message explaining that they were unable to receive a message because they are using an outdated version of whatsapp expected behavior for messages multi product messages and single product messages can be forwarded by one user to another reopened by a user within the same conversation pre requisites create your whatsapp business account you can skip this part if you already have a whatsapp business account sign up for business manager complete business verification create the exotel account with kyc onboard a number to the whatsapp messaging console, which will create your whatsapp business account follow this step by step guide for more information whatsapp business account onboarding enable cart & catalog storefront icon (optional) you can enable or disable the shopping cart and the product catalog on a per business phone number basis by default, the shopping cart is enabled and the storefront icon is hidden for all business phone numbers associated with a whatsapp business account when enabled, the catalog storefront icon and catalog related buttons appear in conversation and business profile views as shown below enable cart when enabled, cart related buttons appear in the conversation, catalog, and product details views enable catalog 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 requirements connected phone number the status of the number on which you want to enable the catalog should be active this can be checked from your whatsapp business manager account from the meta or exotel whatsapp console compliance for india region (mandatory) businesses based in india must comply with all online selling laws as explained in the below section read more here from the meta document comply with laws for selling on whatsapp platform in india we at exotel will get this information updated for your whatsapp business number the below section covers the details required for you to comply with the meta policy here enable the catalog with exotel let's start to enable and set up the catalog for your business now that you have understood what is the whatsapp catalog and its capabilities, get ready with all the required details explained in the pre requisites section and get started whatsapp catalog feature glossary enable cart & catalog features enable cart button (optional) activate this feature if you wish to allow users to add items to their cart and place orders via whatsapp if you prefer not to facilitate orders through whatsapp, you can request to disable this option enable/disable catalog storefront icon (optional) this feature allows you to display your catalog in your business number's profile section enabling this option enables users to view and purchase products without the need for direct messages compliance with indian laws and regulations to sell in the indian region, businesses must adhere to local laws and regulations this involves providing accurate business details as per the policies outlined for selling online on the whatsapp business platform in india create the catalog on meta setup the catalog on meta assign the access to the partner (bsp) connect your catalog to the whatsapp business account send the catalog messages enable cart & catalog features raise a feature enable request to support enable the catalog cart, storefront icon & compliance information by filling in this form and raising it to our support team to get the cart, and catalog enabled with the compliance approved for your number enable whatsapp catalog form the form consists of details as following which are mandatory to set up the catalog customer & account details email id waba id phone number on which the catalog needs to be enabled (raise multiple forms for each phone number) exotel account sid disable/enable cart button on the number (optional) enable this only if you want to allow users to add items to the cart and send you the order if you just want to display the catalogs and do not want the user to place any order via whatsapp then you ask us to disable the cart option by default, this feature is enabled by meta and you can disable it by providing the consent in the feature request form enable/disable catalog storefront icon on the number (optional) this allows you to display the catalog on the business number under the profile section you can enable it on request where users can view and purchase the products without you sending any messages by default, this feature is disabled by meta and you can enable it by providing the consent in the feature request form comply with the indian laws and regulations to sell in india region, you need to comply with the policy by providing your business details read more here comply with laws for selling online on the whatsapp business platform in india provide the following compliance information for your business legal name of busines s enter the full legal name of your business business type select your business type the options include limited liability partnership sole proprietorship partnership public company private company other note if you select partnership or other as your business type, you will be asked if your business is registered under applicable laws (yes or no) we assume that your business is registered under applicable law for all other options grievance officer information enter the contact information of the individual who will respond to and resolve any complaints from your customers name email address contact number customer care informatio n enter the contact information of the individual who will respond to and resolve any support issues from your customers name email address contact number this is a mandatory step to enable the catalog feature and start selling in the india region in parallel, you can start the steps mentioned below to create and set up your catalog let us try to understand the steps to create and set up the catalog create the catalog to create a catalog, you will need access to the meta facebook account login to the meta business manager account with your admin access and go to the commerce manager as shown below or click this link https //business facebook com/commerce please verify the correct meta business account selected in the top left dropdown as highlighted in blue in the above image once you open the commerce manager page with the correct business account, click on the add catalogue button provide the basic details for your catalog like select the catalogue type that best describes the items that you sell now the second step is to configure settings, here you will have to choose the method of the inventory management and how would you want to upload the products to your catalogs there are 2 methods google sheet or manual upload here we will be covering the manual and the automated sheet method which allows you to add your items in bulk, select the first method upload product info option here connect e commerce platform additionally, businesses can also select the second option ‘connect e commerce platform’ if they want to connect their 3rd party platform where you can automatically import items using a partner platform such as shopify, bigcommerce, and more connect your catalog with your selected e commerce platform next, select your own meta business account in the dropdown under the owner field, this will map this catalog to your meta business account provide the name of your catalog in the catalogue name section click on the create button please follow the below gif/image for reference setup the catalog now that you have created the catalog under your meta business account, let us see how to set up the catalog and add items to it once the catalog is created under your business account you will be taken back to the home page, click on the items option under the catalogue section from the lhs navigation bar click on the add items button from the top right there are several ways to add items to your catalogue in commerce manager manual add items using a manual form in commerce manager data feed upload a spreadsheet or xml file from your computer or a file hosting website to add items in bulk you can upload a file once or set up scheduled uploads to happen hourly, daily or weekly partner platform if you already host your items on a partner platform that has an integration with meta, you can import items to your catalogue in commerce manager you can then continue to manage your items on your partner platform and any updates will automatically sync to commerce manager meta pixel import and update items automatically from your website using a pixel this method is more complex to set up you may need help from a developer to install microdata tags on your website let us try to understand the data feed method in details this method allows you to upload the items in bulk and auto sync the inventory based on the updates done in the sheet please follow the below steps download template and edit after clicking on add items, select the second option data feed, and then it will provide you with the sample template sheet to use for the data feed click on the download template button which appears in the rhs section open a new google sheets and import the newly downloaded file from the meta console provide the name to this catalog file, this will be the primary source of all the items for your catalog with all the details please fill in all the mandatory details that are marked as #required in the first row in the imported sample template, you can ignore the optional columns or fill them as per your requirements important step for selling in the india region, you will have to manually add a few more columns to the sheet as mentioned below the manual column headers to be added are origin country importer name importer address manufacturer info wa compliance category please make sure you copy the exact text from here and paste it into the title row similar to other existing options (anywhere in the sheet) the details for all the mandatory columns and the above india region specific columns are explained below with a sample sheet attached for your reference please refer to it for better understanding below are the mandatory details that need to be filled in your catalog google sheet as explained below attribute (column) description id (mandatory) a unique content id for the item use the item's sku if you can each content id must appear only once in your catalog character limit 100 example 3241 title (mandatory) a specific and relevant title for the item see title specifications see description specifications product title specifications for catalogs character limit 200 example football club ball size 5 description (mandatory) a short and relevant description of the item include specific or unique product features like material or color use plain text and don't enter text in all capital letters see description specifications product description specifications for catalogs character limit 9999 example a vibrant blue crewneck t shirt for all shapes and sizes made from 100% cotton availability (mandatory) the current availability of the item supported values in stock out of stock condition (mandatory) the current condition of the item supported values new used price (mandatory) the price of the item format the price as a number followed by the 3 letter currency code (iso 4217 standards) use a period ( ) as the decimal point; don't use a comma example 500 00 inr , 999 99 inr link (mandatory) the url of the specific product page where people can see and buy the item example http //www jaspersmarket com/products/shirt image link (mandatory) the url for the main image of your item images must be in a supported format jpg/gif/png with a resolution of at least 500 x 500 pixels example http //www jaspersmarket com/products/shirt jpg brand (mandatory) the brand name of the item you can also enter a unique manufacturer part number (mpn) or global trade item number (gtin) instead a gtin can be one of the following upc, ean, jan or isbn character limit 100 example jasper's market origin country (mandatory and needs to be added manually for the india region) the item's country of origin enter the two letter iso country code example value in importer name (mandatory and needs to be added manually for the india region) if the country of origin is not india, provide the legal entity name of the item's importer example value jasper's market inc importer address (mandatory and needs to be added manually for the india region) if the country of origin is not india, provide the operational address of the importer this field uses a json structure, which contains the following fields street1 string, required the first line of the street address street2 string, optional the second line of the street address city string, required the city name region string, optional the region, state or province (in the us this is to be used for us state) postal code string, optional (in the us this is to be used for zip code) country required enter the iso country code (2 letter country code) the overall address will be displayed to users in the following format street1, street2 (if present), city, region (if present) postal code (if present), country (full name, localized for the user) this example value { street1 "1 hacker way", street2 "building 18", city "menlo park", region "ca", postal code "94025", country "us" } this will be rendered as " 1 hacker way, building 18, menlo park, ca 94025 united states of america " manufacturer info (mandatory and needs to be added manually for the india region) required for shops only information about the product's manufacturer, such as the manufacturer's name and address example the manufacturer co 1 hacker way, menlo park, ca 94025 usa wa compliance category (mandatory and needs to be added manually for the india region) required for selling on whatsapp only if the item is a non physical good sold in india, such as a service, use this field to indicate that the item is exempt from providing the country of origin (origin country), importer name (importer name) and importer address (importer address) supported values (case sensitive) country origin exempt the item is exempt default the item is not exempt this is the default value if you leave the field blank sample filled sheet exotel sample catalog once the data in the google sheet is updated, click on share , select anyone with the link from general access, and set it as view basically, make this sheet accessible to all with the link copy the view all accessible url of the google sheet and paste it into the data sources> upload data feed section and click on next refer to the below gif now set up the data sync up time based on your requirements, this will auto update the data from the uploaded sheet on a recurring basis click on confirm , this will take some time to upload the inventory based on the data size once uploaded, check for the issues in the issues section and try to resolve them if any you can refer to this document for some faqs troubleshoot data feed errors in your catalog now the items present in the sheet added by you should be visible once they are successfully added the catalog is now ready!! assign access to the partner now that you have created the catalog and added items to the catalog by setting it up with your source data feed, enable exotel to have the access to this catalog as a bsp to start sending and receiving the messages follow the below steps to provide us the partner access to your catalog login to your meta business account and go to the business settings https //business facebook com/settings/product catalogs navigate to the data sources section from the lhs navigation bar click on catalogue and search for your catalog with the name that was created above navigate and click on the assign partners button select the first option business id and paste this ameyo bsp business id 258365684821485 it will open a dialogue box asking for the level of access, provide the full control by selecting the manage catalogue toggle as shown below click on done please refer to the below gif connect your catalog to your waba you need to connect the catalog to your whatsapp business account to enable the catalog messages to send or receive by your whatsapp phone number please follow these last steps before you launch yoru catalog please login to your meta business account and go to the whatsapp business manager account https //business facebook com/wa/manage/home select the correct whatsapp business manager account (waba) where you want to connect this catalog which has the phone number present go to the catalogue section from the lhs navigation bar click on the connect catalogue button please make sure that the user trying to connect a catalog has full access to the catalogue if not, then they will not be able to see the catalog name in the dropdown in such cases check the following things if the catalog is created by you and someone else is trying to connect the catalog then that person should be granted full access to the catalog go to the meta business settings >> data sources >> catalogue >> search catalog >> click on the name >> assign people >> add email id >> full control if the catalog is not created by you (seller) then reach out to your respective account manager or raise a ticket to our support on hello\@exotel in to get full access to the catalog by providing the catalog name & id once you see the required catalog, select it and click on done please refer to this gif to learn how to connect a catalog to a whatsapp business account you are now ready to send messages to your users on whatsapp please check the below section ‘ send catalog product messages ’ to learn how to send the catalog messages over whatsapp send catalog product messages now you are ready to send the product catalog messages businesses have multiple ways to share products with customers catalog link messages messages containing catalog thumbnails and a link to your entire product catalog product messages messages containing information about a single product or up to 30 products from your product catalog catalog template messages template messages containing a button that, when tapped, displays your product catalog within whatsapp (to be supported soon) multi product template messages template messages containing information about up to 30 products from your e commerce catalog, organized in up to 10 sections, in a single message (to be supported soon) we will be covering points 1 & 2 below before you start you will require these details catalog id this is your unique id for the catalog you can get the catalog id from your commerce manager https //business facebook com/commerce/catalogs/ select your catalog from the catalogue section go to the settings option from the lhs navigation bar go to the catalogue section from the newly opened settings section you will find the catalog id as highlighted in the below image product retailer id (content id) this is the unique id of the item that you want to send as a catalog message you can only send a single item in the single product message catalog you can get the product retailed id from the meta commerce console, under the items section here https //business facebook com/commerce/catalogs/ go to commerce manager >> items >> search for your item >> copy the content id and share it in the api this is the same id as provided in the data feed sheet in the first column postman collection whatsapp product catalog api single product messages to send a single product message, assemble an interactive object of type product with the following components object description body optional a body object see all options for the body object footer optional a footer object see all options for the footer object action required the action field must include catalog id id for the catalog you want to use for this message retrieve this id via commerce manager product retailer id a product’s unique identifier sample request { "custom data" "order123456", "status callback" "https //abc com", "whatsapp" { "messages" \[ { "from" "9172xxxxxxxx", "to" "9199xxxxxxxx", "content" { "type" "interactive", "interactive" { "type" "product", "body" { "text" "now shop all our products from here on whatsapp! " }, "footer" { "text" "thanks" }, "action" { "catalog id" "95675xxxxxxxx", "product retailer id" "xxxx" } } } } ] } } multi product messages to send a multi product message, assemble an interactive object of type product list with the following components object description header required the header’s type must be set to text remember to add a text object with the desired content see all available header fields body required a body object see all options for the body object footer optional a footer object see all options for the footer object action required the action field must include catalog id id for the catalog you want to use for this message retrieve this id via commerce manager sections array of section objects you must include at least one section inside each section, you can include the following title include a title for each section if you plan to use more than one product items array of product objects that should be displayed each product object contains a product retailer id, which corresponds to a product’s unique identifier retrieve this id via commerce manager see all options for the action object sample request { "custom data" "order123456", "status callback" "https //abc com", "whatsapp" { "messages" \[ { "from" "+9199xxxxxxxx", "to" "+9199xxxxxxxx", "content" { "type" "interactive", "interactive" { "type" "product list", "header" { "type" "text", "text" "header" }, "body" { "text" "text body content" }, "footer" { "text" "text footer content" }, "action" { "catalog id" "652xxxxxxx", "sections" \[ { "title" "book on mindset", "product items" \[ { "product retailer id" "10xx" }, { "product retailer id" "99xx" } ] }, { "title" "book on self development", "product items" \[ { "product retailer id" "10xx" } ] } ] } } } } ] } } these required details are the same as single product messages, the only change is that you can share multiple product items in this message in form of the sections each section will have its own items visible and categorized separately you can construct the api body as per your requirements catalog link messages businesses can send a link to their entire product catalog by assembling a wa me link and including it in a standard text message 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 note if businesses disable the catalog, wa me links and the view catalog button in catalog link messages will display an invalid catalog link message when tapped 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/15555451111 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 a business can only send upto 30 items in the multi product message to the customer 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 missing items if none of the items provided in the api calls above matches a product from the business’s facebook catalog, an error message is sent and the multi or single product message is not sent to the user for multi product messages, at least one item from the products list must match an item from the business’s facebook catalog in this case messages are sent successfully items without a match are dropped the business receives an error message asking for a catalog update faqs update a data feed for a catalog in commerce manager | meta business help center how to upload items to a catalog with a data feed in commerce manager | meta business help center troubleshoot data feed errors in your catalog | meta business help center how to add a google or facebook product category for items in your catalog | meta business help center comply with the laws for selling online on whatsapp business platform in india | meta business help center