=== Chatly ===
Contributors: mediamanagementcorp
Tags: chatbot, ai, lead capture, chat, support
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.3.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered chatbot for WordPress. Capture leads, answer questions 24/7, and engage visitors automatically.

== Description ==

Chatly is an AI-powered chatbot plugin that helps WordPress site owners engage visitors, answer questions automatically, and capture leads 24/7.

**Free Version Features:**

* 🤖 **AI-Powered Conversations** - Uses Claude (Anthropic) or ChatGPT (OpenAI)
* 💬 **Basic Lead Capture** - Collect visitor information
* 📧 **MailPoet Integration** - Connect with MailPoet email lists
* 🎨 **Customizable Appearance** - Match your brand colors
* 📱 **Mobile Responsive** - Works on all devices

**Free Version Limitations:**

The free version is fully functional but designed for smaller sites:
* Basic customization options
* MailPoet integration only
* No conversation limits (you pay for API usage directly)
* Community support via WordPress.org forums

**Pro Version Adds:**

* 🔓 **Unlimited Conversations** - No restrictions
* 📧 **All Email Integrations** - Mailchimp, Constant Contact, AWeber, Webhooks
* 📊 **SEO Insights & Analytics** - Discover content opportunities from visitor questions
* 🗂️ **Advanced Knowledge Base** - Create comprehensive Q&A libraries
* 💌 **AI Message Generator** - Auto-generate welcome messages and prompts
* 🔍 **Yoast SEO Integration** - Content gap analysis
* 📨 **Admin Transcript Emails** - Auto-send transcripts to admin
* 🏷️ **Source Tracking** - Tag leads by source
* 🛠️ **Diagnostics Tool** - Built-in troubleshooting
* 👨‍💻 **Priority Support** - Direct email support

[Upgrade to Chatly Pro](https://hellochatly.com/pricing/) for unlimited features and priority support.

**How It Works:**

1. Install Chatly and activate the plugin
2. Get an API key from [Anthropic](https://console.anthropic.com) or [OpenAI](https://platform.openai.com)
3. Configure your AI provider in **Chatly → AI Provider**
4. Customize appearance and messages
5. The chatbot appears on your site automatically!

**Perfect For:**

* Small business websites
* Service providers
* Bloggers and content creators
* Anyone wanting automated visitor engagement

== Installation ==

1. Upload the `chatly` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to **Chatly → AI Provider** to configure your AI settings
4. Get an API key from [Anthropic](https://console.anthropic.com) or [OpenAI](https://platform.openai.com)
5. Paste your API key and test the connection
6. Customize your chatbot in **Chatly → General** and **Chatly → Appearance**
7. Your chatbot will appear on your site automatically!

**Note:** You'll need to add a payment method to your Anthropic or OpenAI account. API costs typically run $3-10/month for small sites.

== External Services ==

**IMPORTANT:** This plugin requires external API services to function. You must provide your own API keys and agree to the terms of these services.

= Required: AI Service (Choose One) =

**Anthropic Claude API**

* **What it does:** Powers the AI chatbot conversations
* **Data sent:** User chat messages, conversation history, your system prompt/instructions
* **When sent:** Every time a website visitor sends a message to the chatbot
* **User account required:** Yes - you must create an account at console.anthropic.com
* **API endpoint:** https://api.anthropic.com/v1/messages
* **API Documentation:** https://docs.anthropic.com/
* **Terms of Service:** https://www.anthropic.com/legal/consumer-terms
* **Privacy Policy:** https://www.anthropic.com/legal/privacy
* **Typical cost:** $3-10/month for small sites

**OR OpenAI ChatGPT API**

* **What it does:** Powers the AI chatbot conversations
* **Data sent:** User chat messages, conversation history, your system prompt/instructions
* **When sent:** Every time a website visitor sends a message to the chatbot
* **User account required:** Yes - you must create an account at platform.openai.com
* **API endpoint:** https://api.openai.com/v1/chat/completions
* **API Documentation:** https://platform.openai.com/docs
* **Terms of Service:** https://openai.com/policies/terms-of-use
* **Privacy Policy:** https://openai.com/policies/privacy-policy
* **Typical cost:** $3-10/month for small sites

= Optional: Email Marketing Integrations =

The free version includes MailPoet integration only. Pro version adds Mailchimp, Constant Contact, and AWeber.

**MailPoet (Included - No External API)**

* **What it does:** Adds captured leads to your MailPoet email lists
* **Data sent:** None - works entirely within WordPress
* **When sent:** N/A - local plugin integration only
* **User account required:** No external account needed
* **Plugin required:** MailPoet plugin must be installed
* **Terms:** https://www.mailpoet.com/terms/
* **Privacy:** https://www.mailpoet.com/privacy-notice/

**Mailchimp API (Pro Version Only)**

* **What it does:** Adds captured leads to your Mailchimp audience
* **Data sent:** Visitor name, email address, tags including "Chatly"
* **When sent:** When a visitor submits the lead capture form
* **API endpoint:** https://{{datacenter}}.api.mailchimp.com/3.0/
* **API Documentation:** https://mailchimp.com/developer/
* **Terms of Service:** https://mailchimp.com/legal/terms/
* **Privacy Policy:** https://mailchimp.com/legal/privacy/

**Constant Contact API (Pro Version Only)**

* **What it does:** Adds captured leads to your Constant Contact lists
* **Data sent:** Visitor name, email, phone (if collected), source note "Chatly"
* **When sent:** When a visitor submits the lead capture form
* **API endpoint:** https://api.cc.email/v3/contacts
* **API Documentation:** https://developer.constantcontact.com/
* **Terms of Service:** https://www.constantcontact.com/legal/terms-and-conditions
* **Privacy Policy:** https://www.constantcontact.com/legal/privacy-statement

**AWeber API (Pro Version Only)**

* **What it does:** Adds captured leads to your AWeber subscriber lists
* **Data sent:** Visitor name, email, tags: "chatly" and "website-lead"
* **When sent:** When a visitor submits the lead capture form
* **API endpoint:** https://api.aweber.com/1.0/
* **API Documentation:** https://api.aweber.com/
* **Terms of Service:** https://www.aweber.com/service.htm
* **Privacy Policy:** https://www.aweber.com/privacy.htm

= Data Privacy Notice =

When you use this plugin:

* Visitor chat messages are sent to your chosen AI provider (Anthropic or OpenAI)
* Chat transcripts are stored in your WordPress database
* If lead capture is enabled and a visitor provides their information, that data may be sent to your configured email marketing service
* You are responsible for complying with GDPR, CCPA, and other privacy regulations
* You should update your website's privacy policy to disclose the use of AI chatbot services and data collection

= No Data Sent to Plugin Developer =

This plugin does NOT send any data to the plugin developer (MediaManagement Marketing Services LLC). All API calls go directly from your WordPress site to the services YOU configure (Anthropic, OpenAI, MailPoet, etc.). We do not track, collect, or have access to your conversations or visitor data.

== Frequently Asked Questions ==

= Do I need coding knowledge? =

No! Chatly is designed for non-technical users. Everything is configured through simple WordPress admin settings.

= Which AI provider should I use? =

Both Claude (Anthropic) and ChatGPT (OpenAI) work great. Most users pick whichever they're already familiar with. Claude is known for thoughtful responses, while ChatGPT is the most widely-used AI assistant.

= How much do API costs run? =

Most small to medium sites spend $3-10 per month on API costs with either provider. You're charged based on conversation volume (tokens processed).

= Does it work with my theme? =

Yes! Chatly is designed to work with any WordPress theme. The chat widget loads independently of your theme's styling.

= What's the difference between Free and Pro? =

Free version includes basic chatbot functionality with MailPoet integration. Pro adds unlimited conversations, all email integrations, SEO insights, advanced knowledge base, AI message generator, priority support, and more advanced features.

= Can I upgrade to Pro later? =

Yes! You can [purchase Chatly Pro](https://hellochatly.com/pricing/) at any time. Your settings and conversations are preserved.

= What email services are supported? =

Free version: MailPoet only
Pro version: MailPoet, Mailchimp, Constant Contact, AWeber, Custom Webhooks

== Screenshots ==

1. Chatbot widget on your website
2. Admin settings dashboard  
3. Lead capture form in action
4. AI Provider configuration
5. Appearance customization

== Changelog ==

= 2.3.2 - 2024-12-07 =
* Removed: Custom CSS field (per WordPress.org guidelines - users can use WordPress Customizer → Additional CSS instead)
* Fixed: Parse error in admin panel affecting WordPress.org submission
* Improved: Code compliance with WordPress.org plugin guidelines

= 2.3.1 - 2024-12-06 =
* Fixed: All WordPress.org code compliance issues (316 total fixes)
* Fixed: Proper script and style enqueuing (removed hardcoded tags)
* Fixed: All output properly escaped for security
* Fixed: All prefixes updated to meet WordPress standards (chatly - 7 chars)
* Fixed: React and ReactDOM now loaded locally (no external CDN dependencies)
* Improved: External service documentation in readme
* Improved: Code quality and WordPress coding standards compliance
* Ready: Full WordPress.org compliance - approved for directory

= 2.3.0 - 2024-12-01 =
* New: Created free version for WordPress.org
* Maintained: Full compatibility with Pro version features
* Note: This is the free/community edition - [upgrade to Pro](https://hellochatly.com/pricing/) for advanced features

= 2.2.0 - 2024-11-27 =
* Added: Diagnostics tool for troubleshooting
* Added: AI message generator
* Improved: Knowledge Base search algorithm
* Fixed: MailPoet list dropdown issues
* Fixed: CSS conflicts with popular themes

= 2.1.0 - 2024-11-15 =
* Added: SEO Insights
* Added: Yoast SEO integration
* Added: Conversation analytics
* Added: Custom Knowledge Base

= 2.0.0 - 2024-11-01 =
* Added: Multi-provider support (Claude and ChatGPT)
* Added: Email integrations
* Added: Chat transcript emails
* Added: Lead management dashboard
* Improved: Complete UI redesign

= 1.0.0 - 2024-10-15 =
* Initial release

== Upgrade Notice ==

= 2.3.0 =
Free version released on WordPress.org. Upgrade to Pro for unlimited conversations, all integrations, SEO insights, and priority support.

== Support ==

**Free Version Support:**
* WordPress.org support forums
* [Documentation](https://hellochatly.com/docs)
* [FAQ](https://hellochatly.com/frequently-asked-questions)

**Pro Version Support:**
* Priority email support: support@mediamanagementcorp.com
* 24-48 hour response time
* Direct technical assistance

[Learn more about Chatly Pro](https://hellochatly.com/pricing/)

Developed by [MediaManagement Marketing Services LLC](https://mediamanagementcorp.com)
