=== AI for Home Services ===
Contributors: xapp
Tags: ai chat, scheduling, leads, home services, hvac
License:  APACHE-2.0
Stable tag: 1.2.1
Tested up to: 7.1.3
Requires at least: 4.7
Requires PHP: 7.2

Add an AI chat agent and an online booking button to your home service website. Book jobs and capture leads 24/7.

== Description ==

**Book jobs and capture leads from your website, around the clock.** One plugin installs both XAPP AI widgets on your WordPress site:

* **AI Chat Agent** - answers homeowner questions about your services, service area and hours, and captures their contact details and issue when they are ready to book. It works in two places: in the chat widget on your website, and for AI assistants like ChatGPT, Claude, Gemini and Meta AI, which find it through the `/.well-known` standards the plugin publishes for you.
* **Scheduling Widget** - a Book Online button that collects the homeowner's contact information, preferred day and time, and a description of the issue.

Both send each job and lead to your field service software or your inbox, so you manage bookings where you already work.

= Why home service pros use XAPP AI =

* **Available 24/7** - AI powered booking and lead capture, even while you sleep.
* **Unlimited bookings** - no lead or booking fees.
* **Fully integrated** - job and lead details are delivered by email or straight into your FSM.
* **Found by AI assistants** - when a homeowner asks an AI assistant for help, it can discover your AI Chat Agent on your site, ask it questions and request a callback for them. On by default, with no setup beyond your Chat Widget Key.
* **Deep insights** - homeowner insights and reporting to guide your SEO and SEM.
* **More places to book** - the same XAPP AI booking powers a Google approved Book Online button on your Google Business Profile, a custom landing page, and social and directory listings. XAPP AI is an approved Google Partner.

See plans and packages at [xapp.ai/solutions](https://xapp.ai/solutions/).

== Installation ==

1. Install the plugin from Plugins -> Add New, or upload the folder to `/wp-content/plugins/`.
2. Activate the plugin through the 'Plugins' menu in WordPress.

== Setup ==

Open Settings -> XAPP AI in your WordPress admin dashboard.

Enter the Chat Widget Key and the Scheduling Widget Key from XAPP AI Studio. Set either one, or both; each widget loads on your site once its key is saved.

Don't have a XAPP AI account? [Get started here](https://xapp.ai/solutions/).

== Chat Widget ==
The AI Chat Agent appears as an overlay with a launch button, in the bottom right corner by default. Configure its position, colors and greeting in XAPP AI Studio.

== Scheduling Widget ==
The Book Online button appears as a tab on the left or right side of your site. It connects to your field service management software and is fully configurable in XAPP AI Studio.

== AI Agent Discovery ==
AI agents (ChatGPT, Claude, Gemini, Meta AI) look for a business's assistant at `/.well-known/mcp/server-card.json`. With your Chat Widget Key set, the plugin publishes your XAPP AI assistant there (and at `/.well-known/mcp.json`, `/.well-known/mcp-server-card` and `/.well-known/mcp/manifest.json`), so an agent helping a homeowner can ask your business questions and request a callback directly. Turn it off under Settings -> XAPP AI. Requires WordPress to be installed at the root of your domain.

== PHP Security Notice ==
If your site's PHP is missing the October 2026 security fixes (CVE-2026-109618, CVE-2026-109619), the plugin shows administrators a notice to ask their host to update PHP.

== Integrations ==
Send jobs and leads to:

- Jobber
- FieldPulse
- ServiceTitan
- Housecall Pro

And more. Read about our integrations [here](https://xapp.ai/integrations/).

== Frequently Asked Questions ==
= What does the plugin install? =
Both the AI Chat Agent and the Scheduling Widget (Book Online button). Enter the key for each one you want on your site.
= How much does it cost? =
See our plans at [xapp.ai/solutions](https://xapp.ai/solutions/). There are no lead or booking fees.
= I've installed the plugin, what do I do now? =
Get your widget keys from XAPP AI Studio and paste them into Settings -> XAPP AI.
= How can I learn how to customize the experience? =
Read our [documentation](https://documentation.xapp.ai), or watch our [YouTube training series](https://www.youtube.com/playlist?list=PLj26gRljku8BiAVezV9wNvyHrSeF_DRa8).

== Screenshots ==

1. Talk to your website visitors in real-time. Add live chat to your WordPress website in less than 5 minutes.
2. Customize the widget to match your brand identity. 
3. Get instant notifications when visitors are ready to buy, with leads sent directly to you
4. Increase engagement with helpful auto-completion that's pre-trained with knowledge about your industry

== Changelog ==

= 1.0.0 =
* Initial release

= 1.0.1 =
* Fixes bug where both chat and search keys were required

= 1.1.0 =
* Adding Scheduling/Form Widget support
* Updates to naming, and styling

= 1.1.1 =
* Fixing version numbers
* Updating readme.txt

= 1.2.0 =
* Publishes your assistant at /.well-known/ for AI agents (MCP server card and manifest)
* Warns administrators when PHP is missing the October 2026 security fixes
* Removes Intelligent Search (discontinued) and its block editor button
* Fixes the link to XAPP AI Studio on the settings page

= 1.2.1 =
* Updated plugin description: one plugin installs both the AI Chat Agent and the Scheduling Widget, and makes the AI Chat Agent discoverable by AI assistants

== Upgrade Notice ==
= 1.0 = 