=== Guzli - AI Chatbot for Customer Support & Lead Capture ===
Contributors: guzli
Tags: ai chatbot, chatbot, customer support, lead capture, chat widget
Requires at least: 5.9
Tested up to: 6.9
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 Guzli’s AI chatbot to your WordPress site to automate customer support and capture more leads.

== Description ==

Guzli is an AI Chatbot for Customer Support & Lead Capture. Install the Guzli chat widget on your WordPress site in minutes (no theme edits) and give visitors instant answers around the clock.

## Why use Guzli on WordPress?

- **AI customer support**: answer FAQs instantly and reduce repetitive tickets.

- **Lead capture**: collect qualified leads from high-intent visitors.

- **Fast setup**: install the plugin, paste your keys, and go live.

- **Works with any theme**: loads the widget sitewide and initializes automatically.

## Top features

- **Train on your content**: add websites, files, and text snippets so your chatbot answers using your real support material.

- **Instant, accurate answers**: respond in seconds using your knowledge base instead of generic replies.

- **Customer support automation**: reduce repetitive tickets by handling common questions automatically.

- **Lead capture**: collect contact details during chat and review captured leads in your dashboard.

- **Human handoff when needed**: route conversations to a human when a request needs follow-up.

- **Multi-channel support**: deploy on your website and connect additional channels like Slack from the Guzli dashboard.

- **Help center publishing (optional)**: host a public help center and keep articles in sync for consistent answers.

- **Analytics and reporting**: review conversations, lead capture outcomes, and coverage gaps so you can improve deflection over time.

- **Widget customization**: adjust colors, logo, avatar, theme (light/dark/system), launcher position, and copy.

- **Conversation starters + welcome message**: guide visitors with suggested questions and a branded introduction.

- **AI Search Bar mode**: swap the chat bubble for a docked AI search bar experience.

- **Prompt bubbles**: show rotating hints that nudge visitors to ask questions.

- **Business hours controls**: optionally hide the widget outside of your coverage window.

- **Identity verification (advanced)**: securely identify logged-in users using a signed token from your backend.

## Common use cases

- Customer support automation (deflect repetitive questions)
- Pre-sales Q&A and lead qualification
- Product discovery and onboarding
- Contact capture on high-intent pages (pricing, demo, checkout)
- AI chatbot for WooCommerce stores and service businesses (works with any WordPress theme)

## How it works

1. Create a Guzli account and an agent in the Guzli dashboard.
2. Create a client API key for the WordPress widget.
3. In WordPress, go to Settings > Guzli Options and paste:
   - API Key
   - Agent ID
4. The plugin loads the Guzli widget script sitewide and mounts it automatically.

== External services ==

This plugin relies on external services to load the chatbot widget and deliver AI responses.

1) Guzli widget script CDN (https://cdn.guzli.com/widget/latest/guzli.iife.js)
- Used to load the chat widget on your site.
- Data sent: standard HTTP request data when the script is requested (e.g., IP address, user agent) so the file can be delivered.
- Terms of Service: https://www.guzli.com/terms/
- Privacy Policy: https://www.guzli.com/privacy/

2) Guzli API (https://gateway.guzli.com)
- Used to connect the widget to your Guzli account and deliver chat responses/lead capture.
- Data sent: API key and Agent ID when the widget initializes; chat messages and related metadata (such as page URL, page history, browser information, and IP address) when visitors interact. This context helps improve chatbot responses.
- Telemetry can be disabled in the WordPress settings (Disable telemetry) or by setting `disableTelemetry: true` in the widget initialization options when embedding the script.
- Terms of Service: https://www.guzli.com/terms/
- Privacy Policy: https://www.guzli.com/privacy/

## Helpful links

- Guzli Website: https://www.guzli.com/
- Create an account: https://app.guzli.com/
- Terms of Service: https://www.guzli.com/terms/
- Privacy Policy: https://www.guzli.com/privacy/

== Installation ==

### Installing the ZIP file

1. Log in to your WordPress admin panel.
2. Go to Plugins > Add New > Upload Plugin.
3. Upload the Guzli plugin ZIP and click Install Now.
4. Activate the plugin.
5. Go to Settings > Guzli Options.
6. Enter your API Key and Agent ID.

### Installing via WordPress plugin search

1. Log in to your WordPress admin panel.
2. Go to Plugins > Add New.
3. Search for "Guzli".
4. Click Install Now and then Activate.
5. Go to Settings > Guzli Options.
6. Enter your API Key and Agent ID.

== Frequently Asked Questions ==

= Do I need a Guzli account? =

Yes. You need a Guzli account to create an agent and a client API key.

= Where do I find my API Key and Agent ID? =

Open your Guzli dashboard:

- API Key: create a client API key
- Agent ID: copy from your agent widget embed settings

= Does this embed the widget on all pages? =

Yes. This plugin injects the widget script sitewide.

= How do I disable telemetry? =

In WordPress, go to Settings > Guzli Options and enable "Disable telemetry".

If you embed the widget manually, pass `disableTelemetry: true` in the widget initialization:

```
window.Guzli.widget({
  baseUrl: "https://gateway.guzli.com",
  apiKey: "REPLACE_WITH_API_KEY",
  agentId: "REPLACE_WITH_AGENT_ID",
  disableTelemetry: true
});
```

= Can I customize the widget’s look and behavior? =

Yes. Configure branding and behavior in your Guzli dashboard (and use this plugin to install the widget on WordPress).

= Does this plugin store my API key in WordPress? =

Yes. The API key and Agent ID are stored in your WordPress options so the widget can be initialized on your site.

= Does Guzli work with caching/CDNs? =

Yes. The widget is loaded as an external script and initializes on page load.

== Security and privacy ==

If you need to identify logged-in users, use Guzli identity verification (a signed token generated by your backend). Review the Privacy Policy and Terms of Service:

- https://www.guzli.com/privacy/
- https://www.guzli.com/terms/

== Upgrade notice ==

Nothing here

== Screenshots ==

1. Configure Guzli in WordPress (API key, Agent ID).
2. Guzli chat widget on your WordPress site (desktop + mobile).

== Changelog ==

= 1.0.0 =
* Initial release.
