ChatCart ProChatCart Pro
Features

Features

A complete guide to every feature in ChatCart Pro, from the product page button to the analytics dashboard.

Product Page Button

The product page button is the core feature of ChatCart Pro. It adds a WhatsApp checkout button to each WooCommerce single product page. When clicked, it adds the product to the cart and takes the customer to the ChatCart Pro checkout page, where they fill in their details before being redirected to WhatsApp.

Product page with ChatCart Pro WhatsApp button
The WhatsApp button appears on single product pages, below or above the standard Add to Cart button.

How the Checkout Flow Works

  1. Customer clicks the WhatsApp button on a product page.
  2. The ChatCart Pro checkout page is shown. It displays the product details and collects the customer's information using the fields you've enabled in the Fields tab.
  3. The customer fills in their details and clicks Send via WhatsApp.
  4. ChatCart Pro builds a structured message containing the product details, the customer's information, their chosen payment method, and any notes.
  5. The customer is redirected to WhatsApp (on mobile: the WhatsApp app; on desktop: WhatsApp Web) with the message pre-filled and your store's number as the recipient.
  6. The customer taps Send and your team receives the complete order.
The checkout form modal that appears when a customer clicks the WhatsApp button.

Variable Products

ChatCart Pro fully supports WooCommerce variable products. The button is displayed for all product types. For variable products, the message sent to WhatsApp includes the selected variation details (e.g., "T-Shirt, Size: M, Color: Blue") so your team knows exactly what was ordered.

The button is available as soon as the customer selects a variation. If no variation is selected, the button prompts the customer to make a selection first.

Product Quantity

The quantity input on the product page is respected by ChatCart Pro. If a customer sets the quantity to 3 before clicking the button, the WhatsApp message will reflect a quantity of 3.

Cart Page Button

When the Show on Cart Page option is enabled in General Settings, ChatCart Pro adds a WhatsApp checkout button to the WooCommerce cart page. This lets customers finalize their entire cart (with multiple products) via WhatsApp.

Cart page with WhatsApp checkout button
The WhatsApp button on the WooCommerce cart page, alongside the standard Proceed to Checkout button.
Cart page with WhatsApp checkout button
The WhatsApp button on the WooCommerce cart page, alongside the standard Proceed to Checkout button.

Multi-Item Orders

When the button is clicked from the cart page, the WhatsApp message includes a full itemized list of everything in the cart: product names, quantities, individual prices, and the cart total. For example:

Example WhatsApp Message

Hello! I'd like to place an order:

• Cotton T-Shirt (White, M) × 2 - R$ 79,80

• Canvas Tote Bag × 1 - R$ 45,00

Total: R$ 124,80

Name: Maria Silva

Phone: (11) 98888-7777

CEP: 01310-100

Payment: PIX

Notes: Please deliver in the afternoon.

Cart Button Position

The cart button is placed below the standard "Proceed to Checkout" button and uses the same green gradient style as the product page button.

Floating Button

The floating button is a persistent WhatsApp icon that stays fixed in the corner of the screen as customers browse your site. Unlike the product and cart buttons, the floating button is for general inquiries and does not trigger a checkout form. It simply opens a WhatsApp chat with a pre-configured message.

The floating button is visible on all pages, fixed to the screen corner.

Use Cases

  • Allow customers to ask questions before purchasing without leaving the page.
  • Offer a quick contact channel for support, shipping inquiries, or custom orders.
  • Improve conversion by making it easy to reach a human at any point in the browsing journey.

Configuration

Configure the floating button in ChatCart Pro → Settings → Floating:

  • Enable: Toggle the floating button on or off.
  • Position: Bottom-right (default) or bottom-left corner of the screen.
  • Show On: Choose whether the button appears on all pages, product pages only, or the cart page only.
  • Mobile Bottom Margin: The distance (in px) from the bottom of the screen on mobile. Increase this if a bottom navigation bar in your theme overlaps the button.
  • Pre-filled Message: The message pre-loaded in WhatsApp when the button is clicked. Leave empty to open WhatsApp without any pre-filled message.

The floating button uses your store's default WhatsApp number from General Settings. It does not use number routing, so all floating button clicks go to the same number.

Multi-channel floating slots

In addition to the main WhatsApp button, the Floating tab provides three independent extra slots (Slot 1, Slot 2, Slot 3). Each slot can be assigned to any other supported channel (Messenger, Instagram, iMessage, RCS, or Snapchat) and stacks visually above the main WhatsApp button in the screen corner.

Like the main WhatsApp floating button, all extra slots are for general inquiries and direct contact. They do not trigger a checkout form or create a WooCommerce order.

Each extra slot is configured independently with:

  • Channel: which messaging app to open (Messenger, Instagram, iMessage, RCS, or Snapchat).
  • Identifier: the phone number or username for that channel.
  • Pre-filled message (on channels that support it).
  • Mobile bottom margin override for that slot.
Multi-channel floating slots stacked in the screen corner
Three extra floating slots stacking above the main WhatsApp button.

Number Routing

Number Routing allows you to send orders to different WhatsApp numbers based on the product category. This is ideal for stores where different teams, departments, or individual sellers manage different product lines.

The Routing tab showing three product categories, each routed to a different WhatsApp number.

How Routing Works

When a customer clicks the WhatsApp button on a product page, ChatCart Pro checks the product's assigned categories and looks for a matching routing rule:

  1. ChatCart Pro reads the product's WooCommerce categories.
  2. It checks the routing rules configured in Settings → Routing.
  3. If a matching rule is found, the order message is sent to the number specified for that category.
  4. If no matching rule is found (or the product has no category), the default number from General Settings is used as a fallback.

Configuring Routing Rules

  1. Go to ChatCart Pro → Settings → Routing.
  2. Click Add Rule.
  3. Select a product category from the dropdown. All WooCommerce product categories are listed.
  4. Enter the WhatsApp number for that category in international format (e.g., 5511988887777).
  5. Save. Repeat for each category that should route to a different number.

Multi-Category Products

If a product belongs to multiple categories and more than one routing rule matches, the rule for the first matching category found takes priority. We recommend assigning products to a single primary category to avoid ambiguity.

Mixed-Category Carts

When a customer checks out with a cart that contains products from different categories (each with a different routing rule), ChatCart Pro uses a first-item-wins rule: it scans the order items in sequence and uses the WhatsApp number from the first item whose category has a routing rule configured.

This behavior is intentional and predictable. The alternative (last item, random item, or splitting the order) would create a worse experience.

Important: Important: Make sure every routed number is actively monitored. If a number is unreachable or not a valid WhatsApp number, the customer will see an error when WhatsApp opens.

Analytics Dashboard

ChatCart Pro includes a built-in analytics dashboard that tracks every click on every button the plugin adds to your store: WhatsApp checkout buttons, contact channel buttons, and floating button slots. Each button type and channel is tracked independently, so you can see exactly which buttons and platforms your customers engage with. No external services or Google Analytics required. All data is stored locally in your WordPress database.

The Analytics dashboard shows every WhatsApp button click with timestamp, product, and page context.

Accessing Analytics

After activating your license key, a CCP Analytics entry will appear in your WordPress admin sidebar. Go to CCP Analytics to access the dashboard. This is a separate admin page from the main ChatCart Pro settings.

What Is Tracked

Each time a customer clicks any ChatCart Pro button, a click event is recorded in the wp_ccp_click_events database table. The following data points are stored per click:

  • Timestamp: The date and time of the click.
  • Product ID: The WooCommerce product the button was on (0 for floating button clicks).
  • Page Type & Channel: Where the click came from and which channel was used (for example: product page → Messenger, floating → WhatsApp, checkout → WhatsApp. Each channel is tracked individually, giving you a per-channel breakdown in the dashboard).
  • Device Type: Whether the click came from a mobile or desktop device.

Dashboard widgets

The analytics dashboard is organized into several views, all loaded in real time from your WordPress database:

  • Summary cards: Total clicks, unique products clicked, average clicks per day, and total floating button clicks, each with a sparkline trend indicator and a comparison to the previous period.
  • Daily click chart: A 14-day bar chart comparing the current period to the previous one. Bars are broken down by entry point so you can see which buttons drive the most activity each day.
  • Entry point breakdown: A ranked view of which buttons customers click most: product page WhatsApp, floating WhatsApp, Messenger contact button, Instagram contact button, cart button, checkout button, and so on.
  • Click heatmap: A 7 × 24 grid showing click density by day of week and hour of day. Useful for identifying peak engagement windows and planning staffing.
  • Products table: Ranked list of products by click count with a time-range filter (today, last 7 days, last 30 days, all time) and trend indicators (up / flat / down).
  • Insights: Automatic highlights: most-clicked entry point, products with repeat clicks in the period, and today’s running total.

Per-channel tracking

Every click is recorded with its exact channel identifier. For example, a click on the Messenger contact button on a product page is stored as channel_messenger, while a click on the floating Instagram slot is floating_instagram. This means the entry point breakdown and products table show you precisely which channels your customers prefer, not just a generic “button click.”

CSV export

The analytics page includes a Download CSV button that exports the complete click history to a spreadsheet (OOXML format, compatible with Excel and Google Sheets). Each row contains the product ID, product name, entry point and channel, device type, and timestamp.

Using the Data

The analytics table is sorted by most recent first and is searchable. Use this data to:

  • Identify your most "WhatsApp-active" products.
  • Monitor button usage trends over time.
  • Verify that routing rules are working correctly.
  • Estimate the volume of orders being handled via WhatsApp.

Privacy note: The analytics table only stores anonymous click events (no customer names, phone numbers, or IP addresses are recorded there). Customer data collected at checkout is saved as a WooCommerce order on your server, but is not included in the analytics data.

WhatsApp Checkout Toggle

ChatCart Pro includes a master toggle in the General settings tab that lets you enable or disable the entire WhatsApp checkout flow with a single switch, without losing any of your configuration.

WhatsApp Checkout Toggle in the General tab
The master toggle is always visible at the top of the General tab.

What the toggle controls

When the WhatsApp Checkout toggle is off:

  • No WhatsApp buttons appear on product pages, the cart, or the checkout page.
  • The standard WooCommerce checkout flow is restored automatically.
  • All your button labels, message templates, payment methods, and field configuration are preserved.

When the toggle is turned back on, all settings are restored exactly as you left them.

WhatsApp number is always active. The WhatsApp number field and the Floating Button are independent of this toggle. The floating button will still appear even when the checkout flow is disabled.

Contact Channel Buttons

Contact Channel Buttons add independent messaging buttons to your product pages so customers can reach your store on their preferred platform, without going through a checkout form. Each button opens a direct conversation in the corresponding app. This feature is designed for inquiries, questions, and pre-sale support, not for order placement.

Six channels are supported. Each is enabled and configured independently in ChatCart Pro → Settings → Channels:

Enabling and configuring contact channel buttons in the Channels tab.
ChannelOpensPre-filled message
WhatsAppWhatsApp chat (app or Web)Yes (optional custom message)
MessengerFacebook Messenger conversationNo (opens chat directly)
Instagram DMInstagram Direct thread (ig.me/m/)No (opens DM directly)
iMessageiMessage / SMS composeYes (optional custom message)
RCSRCS / Google Messages conversationYes (optional custom message)
SnapchatSnapchat chat / add-friendNo (opens profile directly)

What happens when a customer clicks

The button opens the channel’s native app or web interface, placing the customer directly into a conversation with your account. There is no checkout form, no WooCommerce order is created, and no redirect logic is involved; the customer simply starts a chat.

WhatsApp, iMessage, and RCS buttons support an optional pre-filled message that you configure per channel in the admin. Messenger, Instagram, and Snapchat open the DM interface without a pre-filled message; those platforms do not support deep-link message pre-population.

Contact buttons vs. WhatsApp Checkout

The WhatsApp Checkout button (visible on product and cart pages) triggers the full purchase flow: checkout form → WooCommerce order creation → WhatsApp redirect with a structured order summary. Contact Channel Buttons are entirely separate: they create no order, show no form, and open a plain chat.

You can also add a dedicated WhatsApp contact button from the Channels tab. This is independent of the WhatsApp Checkout button: it is a simple contact shortcut with an optional custom message, and works even when the WhatsApp Checkout toggle is off.

Number routing does not apply to contact buttons

Number routing rules only affect the WhatsApp Checkout flow. Contact Channel Buttons always open the identifier you configured in the Channels tab, regardless of any routing rules.

Brand colours. Each channel button uses its official brand colour automatically: WhatsApp green, Messenger blue, Instagram gradient, iMessage blue, RCS blue, Snapchat yellow. No configuration needed.

Checkout Form Fields

ChatCart Pro includes a fully customizable checkout form with 19 configurable fields, drag-and-drop reordering, input masking, automatic address lookup, and direct mapping to WooCommerce order billing data. The Checkout Fields system works independently as a standalone form builder for your store, not tied exclusively to the WhatsApp checkout flow.

Managing and reordering checkout form fields in the Fields tab.

Available fields

Every field can be individually enabled or disabled, marked as required or optional, set to half-width or full-width, and given a custom label and placeholder. The complete field set includes:

  • Personal: First Name, Last Name, Email, Phone
  • Address: Street Address, Address Number, Neighborhood, Complement, City, State, Postcode, Country
  • Order: Order Notes
  • Tax / Document IDs (disabled by default): CPF (Brazil), CNPJ (Brazil business), SSN (US), EIN (US business), VAT Number (EU), My Number (Japan)
  • Alternative phone formats (disabled by default): Phone (US), Phone (EU), Phone (International)
  • Alternative postcode formats (disabled by default): ZIP Code (US), Postal Code (EU)

Input masking and validation

Fields with specific formats include built-in input masks that guide customers as they type. For example, CPF auto-formats as 000.000.000-00, SSN as 000-00-0000, and CEP as 00000-000. Tax ID fields also perform format validation: SSN rejects invalid patterns (area code 000/666/900+, repeated sequences); VAT EU validates the country prefix.

CEP auto-lookup

When the Postcode field is enabled and a customer types a valid 8-digit Brazilian CEP, ChatCart Pro queries the ViaCEP public API and automatically fills in the City and State fields. No personal data is sent (only the CEP digits).

WooCommerce order mapping

Every enabled field maps directly to a WooCommerce billing field on the order record. Standard fields (name, email, phone, address, city, state, postcode, country) are stored as native WooCommerce billing data. Additional fields (CPF, CNPJ, SSN, Order Notes, etc.) are saved as order meta and are visible in the WooCommerce order detail screen in the admin.

Drag-and-drop reordering

Fields can be reordered by dragging rows in the Fields tab. The order in the admin panel matches the order shown to customers in the checkout form. Put your most important fields (name, phone) at the top to reduce friction.

Use it independently. The Checkout Fields form works even when the WhatsApp Checkout toggle is off. For example, you can use it to collect customer data via a contact channel and still have a structured, validated form experience, just without the WooCommerce order creation step.