WhatsApp Catalog
You may need to learn how to use and set up WhatsApp Catalog for your WhatsApp Business API, please read this documentation.
Add WABA Catalog Integration
WABA Catalog Integration is a feature that allows for product synchronization triggered by Meta to retrieve data from Qiscus Shop. You can add more than 1 WhatsApp Business API (channel) to integrate with the WhatsApp Catalog. The prerequisite is that the WhatsApp Business API (channel) to be added must be installed in Omnichannel - Channel Integration with an Enabled status.
If you haven't installed WhatsApp on Omnichannel Integration, please follow the documentation for WhatsApp Cloud API Channel Integration.

First, please click on the "WhatsApp Catalog" menu.
Click on "Add WhatsApp Account" to integrate it with the WABA channel that has been integrated in Omnichannel Integration.
Get the Catalog ID
- If you have already created a catalog, ensure that it is integrated with the WhatsApp phone number you want to use. Follow the instructions in this documentation: How to Connect a Catalog with a WhatsApp Phone Number. After that, proceed with the steps in the How to Sync Meta Catalog guide to complete the integration between your WhatsApp catalog and Qiscus Shop.
- if you have not, please follow How to Create a Catalog on Facebook Commerce Catalog.
Make sure the inputted Catalog ID is valid, as we are currently unable to validate it.
Select the checkbox for each category you want to sync, then click the Save button.
How to Create Facebook Commerce Catalog
In order to create Facebook Commerce Catalog, you'll need to go to your Facebook business manager first and navigate to the Facebook Commerce menu like this steps:
- Access the business account manager https://business.facebook.com/
- Login to your Facebook Business Account.
- Enter the 6-digit code from the authentication app that you set up, if required.
- After successfully logging in, you need to find "Commerce" from the "All tools" menu or as simple as visiting https://business.facebook.com/commerce/.

Follow this video bellow to create new E-commerce catalog or follow the instruction steps bellow the video.

- If you haven't created a Catalog, then you need to create one by clicking the "Add Catalog" button
- Select Type, choose one of E-commerce, Travel, Property, Auto. (eg: E-commerce -> online Products)
- Configure Settings, select Upload product info, select catalog owner & enter the Catalog name.
- Then click "Create" to complete the catalog creation.
- Then click "View Catalog" to get the details of the catalog that has been made, then you will automatically be at https://business.facebook.com/commerce/catalogs/
- Next click "Settings"
- Click "Catalgue"
- Then you will find Catalog ID in the Catalog Name Section
How to connecting a catalog with a whatsapp phone number
- Go to the Catalog page in WhatsApp Manager using this link: WhatsApp Manager Catalog.

- Make sure you have selected the correct business portfolio and WhatsApp phone number that you want to connect to your catalog.
- Click on the "Choose a Catalogue" button and look for your catalog in the list. If you cannot find the catalog you created, please refer to this documentation to ensure that you have shared the catalog access with Qiscus.

- Click the "Connect Catalogue" button. Your catalog will now be successfully connected to the selected phone number and business portfolio, as shown in the image below.

How to Sync product to Meta Catalog
- Access the business account manager https://business.facebook.com/
- Login to your Facebook Business Account.
- Enter the 6-digit code from the authentication app that you set up, if required.
- After successfully logging in, you need to find "Commerce" from the "All tools" menu or as simple as visiting https://business.facebook.com/commerce/.

- Then, you need to make sure that the Business Account used to manage the Catalog is correct. If it's not, you can select the appropriate account.

- If you have selected the Business account, you will see the created Catalogs with details including Catalogue Name and Catalogue ID. Please select one to proceed.

- After selecting a catalog, you need to click on "Add Items".

- Choose the method for adding items. Here, you need to select "Data Feed" and then click "Next".

- Select "Yes" because the integration will be done using a Data Feed URL, which does not require a feed template.

- Select the method "Use a URL" and then fill in the required data that you can obtain from Qiscus Shop, such as the Data Feed URL, Username, and Password.

- If you encounter an error when clicking "Next" on the "Choose File" page, please ensure that the data you entered is correct and that you have selected the desired Categories in Qiscus Shop that will be synced to the Meta catalog.

- If there are no issues with the Data Feed, the next step is to determine how often Meta will update the Data Feed. You can choose between Hourly, Daily, or Weekly updates and specify the desired time and time-zone for the updates.

- Determining the action for existing items can be done by choosing whether to update, replace, or create new data for those items that already exist. You can specify the desired action based on your preference, taking into account the potential errors that may occur during the process.

- You will see a progress bar indicating the uploading process of the items.

- Once it is completed, you will be able to see the number of successfully uploaded items, along with the information on the next scheduled sync for the products.

Widget Product Recommendation

The Qiscus Shop widget is an interface designed to assist agents in providing product recommendations to customers in the form of interactive messages. This product recommendation feature is specifically applicable to customers who come from the WhatsApp channel. You can operate the Qiscus Shop Widget as follows:
- Go to the Omnichannel Inbox.
- Open one of the rooms.
- Click the "Widget" button on the right-hand side under 'Chat & Customer info.'
- Select "Qiscus Shop."
- The widget will display a list of products that have been onboarded through the Qiscus Shop Dashboard, provided you are currently in a room with a WhatsApp channel.
- Once the list of products is open, agents can choose one or several products.
- Send the product recommendations by clicking "Send Product Information".
WA Catalog Order Process
The WA Catalog Order process allows customers to seamlessly place orders either directly from the catalog or through product recommendations sent by agents. This feature streamlines the ordering experience for WhatsApp users. The process works as follows:
Selecting Products
- Customers can browse the catalog and select products directly.
- Alternatively, agents can send product recommendations via the Qiscus Shop widget in interactive message format.
Receiving Order Details Once products are selected, the customer will receive a WhatsApp message containing the order details along with a link to complete their order.

- Filling Order Details
By clicking the provided link, the customer will be directed to a form where they can:
- Apply Voucher (Optional)

Customers have the option to apply various types of vouchers during the order process, including:
- Shipping Voucher: Provides discounts on delivery fees.
- Discount Voucher: Offers a percentage or fixed amount discount on the total order value.
- Enter Voucher Code: Customers can manually input a unique voucher code for additional benefits.

Vouchers and promo codes must be redeemed before the order status changes to "Unpaid." Once the delivery and payment details are submitted, the status will update to "Unpaid," and the voucher or promo code field will be locked, preventing further changes.
- Enter Delivery Information

Customers will need to provide detailed delivery information to proceed with their order. This process is divided into two steps to ensure clarity and ease of use:
i. Filling Personal and Address Details

On the first page of the delivery information form, customers will be prompted to fill in the following details:
- Name: Full name of the recipient.
- Phone: Active phone number for delivery communication.
- Address: Complete address where the order will be delivered.
- Province: Select the province from a dropdown menu.
- City: Based on the selected province, customers can choose their city.
- Sub-district: Further specify the location by selecting the appropriate sub-district.
- Post Code: Enter the postal code corresponding to the delivery address.
ii. Selecting a Courier Service

After completing the address details, customers will proceed to the next page, where they can:
- Choose a preferred courier service from the available options.
- Review the estimated delivery time and cost associated with each courier.
iii. Complete Payment Details
Customers will choose their preferred payment method to finalize the order.

- Order Completion
After the customer applies vouchers (optional), fills in delivery details, and finalizes payment details, the order status will be updated to "Unpaid." At this stage, all submitted information—including voucher application, delivery details, and payment method—becomes final and cannot be changed.