=== ChatCubo ===
Contributors: hostalcubo
Donate link: https://paypal.me/hostingalcubo
Tags: chat, ai, chatbot, assistant, groq
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A floating AI chat assistant for your site. It answers visitors using Groq (Llama / GPT-OSS) and your own knowledge base. Configured from the dashboard.

== Description ==

ChatCubo adds a floating chat widget to your WordPress site. Visitors ask questions and an AI assistant answers using the Groq API and the knowledge you provide about your business (services, prices, hours, FAQs).

Everything is configured from the dashboard: paste your Groq API key, pick a model, set your business name and knowledge base, and the widget appears on the front end.

= Features (free) =

* **AI chat widget** powered by the Groq API, using your own API key and model (GPT-OSS 120B / 20B, Llama 3.3).
* **Knowledge base:** the assistant answers based on the information you paste about your business.
* **Basic identity:** business name and avatar in the chat header.
* **Lightweight:** the widget only loads when an API key is configured.

= Pro version (optional, separate) =

A separate Pro version turns the basic assistant into a complete tool that engages and sells:

* Conversation memory (the assistant keeps the context of the chat).
* Custom colors and a WhatsApp button.
* Auto-open the chat after N seconds.
* Lead capture (name, email and interest) into a database.
* Email alert for each new lead, CSV export and a "book a meeting" (Calendly) button.

The free version is a fully functional AI assistant on its own. More info: https://hostalcubo.com.ar/chatcubo

== External services ==

This plugin connects to a third-party AI service to generate the chat replies.

**Groq API (api.groq.com) — required for the chat to work**
When a visitor sends a message, the plugin sends that message (with your business name and your knowledge base) to the Groq API to generate a reply, using the API key you provide.

* Data sent: the visitor's message, your configured business name and knowledge base, and your API key (in the request authorization header).
* Data received: the AI-generated reply text.
* When it happens: every time a visitor sends a message in the chat.
* Provider: Groq, Inc. Terms: https://groq.com/terms-of-use/ — Privacy policy: https://groq.com/privacy-policy/

The plugin does not store the conversations on your site. We recommend mentioning this AI processing in your site's privacy policy.

== Installation ==

1. Upload the `chatcubo` folder to `/wp-content/plugins/`, or install the .zip from Plugins → Add New → Upload Plugin.
2. Activate the plugin.
3. Go to ChatCubo → Settings.
4. Paste your Groq API key from console.groq.com and pick a model.
5. Set your business name and knowledge base.
6. Save. The chat appears on your site, bottom right.

== Frequently Asked Questions ==

= Do I need a Groq account? =
Yes. ChatCubo uses your own Groq API key so the AI usage is under your control. You can get a free key at console.groq.com.

= Where does the visitor's message go? =
To the Groq API, to generate the reply. See the "External services" section above. The plugin does not store conversations on your site.

= Can I change how the assistant talks? =
Yes, through the knowledge base and business name. The assistant answers based on what you write there.

= Does it remember the conversation or capture leads? =
Conversation memory and lead capture (name, email and phone to a database, email alerts and CSV export) are part of the Pro version. The free version is a knowledge-based assistant that answers each question on its own.

= The chat doesn't appear. Why? =
The widget only loads when a valid API key is configured in ChatCubo → Settings.

== Screenshots ==

1. The chat widget open on the front end.
2. ChatCubo settings: AI engine, identity and knowledge base.
3. The "How to use" help screen.

== Changelog ==

= 1.1.0 =
* The free version is now focused on the essentials: AI chat, knowledge base and basic identity (business name + avatar).
* Conversation memory, custom colors, WhatsApp button and auto-open moved to the Pro version.

= 1.0.0 =
* First public version for the WordPress.org directory.

== Upgrade Notice ==

= 1.1.0 =
Streamlined free version. Memory, colors, WhatsApp and auto-open are now part of ChatCubo Pro.
