ChatAssist by Ajay

A lightweight, privacy-first WordPress chat widget plugin that connects any chat URL (n8n workflows, custom AI bots, third-party providers) to your site — with analytics, A/B testing, WooCommerce integration, multi-widget profiles, and PWA push.

☕ Support this project

If this plugin saves you time or makes you money, consider tossing the maintainer a coffee. Every tip helps keep updates flowing and the support inbox open.

Even $3 for a coffee buys an hour of focused bug-squashing. 🙏

✨ Features

• Plug-and-play chat URL — drop any webhook URL (n8n, custom chat service, AI agent endpoint) and you're live
• Pre-chat lead form — capture name / email / phone before chat opens; pass to chat URL
• Smart display rules — show on specific pages, devices, days, times, user roles, geo locations
• WooCommerce-aware — target Shop / Product / Cart / Checkout / Account pages
• Built-in analytics — opens, closes, messages, conversions, daily breakdowns, PDF export
• A/B testing — split test variants of your chat experience
• Multiple widget profiles — different chat URLs per page (sales widget on /pricing, support on /docs)
• Live preview & zoom — see exactly how your widget looks before saving
• Goal & conversion tracking — WooCommerce order events and custom events
• Marketing tools — newsletter modal with exit-intent / on-chat-open / post-message timing
• PWA + push notifications — installable web-app manifest and Web Push (with external VAPID service)
• Native integrations — bootstrap snippets for Intercom, Crisp, Drift, Tawk.to, LiveChat
• Webhooks — outbound events to Slack, Discord, CRM (HubSpot/Salesforce formats), generic JSON
• GDPR consent banner — built-in consent flow before loading any tracking
• Accessibility-first — keyboard navigation, focus rings, screen-reader-friendly markup
• Fully translatable — .pot file included; loads .mo from /languages
• REST API — read-only analytics endpoints with capability checks

📦 Installation

From WordPress.org (recommended)

1. WP Admin → Plugins → Add New
2. Search "ChatAssist by Ajay"
3. Install → Activate
4. Navigate to ChatAssist by Ajay in the admin menu

From this repo

git clone https://github.com/ackm04/chatassist.git intelligizedigital-chatassist
zip -r intelligizedigital-chatassist.zip intelligizedigital-chatassist -x "*.git*" "*.DS_Store" "*/screenshots/*"
# Upload the zip in WP Admin → Plugins → Add New → Upload Plugin

🔧 Quick start

1. Activate the plugin
2. Open ChatAssist by Ajay in the WP admin menu
3. Paste your Chat URL (any chat webhook — n8n, AI bot, etc.)
4. Pick a position (right/left), color, and icon
5. Save — the widget appears on every front-end page

That's it. Browse the other tabs (Display Rules, Analytics, Marketing, Integrations) to fine-tune behavior.

🧰 Requirements

• WordPress 6.0 or higher
• PHP 7.4 or higher
• jQuery (bundled with WP core)
• HTTPS recommended (required for PWA, push, and most third-party chat embeds)

🔐 Security

All admin endpoints are nonce-protected and capability-gated (manage_ackm_chatassist capability with manage_options fallback). All user input is sanitized on save and escaped on output (esc_html, esc_attr, esc_url, wp_kses_post). All inline scripts use wp_add_inline_script() with wp_json_encode()'d data. SVG icons are rendered as <img> only (no inline embedding). Found a security issue? Please email ackm04@gmail.com rather than opening a public issue.

📜 Changelog

See readme.txt for the full changelog.

📄 License

This plugin is licensed under the GNU General Public License v2 or later. See LICENSE for full text or visit https://www.gnu.org/licenses/gpl-2.0.html.

💛 Made with love by Ajay

If you ship this on a client site or use it in production, drop me a line at ackm04@gmail.com — I love seeing how people use it.

☕ Buy me a coffee • ❤️ Sponsor on GitHub • 🌟 Star this repo