=== CalicoDesk ===
Contributors: calicodesk
Tags: live chat, chatbot, ai, helpdesk, customer support
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress site to CalicoDesk and add AI-powered live chat, chatbots, and helpdesk support for your visitors.

== Description ==

CalicoDesk connects your WordPress site to the [CalicoDesk](https://calicodesk.com/) customer support platform. Once connected, the CalicoDesk live chat widget is added to your site so visitors can chat with your team or your AI agents.

**Features**

* One-click connection — sign in with your CalicoDesk account from wp-admin
* Sync and manage your CalicoDesk workspaces from WordPress
* Enable or disable the live chat widget per workspace with a single toggle
* Live chat, AI chatbot, and helpdesk features powered by the CalicoDesk platform (ticketing, automation, knowledge base, analytics managed in your CalicoDesk dashboard)

**A CalicoDesk account is required.** This plugin is a connector for the CalicoDesk service; chat conversations, AI agents, and helpdesk features run on the CalicoDesk platform. Create an account at [calicodesk.com](https://calicodesk.com/).

== External Services ==

This plugin relies on CalicoDesk, a third-party customer support service, and does not function without it.

**What the plugin connects to and what data is sent:**

1. **Authentication (admin only):** When a site administrator signs in from the CalicoDesk settings page, the email address and password they enter are sent over HTTPS to `https://calicodesk.com/api/v1/wordpress/sign-in` to obtain an API token. The token and email address are stored in your WordPress database. The password is never stored.
2. **Workspace sync (admin only):** The plugin sends the stored API token to `https://calicodesk.com/api/v1/me/workspaces` to fetch the list of workspaces on your account.
3. **Live chat widget (site visitors):** When live chat is enabled for a workspace, every frontend page loads a script from `https://<your-workspace>.calicodesk.com/livechat-loader.js`. Loading this script transmits standard request data (such as the visitor's IP address, browser user agent, and the page URL) to CalicoDesk, and any messages a visitor types into the chat widget are processed by the CalicoDesk platform, including its AI features.

No data is sent to CalicoDesk until an administrator connects an account, and no visitor data is sent until live chat is enabled for a workspace. Disconnecting the account or disabling the workspace stops all data transmission.

This service is provided by CalicoDesk: [Terms and Conditions](https://calicodesk.com/terms-and-conditions), [Privacy Policy](https://calicodesk.com/privacy-policy).

== Installation ==

1. Upload the `calicodesk` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **CalicoDesk → Sign / Signup** in the admin menu and sign in with your CalicoDesk account.
4. Go to **CalicoDesk → Workspaces** and toggle live chat on for the workspace you want to use.

== Frequently Asked Questions ==

= Do I need a CalicoDesk account? =

Yes. This plugin connects your site to the CalicoDesk platform. You can create an account at [calicodesk.com](https://calicodesk.com/).

= What data does this plugin share with CalicoDesk? =

Administrator credentials are sent once at sign-in to obtain an API token. When live chat is enabled, visitor request data and chat messages are processed by CalicoDesk. See the External Services section for full details.

= Is visitor data sent to CalicoDesk before I enable live chat? =

No. Nothing loads on the frontend until an administrator connects an account and enables live chat for a workspace.

= How do I remove the widget from my site? =

Toggle the workspace off under **CalicoDesk → Workspaces**, or disconnect your account under **CalicoDesk → Sign / Signup**. Uninstalling the plugin removes all stored CalicoDesk data from your database.

= Does this plugin require WooCommerce? =

No. CalicoDesk does not require WooCommerce.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release of CalicoDesk.
