=== Zorachat ===
Contributors: Zorachat
Tags: ai chatbot, live chat, customer support, lead generation, woocommerce
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI customer support for WordPress trained on website content, PDFs, FAQs, and custom knowledge, with lead capture and human takeover.

== Description ==

Zorachat adds an AI-assisted support and live chat widget to WordPress. It can answer questions using site pages, posts, WooCommerce products, or a provided custom knowledge base, collect lead details, and let a human agent take over when needed.

The plugin supports two ways to generate AI responses:

* Connect your own supported AI provider API key.
* Connect to Zorachat Cloud Services and use Zora credits.

= Features =

* AI-assisted answers based on knowledge made available from your WordPress site
* Custom knowledge entries and frequently asked questions
* Live conversation monitoring
* Human takeover and return-to-AI controls
* Conversational lead capture
* Conversation and lead records stored in your WordPress database
* Configurable chat widget appearance and behaviour
* Support for OpenAI, Google Gemini, and Anthropic Claude API keys
* Optional Zorachat Cloud Services connection using Zora credits
* Optional mobile live-agent monitoring and push notifications
* Optional Slack and Telegram handoff integrations
* Optional image-aware conversations
* WooCommerce product-aware responses when WooCommerce is active; WooCommerce is not required


= Data storage and processing =

Conversation and lead records created by the plugin are stored in your WordPress database.

Local storage does not mean local-only processing. To generate a response, the plugin sends the visitor's message and relevant instructions or knowledge context to the AI service selected by the administrator. Enabled handoff integrations may also receive conversation information.


== Installation ==

1. Install Zorachat from the WordPress plugin screen, or upload the plugin files to `/wp-content/plugins/zorachat`.
2. Activate the plugin from the Plugins screen.
3. Open Zorachat in the WordPress administrator dashboard.
4. Review the external-service information and choose a provider.
5. Enter your own supported provider API key, or explicitly connect to Zorachat Cloud Services to use Zora credits.
6. Add or review the knowledge content the assistant may use.
7. Configure and preview the chat widget.


== Frequently Asked Questions ==

= Is an external AI service required? =

Yes. AI-generated responses require a supported provider API key or a connection to Zorachat Cloud Services using Zora credits.

= Where are conversations and leads stored? =

Conversations and lead records are stored in your WordPress database. Selected message content is still transmitted to the configured provider for processing.

= What data is sent to an AI provider? =

The plugin sends the visitor's message, assistant instructions, and relevant website, knowledge-base, FAQ, or WooCommerce product context needed for the request.

= Does Zorachat work with WooCommerce? =

Yes. When WooCommerce is active, Zorachat can use product information made available by the plugin. Zorachat does not require WooCommerce.

= Can a human take over a conversation? =

Yes. Authorized agents can monitor supported conversations and take over from the AI. Cloud-connected mobile monitoring and push notifications require Zorachat Cloud Services.

= Is the plugin free? =

The plugin code is GPLv2 or later. External providers may charge for their services. Zorachat Cloud Services may offer free or paid credits and plans.


== External Services ==

Zorachat uses external services only for features an administrator enables. All AI requests, including requests made with an administrator-supplied OpenAI, Gemini, or Anthropic API key, are sent first to `api.zorachat.ai` and relayed to the selected provider. Both Zorachat and that provider therefore process the request data. Conversation and lead records remain stored in the site's WordPress database.

= Zorachat widget service =

This service hosts the public Zorachat widget assets used on the front end of the site.

When the widget is enabled and a visitor loads a page where the widget appears, the visitor's browser requests the widget script from `widget.zorachat.ai`.

Data sent: standard HTTP request headers.

Why the data is sent: to deliver the widget to the visitor's browser.

Service: https://widget.zorachat.ai/zora-widget/wpWidget.v1.0.1.js
Terms: https://zorachat.ai/terms-and-conditions
Privacy Policy: https://zorachat.ai/privacy-policy

= Zorachat API relay =

This relay is used whenever OpenAI, Gemini, or Anthropic is selected. The plugin sends the selected provider, the provider API credential required to authenticate the request, the visitor's message, assistant instructions, relevant website, knowledge-base, FAQ, or WooCommerce context, and request metadata to `api.zorachat.ai`. Zorachat forwards the credential and request data to the selected provider and returns the generated reply to the site.

Purpose: to route the request to the selected provider and return its response.

API endpoint: https://api.zorachat.ai/
Terms: https://zorachat.ai/terms-and-conditions
Privacy Policy: https://zorachat.ai/privacy-policy

= Zorachat Cloud Services =

Zorachat Cloud Services is Zorachat's hosted service for Zora credits, managed AI replies, cloud-connected monitoring, mobile live-agent support, push notifications, account and plan management, and enabled third-party handoff workflows.

This service is used only when an administrator chooses Zora credits for cloud-connected features.

Data sent when connecting or managing the service: the site URL, site name, company name, administrator email address.

Data sent during use: visitor messages, assistant instructions, website and knowledge-base context, WooCommerce context if enabled, generated replies, lead information entered in the chat, enabled attachments and conversation metadata.

Why the data is sent: to generate replies, provision and validate Zora credits, sync knowledge content, support mobile monitoring and notifications, operate human handoff features, prevent abuse, and manage billing or credit usage.

Service: https://api.zorachat.ai/
Terms: https://zorachat.ai/terms-and-conditions
Privacy Policy: https://zorachat.ai/privacy-policy

= OpenAI API =

Used only when an administrator selects OpenAI and provides an OpenAI API key. The key and request data described under Zorachat API relay are sent through `api.zorachat.ai` and forwarded to OpenAI to generate the reply.

Service: https://openai.com/api/
Terms: https://openai.com/policies/services-agreement/
Privacy Policy: https://openai.com/policies/privacy-policy/

= Google Gemini API =

Used only when an administrator selects Gemini and provides a Gemini API key. The key and request data described under Zorachat API relay are sent through `api.zorachat.ai` and forwarded to Google to generate the reply.

Service: https://ai.google.dev/gemini-api
Terms: https://ai.google.dev/gemini-api/terms
Privacy Policy: https://policies.google.com/privacy

= Anthropic Claude API =

Used only when an administrator selects Anthropic and provides an Anthropic API key. The key and request data described under Zorachat API relay are sent through `api.zorachat.ai` and forwarded to Anthropic to generate the reply.

Service: https://www.anthropic.com/api
Terms: https://www.anthropic.com/legal/commercial-terms
Privacy Policy: https://www.anthropic.com/legal/privacy

= Slack =

Used only when an administrator enables Slack and provides the required credentials. Conversation content, identifiers, captured lead details, available customer contact details, handoff summaries, and notification metadata are sent to the configured Slack destination for notifications and human handoff.

Service: https://slack.com/
Terms: https://slack.com/main-services-agreement
Privacy Policy: https://slack.com/trust/privacy/privacy-policy

= Telegram =

Used only when an administrator enables Telegram and provides the required credentials. Conversation content, identifiers, captured lead details, available customer contact details, handoff summaries, and notification metadata are sent through the Telegram Bot API for notifications and human handoff.

Service: https://core.telegram.org/bots/api
Terms: https://telegram.org/tos
Privacy Policy: https://telegram.org/privacy

== Privacy ==

Zorachat stores plugin settings, conversation records, and captured lead records in the WordPress database. Depending on the configuration, chat content and related context are transmitted to the selected external service as described above.

Site administrators are responsible for:

* Providing an appropriate privacy notice to visitors
* Establishing a lawful basis and obtaining consent where required
* Configuring suitable data-retention practices
* Responding to requests to access, correct, export, or erase personal data
* Reviewing the terms and privacy practices of every enabled external service

Zorachat does not guarantee compliance with any particular privacy law or regulatory framework.

== Changelog ==

= 1.0.1 =

* Added AI-assisted chat based on WordPress knowledge content.
* Added support for OpenAI, Google Gemini, and Anthropic Claude API keys.
* Added optional Zorachat Cloud Services and Zora credits.
* Added live monitoring, human takeover, and return-to-AI controls.
* Added conversational lead capture.
* Added WooCommerce product-aware responses.
* Added configurable widget appearance and behaviour.
* Added optional mobile live-agent, Slack, and Telegram integrations.
* Added local WordPress database storage for conversation and lead records.

== Upgrade Notice ==

= 1.0.1 =

Initial public release of Zorachat for WordPress.
