=== Costello AI Chat ===
Contributors: costellohq
Tags: chat, ai, chatbot, customer support, live chat
Requires at least: 5.9
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

Add the Costello AI chat widget to your WordPress site in seconds.

== Description ==

[Costello](https://costellohq.com) is an AI receptionist that qualifies leads and answers questions in real time via a chat widget on your site.

This plugin injects the Costello widget script on every page of your site. No coding required — click **Connect to Costello**, approve, and you're live.

**Features:**

* One-click connect — link your Costello account with a single button, no copy-pasting.
* Enable / disable toggle without touching any code.
* Works with any theme.
* No build step, no dependencies.

**Getting started:**

1. Install and activate this plugin.
2. The **Settings → Costello Chat** page opens automatically.
3. Click **Connect to Costello** and approve the connection. Your widget goes live instantly on every page.

Prefer to do it by hand? You can paste your Agent ID manually instead — find it in your [Costello dashboard](https://platform.costellohq.com/app) under **Integrations → Chat Widget**.

== External services ==

This plugin connects your site to Costello, an external AI chat service operated by Costello, to provide the live chat widget. A Costello account is required to use the plugin.

The plugin relies on the Costello service in two ways:

* **Loading the chat widget.** On every front-end page, the plugin loads the widget script from `https://platform.costellohq.com/widget/v1.js`, tagged with your Agent ID. When a visitor opens the chat, their messages are sent to Costello to generate replies. The conversation data visitors enter (such as their questions, name, or contact details) is processed by Costello.
* **Connecting your site.** When you click "Connect to Costello", the plugin sends your site's URL to `https://platform.costellohq.com/connect/wordpress` so you can approve the connection and receive your Agent ID. No data is sent to Costello until you actively connect or a visitor uses the widget.

Use of the Costello service is governed by Costello's Terms of Service (https://costellohq.com/terms) and Privacy Policy (https://costellohq.com/privacy).

== Installation ==

1. In your WordPress dashboard, go to **Plugins → Add New** and search for "Costello". Click **Install Now**, then **Activate**. (Or upload the `costello-ai-chat` folder to `/wp-content/plugins/` manually.)
2. The **Settings → Costello Chat** page opens automatically after activation.
3. Click **Connect to Costello** and approve — your widget goes live instantly. Prefer to do it by hand? Paste your Agent ID into the manual field instead.

== Frequently Asked Questions ==

= Where do I find my Agent ID? =

Log in to [platform.costellohq.com](https://platform.costellohq.com/app), go to **Integrations → Chat Widget**, and copy the Agent ID shown on the page.

= Can I disable the widget without uninstalling the plugin? =

Yes. Go to **Settings → Costello Chat** and uncheck the **Widget status** checkbox, then save.

= Does the widget load on every page? =

Yes. The script is injected into `wp_footer` globally so it appears on all front-end pages.

== Screenshots ==

1. Settings page — enter your Agent ID and enable/disable the widget.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
