Jx Whatsapp Assistant

Global and Per-Agent Schedules
Define global working days and hours, then let agents inherit the schedule or override it with custom hours.

Always Online / Always Offline
Set individual agents to always online, always offline, inherited schedule, or custom availability.

Holiday Support
Add closed dates so scheduled agents automatically appear offline on holidays while always-online agents can remain available.

Dynamic Message Tokens
Use {{page_url}}, {{page_title}}, and {{site_name}} in agent messages to send visitors into WhatsApp with useful page context.

Clean WhatsApp URLs
Phone numbers are sanitized into safe wa.me links and messages are URL encoded correctly.

Desktop and Mobile Friendly
The widget redirects users to WhatsApp Web or the WhatsApp mobile app depending on their device and browser.

Lead Qualification Fields
Ask for name, email, phone, topic, message, and consent before opening WhatsApp.

Flexible Required Rules
Make name, email, and consent required only when needed. Validation runs before the WhatsApp link opens.

Appended Conversation Context
Collected pre-chat details are appended to the WhatsApp message so agents receive better context immediately.

Fallback Form
When no agents are online, show a clean email fallback form instead of leaving visitors without a contact option.

Joomla Mail Integration
Fallback submissions use Joomla's native mailer and CSRF token protection.

Custom Email Content
Configure recipient, subject, intro text, phone collection, and page context tokens for fallback messages.

Theme Presets
Choose from WhatsApp, minimal, glass, dark, gradient, outline, rounded, and compact styles.

Full Visual Customization
Control launcher colors, icon color, panel background, text colors, accent color, borders, badge colors, sizes, radius, shadow, z-index, spacing, typography, animation, and custom CSS.

Scoped CSS
Dynamic styling is scoped per module instance so multiple widgets can have different designs without conflicts.

GTM / Data Layer Support
Optionally push configurable events for widget open, agent click, and fallback submission.

Browser CustomEvents
Dispatch jx:whatsapp:open, jx:whatsapp:agent, and jx:whatsapp:fallback-submit events for custom integrations.

Configurable Event Names
Set custom event names for your analytics or tag manager workflow.

Joomla Menu Assignment
Use standard Joomla module assignment to publish the widget on selected pages.

URL Include and Exclude Patterns
Add optional URL patterns to show or hide the widget on specific URLs beyond Joomla's native menu assignment.

Exclude Wins
When include and exclude rules both match, exclude rules take priority for predictable control.

Mobile Bottom Sheet
On small screens, the panel behaves like a mobile-friendly bottom sheet.

Keyboard Friendly
The launcher, close button, and agent actions are keyboard accessible with visible focus states.

Reduced Motion Support
Animations respect prefers-reduced-motion to improve accessibility.

Modern Joomla APIs
Built with Joomla module conventions, WebAssetManager asset loading, com_ajax fallback handling, language files, and scoped output.

No jQuery Runtime Dependency
Frontend behavior is implemented in lightweight vanilla JavaScript.

Tested Locally
Includes a smoke-test script and a full field-by-field test matrix for validation.