=== ServiceFront ===
Tags: ai agents, a2a, front desk, local business, agent card
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Points AI agents that visit your site to your ServiceFront front desk.

== Description ==

**This plugin needs a ServiceFront account. The Free plan is enough, and it takes no card.** Free gives you a live AI front desk at yourbusiness.servicefront.ai, built from your website. It answers your customers and their AI assistants from the facts you've confirmed, and emails you the first 5 leads each month. Urgent jobs always reach you. A paid plan delivers every lead and takes the "Powered by ServiceFront" badge off your front desk. Plans and prices: https://servicefront.ai/pricing

ServiceFront gives a service business an AI front desk that answers customers and their AI assistants, and takes their requests. The desk lives at yourbusiness.servicefront.ai. An assistant that starts from your own website has no way to know that, until this plugin tells it.

The plugin publishes your front desk's agent files on your own domain:

* `/.well-known/agent-card.json`, where agents that speak A2A, the open agent-to-agent protocol, look for one. It names your desk's endpoint on servicefront.ai, so an agent that lands on your site can ask your desk a question or send it a customer's request.
* `/.well-known/servicefront.json`, which tells other agents how to reach your desk.
* `/llms.txt`, `/agents.md` and `/pricing.md`, when your site has none of its own. You can turn these three off.

When an SEO plugin already writes your llms.txt, this plugin leaves it alone. Rank Math's gets a short "Front desk" section added. For any other llms.txt or agents.md, the settings page gives you the section to paste in, and tells you each time you open it whether it's still there.

Each file is a copy of the one ServiceFront already publishes for your business. The plugin checks them when you save your address, twice a day after that, and once after it updates. When ServiceFront no longer lists your business, your site stops serving them at the next check. When ServiceFront can't be reached, your site keeps serving the last good copies, for a week at most.

It doesn't change your pages unless you ask. Tick "Show my front desk on my site" and every page gets a chat button, where your front desk answers your visitors. The box starts unticked. Either way the plugin adds no structured data.

The settings page also shows what your front desk tells AI agents: your business facts and your services, as you confirmed them on ServiceFront. One button copies them for ChatGPT or another AI assistant, so you can have it check your website's pages against them.

No front desk yet? The settings page links to servicefront.ai, where you can build one from this site. It's free to start.

== External services ==

This plugin connects to ServiceFront (https://servicefront.ai), run by Optimizer Team, Inc. This is everything it sends, and when.

It reads your front desk's public agent files:

* What it sends: HTTPS requests for five public files on your front desk's address: `/.well-known/agent-card.json`, `/.well-known/servicefront.json`, `/agents.md`, `/llms.txt` and `/pricing.md` at `https://yourbusiness.servicefront.ai`. Nothing about your site, your visitors or your customers is sent.
* When: when you save your ServiceFront address on Settings › ServiceFront, twice a day after that, and once after the plugin updates. No file is requested until you enter an address.

It also asks ServiceFront for the plugin's newest version, so WordPress can offer updates on your Plugins screen:

* What it sends: an HTTPS request to `https://servicefront.ai/api/wordpress-plugin/update`, which answers with the newest version, its changelog and where to download it. The request names the plugin's own version in its user agent, in place of WordPress's, which carries your site's address. Nothing about your site, your visitors or your customers is sent.
* When: whenever WordPress checks for plugin updates: twice a day, and when an administrator opens the Plugins or Updates screen. Updates install only when you choose, or when you turn on auto-updates for this plugin.

If you tick "Show my front desk on my site", your public pages load your front desk's chat from ServiceFront. It's off until you tick it.

* What it sends: each page view loads the script `https://yourbusiness.servicefront.ai/widget.js` in your visitor's browser, and the script tells ServiceFront that it's installed on your site (a request to `/api/widget/seen` at the same address, which carries your site's address, as any request a browser makes from your pages does). Like any web request, both show ServiceFront the visitor's IP address and browser. The plugin asks the script to add no structured data to your pages.
* When a visitor opens the chat: it loads from `https://yourbusiness.servicefront.ai/embed` in a frame. What they type, and any contact details they leave, go to ServiceFront, which answers for your business and sends you their request.
* When: on every page your public site builds while the box is ticked and your front desk is live. Never in wp-admin, and never on a page built while the box is unticked. A page cache keeps serving the pages it stored, so clear yours after you tick or untick the box.

The "Build my front desk from this site" button, shown before you've saved an address, is a link to `https://servicefront.ai/onboarding`.

* What it sends: your site's host name, like example.com, in the link, so the form there starts with your site filled in. Nothing else.
* When: only when you click it.

The "Copy these facts for ChatGPT" button sends nothing: it puts text on your clipboard.

* ServiceFront's terms: https://servicefront.ai/terms
* ServiceFront's privacy policy: https://servicefront.ai/privacy

== Installation ==

1. Upload the zip under Plugins › Add New Plugin › Upload Plugin, then activate it.
2. Go to Settings › ServiceFront and enter your ServiceFront address, like yourbusiness.servicefront.ai.
3. Under "What AI agents find", each file says "Served", or whose file answers there instead.
4. To put your front desk's chat on your pages, tick "Show my front desk on my site" and save.

Your permalinks need to be anything other than Plain, so WordPress receives the request.

== Frequently Asked Questions ==

= Do I need a ServiceFront account? =

Yes. The plugin copies your front desk's files and loads its chat, so there has to be a front desk. The Free plan covers everything this plugin does. Before you've saved an address, the settings page links to servicefront.ai, where you build one from this site.

= What does it cost? =

The plugin is free. ServiceFront's Free plan is $0 and stays that way: it emails you the first 5 leads each month, and urgent jobs always. A paid plan delivers every lead, with no badge on your front desk. Prices: https://servicefront.ai/pricing

= Where do I find my ServiceFront address? =

On your ServiceFront dashboard. It's the address of your front desk.

= Does it add anything to my pages? =

Not unless you tick "Show my front desk on my site". Then every public page loads one script from your front desk's address, which shows a chat button. Untick the box and your pages are what they were, once any page cache you use is cleared.

= Why doesn't the chat button show? =

It shows only while your front desk is live. If Settings › ServiceFront says there's no live front desk at your address, finish verifying your business on ServiceFront, then save again. If your site uses a page cache, clear it after you tick the box: cached pages are the ones stored before.

= A fact about my business is wrong. Where do I fix it? =

On your ServiceFront dashboard: the settings page's "Fix a fact" link opens it. This site picks the change up at its next check, or when you save.

= Does it work with Yoast SEO, Rank Math or All in One SEO? =

Yes. It doesn't touch their structured data, sitemaps or robots.txt. When one of them writes your llms.txt, this plugin doesn't publish its own. Rank Math's gets a "Front desk" section added; for Yoast SEO and All in One SEO, the settings page gives you the section to paste.

= Why does the settings page check my site each time I open it? =

Another plugin can rewrite your llms.txt or agents.md. Each time you open Settings › ServiceFront, it reads what your site serves at each address, so you see whether the front desk section is still there.

= What happens when I delete the plugin? =

It removes its settings and its scheduled check. Your site stops serving the files, and the chat button goes, as soon as the plugin is deactivated, though a cache may hold a file's last answer for up to 5 minutes, and a page cache its stored pages until it's cleared.

== Screenshots ==

1. Settings › ServiceFront: your address, the chat box, and what AI agents find on your site.
2. What your front desk tells AI agents, with the button that copies those facts for ChatGPT.
3. The chat button on your site, once you tick the box.

== Changelog ==

= 0.2.1 =
* No change to how the plugin works. The readme now says up front that it needs a free ServiceFront account, and what the Free plan includes.

= 0.2.0 =
* New box, "Show my front desk on my site": tick it and every page gets a chat button where your front desk answers your visitors. It starts unticked, and unticked the plugin still adds nothing to your pages.
* The settings page shows what your front desk tells AI agents, your confirmed business facts and services, with a button that copies them for ChatGPT.
* No front desk yet? The settings page now links to servicefront.ai, where you can build one from this site.

= 0.1.4 =
* Also serves your front desk's `/pricing.md`, your services and prices for AI assistants, when your site has none. The same box as llms.txt and agents.md turns it off.
* After an update, the plugin checks your files on its next run instead of waiting up to 12 hours.

= 0.1.3 =
* "View details" no longer says the plugin hasn't been tested with your WordPress when you're on a patch release of the version it was tested with, like 7.1.3.

= 0.1.2 =
* Your Plugins screen offers new versions of this plugin, like any other plugin's updates. "View details" shows what changed.

= 0.1.1 =
* Also serves your front desk's servicefront.json, and its llms.txt and agents.md when your site has none.
* If another plugin already writes your llms.txt, this one leaves it alone. Rank Math's gets a short section pointing to your front desk. For any other, the settings page gives you the section to paste in.
* The settings page shows what agents find at each file's address, and gives you the section to paste into an llms.txt or agents.md another tool writes.

= 0.1.0 =
* First release: serves your front desk's agent card at /.well-known/agent-card.json.
