JX WhatsApp Assistant helps visitors quickly connect with the right person or department through WhatsApp while giving site owners full control over agents, schedules, fallback forms, analytics, and design.

This module is ideal for businesses, service providers, agencies, e-commerce stores, real estate sites, education websites, clinics, consultants, and any Joomla site that wants faster visitor communication through WhatsApp.

Important note: this module does not create an in-site WhatsApp live chat client. WhatsApp does not provide that kind of API access for a normal website module. Instead, JX WhatsApp Assistant opens WhatsApp Web or the WhatsApp mobile app using clean wa.me links with optional prefilled messages and visitor context.

Key Features

Multi-Agent WhatsApp Support

• Add multiple WhatsApp agents from the Joomla module settings.
• Configure each agent with name, role, department, tags, avatar, phone number, custom message, priority, and schedule.
• Display a clean list of support contacts inside the floating widget.
• Show online and offline badges for each agent.
• Use department filtering for Sales, Support, Billing, Technical Help, or any custom team.

Smart Agent Routing

• Priority routing: online agents first, then highest priority first.
• First online: promote the first available online agent.
• Random online: promote a random available agent.
• Round robin: rotate promoted online agents during the visitor session.
• Great for teams that want to distribute enquiries across available agents.

Working Hours and Availability

• Set a global timezone.
• Configure global working days and hours.
• Add holiday or closed dates.
• Let agents inherit global hours or use custom schedules.
• Mark agents as always online or always offline.
• Support overnight time windows.
• Automatically show fallback when all agents are offline.

WhatsApp Message Tokens

Create better first messages with dynamic context:

• {{page_url}}
• {{page_title}}
• {{site_name}}

Example:

```text
Hello, I need help with {{page_title}}.

{{page_url}}
```

The module sanitizes phone numbers and URL-encodes messages for safe WhatsApp links.

Optional Pre-Chat Qualification

Collect visitor details before sending them to WhatsApp:

• Name
• Email
• Phone
• Message
• Topic / interest
• Consent checkbox

Required field validation runs before the WhatsApp link opens. The collected details are appended to the WhatsApp message so agents receive useful context immediately.

Offline Email Fallback

When no agents are online, the module can show an email fallback form so you do not lose leads.

Fallback form features:

• Custom heading and intro text.
• Recipient email setting.
• Custom email subject and body intro.
• Optional phone field.
• Joomla mail integration.
• CSRF-protected AJAX submission.
• Page URL and page title context in email content.

Complete Style Control

Style the widget directly from module parameters.

Theme presets:

• WhatsApp
• Minimal
• Glass
• Dark
• Gradient
• Outline
• Rounded
• Compact

Custom controls:

• Widget position: bottom right, bottom left, bottom center, side right, side left.
• Launcher background and icon color.
• Panel background and text colors.
• Muted text color.
• Accent color.
• Border color.
• Online and offline badge colors.
• Launcher size and icon scale.
• Panel width and radius.
• Avatar size.
• Shadow strength.
• Z-index.
• Typography source, base font size, and heading weight.
• Google Font family and weights.
• Animation type and duration.
• Custom CSS.

All generated styles are scoped to the module instance, so multiple instances can use different styling without conflicts.

Analytics and Event Hooks

Track visitor engagement with optional analytics hooks.

• Push events to window.dataLayer.
• Configure event names for widget open, agent click, and fallback submit.
• Dispatch browser CustomEvents:
  • jx:whatsapp:open
  • jx:whatsapp:agent
  • jx:whatsapp:fallback-submit

This makes the module easy to integrate with Google Tag Manager, custom analytics, or conversion tracking.

Responsive and Accessible

• Floating desktop panel.
• Mobile-friendly bottom sheet behavior.
• Keyboard-openable launcher.
• Escape key closes the panel.
• ARIA dialog attributes.
• Visible focus states.
• Touch-friendly 44px minimum target sizes.
• Reduced motion support with prefers-reduced-motion.
• Vanilla JavaScript frontend with no jQuery runtime dependency.

Joomla 4, 5 and 6 Compatible

• Built as a Joomla site module.
• Uses Joomla WebAssetManager for CSS and JavaScript loading.
• Uses Joomla language files.
• Uses Joomla mail APIs for fallback messages.
• Uses com_ajax for fallback submissions.
• Modern PHP implementation.

Perfect For

• Customer support
• Sales enquiries
• Lead generation
• Product consultation
• Service businesses
• Real estate enquiries
• Clinics and appointment enquiries
• Education admissions
• E-commerce support
• Agencies and consultants
• Local business websites
• Multi-department contact widgets

Why Choose JX WhatsApp Assistant?

JX WhatsApp Assistant is more than a simple WhatsApp floating button. It gives Joomla site owners a structured support widget with agents, schedules, fallback capture, analytics, and deep styling controls while staying lightweight and easy to manage from module parameters.

If your site needs a professional WhatsApp contact experience with multi-agent routing and offline lead capture, JX WhatsApp Assistant is built for that.