Building a WhatsApp Chatbot with Wix Headless API: A Developer's Journey

Hello Dev Community! I'm Yitzi, a Creative Technologist at Wix and a chatbot enthusiast. Today, I want to share a project I've been working on - a WhatsApp chatbot that integrates with a Wix store. This chatbot allows customers to browse products, add items to their cart, and proceed to checkout - all within WhatsApp.

The Concept

The chatbot uses the Wix Headless API to communicate with the Wix store. It fetches product information, manages the shopping cart, and handles the checkout process. Any changes made to the store, such as adding new products or adjusting prices, are automatically reflected in the chatbot.

You can find the code for the chatbot on

Key Components

Here are the key components of the chatbot:

1. 
   wix_client.mjs: Sets up the Wix API client and handles OAuth authentication, enabling the chatbot to communicate with the Wix store through the Headless API.


2. 
   message_handler.mjs: Handles incoming WhatsApp messages and user interactions, managing the chat flow.


3. 
   products_api.mjs: Retrieves the available products from the Wix store.


4. 
   token_management.mjs: Manages user tokens and authentication for the Wix API, allowing the chatbot to interact with the Wix store on behalf of individual users.

How It Works

The chatbot guides customers through the entire shopping process, providing a product catalog view, individual product information (including images), and options to add items to the cart or proceed to the checkout.

Technical Details

The chatbot uses the Wix Headless Node SDK to fetch the list of available products in the store and maintains the state of each user's interaction with the store. It uses the user's current state to determine how to respond to their input, such as displaying a list of products, showing details about a specific product, or adding an item to their cart.

To add items to the user's cart, the chatbot calls the wixClient.currentCart.addToCurrentCart() method. When the user is ready to check out, the chatbot creates a checkout session using the wixClient.currentCart.createCheckoutFromCurrentCart() method and provides the user with a link to complete their purchase on the Wix store's website.

where you can connect with me on various social platforms.

Check out the GitHub repository for the WhatsApp chatbot