=== CresentAI Chatbot ===
Contributors: vkinyua
Tags: chatbot, ai, customer support, lead generation,live-chat
Requires at least: 5.0
Tested up to: 6.9  
Stable tag: 1.0.4
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free Plug-and-play trainable AI website chatbot with live chat feature. 2 minutes setup, perfect for lead generation, FAQs, and customer support.

== Description ==

CresentAI Chatbot adds a customizable AI-powered chat widget to your WordPress website.

== Key Features ==

* Quick setup: Signup for free API key from chatbot.cresentai.com
* Customization: Adjust colours, modes (expanded/collapsed), titles, prompts, and more via the settings page.
* AI responses: Resolve 80% of customer queries without human intervention.
* Live Chat Mode: Toggle between live agent and AI responses (e.g., automated during weekends, holidays, or night time).
* Multi-user support: Add, remove, or disable agent users.
* Analytics: Track customer questions, view statistics, and optimize support.
* Conversation tracking: Preview, search past conversations, and mark as handled.
* Chat ratings: Allow users to rate sessions (1-5 stars) for feedback and improvement.
* Automatic escalation: AI flags unresolved chats for human review.
* Trainable AI: Upload documents (Word, PDF, text) or paste content to train the chatbot.
* Optional user details collection: Enforce name & email capture before chats (configurable).

**Important: This plugin requires connection to external services**
The plugin loads a JavaScript file from Cloudflare Pages and communicates with the CresentAI backend API.

**External services used:**

1. **Chatbot frontend script**
   - Domain: https://cresentai.pages.dev
   - Purpose: Loads the chat widget interface and handles frontend rendering & user interaction
   - What is sent: Only the API key you provide in settings + messages typed by your visitors
   - When: Every page load (when API key is set)
   - Links:
     - Terms of Use: https://chatbot.cresentai.com/terms
     - Privacy Policy: https://chatbot.cresentai.com/privacy-policy

2. **CresentAI Backend API**
   - Domain: https://api2.cresentai.com (API endpoint for chat processing)
   - Purpose: Processes messages, provides AI responses, handles live chat routing, stores conversation history. All chat data is processed and stored on CresentAI servers.
   - What is sent: Chat messages, optional visitor name/email (if mandatory collection enabled), site URL, API key
   - When: When visitor sends message or when mandatory details are collected
   - Links:
     - Terms of Use: https://chatbot.cresentai.com/terms
     - Privacy Policy: https://chatbot.cresentai.com/privacy-policy

You need to register and get a free API key at https://chatbot.cresentai.com to use this plugin.

== Installation ==

1. Upload and activate the plugin
2. Go to Settings → CresentAI Chatbot
3. Enter your API key (get it at https://chatbot.cresentai.com)
4. Customize colors, modes, and prompts as needed.
5. The chatbot widget will appear on your site's frontend.

== Frequently Asked Questions ==

= How do I get an API key? =
Register for free at https://chatbot.cresentai.com

= What data is sent to CresentAI? =
Visitor chat messages + optional name/email (if collection is enforced). Site URL and your API key are also sent.

= Is the chatbot customizable? =
Yes, adjust themes, colors, and prompts in the settings.

= Is there a privacy policy for the service? =
Yes → https://chatbot.cresentai.com/privacy-policy

== Changelog ==

= 1.0.3 =
* Cosmetic changes in description.
* Added Author url

= 1.0.2 =
* Use proper wp_enqueue_script() instead of direct echo
* Improved external service documentation in readme

= 1.0.1 =
* Initial release