=== SiteStaffr – AI Voice & Text Agent for WordPress ===
Contributors: sitestaffr
Tags: ai, voice agent, chatbot, live chat, customer support
Requires at least: 6.2
Tested up to: 7.0
Stable tag: 1.22.18
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let visitors talk or type with a 24/7 AI agent that answers using your website content, captures leads, and saves transcripts.

== Description ==

SiteStaffr adds an AI-powered voice and text chat agent to your WordPress site — visitors can talk or type, and your agent answers 24/7 using knowledge from your own website pages. Every conversation is logged with a full transcript, AI-generated summary, and follow-up notes, so no lead or inquiry falls through the cracks.

No phone lines. No code. Install in minutes. Free for 30 days.

**Voice Agent**

* Browser-based voice conversations powered by WebRTC — no phone number required
* 10 distinct AI voices to match your brand personality
* Natural multi-turn conversations with real-time responses
* Automatic contact collection during conversations

**Text Chat**

* Built-in text chat widget for visitors who prefer typing
* Always-on knowledge retrieval for instant, accurate answers
* Fast contact collection with structured data capture

**AI Knowledge Base**

* Sync your website pages directly to the AI knowledge base
* Hybrid search (vector + keyword) for accurate answers about your services and pricing
* Your AI agent learns your business — no manual scripting required

**Built for Business**

* 57+ language support — serve visitors in their preferred language
* Full conversation transcripts stored in WordPress
* AI-generated follow-up summaries after every conversation
* Email notifications with one-click transcript access
* Usage dashboard with conversation metrics and minutes tracking
* Customizable widget appearance — colors, position, border styles, and icon

**Two Widget Styles**

* Fixed-position widget with voice + text chat
* Inline button variant via `[sitestaffr_button]` shortcode

**Great For**

* Contractors and home services
* Dental and medical offices
* Legal practices
* Real estate teams
* Any WordPress business that wants a 24/7 AI-powered agent

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/sitestaffr/`
2. Activate the plugin through the Plugins screen in WordPress
3. Go to `SiteStaffr` in wp-admin
4. Complete setup and connect your site
5. Add the widget shortcode to a page and test a conversation

== External Services ==

This plugin relies on SiteStaffr cloud services and third-party infrastructure providers to deliver voice, AI, and billing features.

**SiteStaffr Cloud Service (Required)**
* Purpose: Site registration, authenticated voice session orchestration, and post-conversation processing
* Data sent: Site URL, installation identifier, business context/settings, transcript text, and usage metadata required to deliver service features
* Privacy Policy: https://sitestaffr.com/privacy
* Terms of Service: https://sitestaffr.com/terms

**OpenAI (Required via SiteStaffr service)**
* Purpose: Real-time voice conversation and AI-generated summaries
* Data sent: Voice stream during active sessions, transcript text, and prompt context needed to generate responses/summaries
* Provider Policy: https://openai.com/policies/privacy-policy

**Stripe (Required for paid plans and add-ons)**
* Purpose: Subscription billing, checkout, and payment management
* Data sent: Billing identifiers, plan/add-on selection, and payment-related metadata
* Provider Policy: https://stripe.com/privacy

**Google Cloud (Required infrastructure)**
* Purpose: Hosting and secure operation of SiteStaffr cloud services
* Data sent: Service requests and operational metadata required to process authenticated plugin requests
* Provider Policy: https://cloud.google.com/privacy

**Data Handling**
* Transcripts and call metadata are stored in your WordPress database
* Configuration/auth metadata is stored for service operation
* Audio recordings are not persisted by this plugin

By using this plugin, you acknowledge relevant call/session data is transmitted to SiteStaffr cloud services to provide functionality.

== Privacy ==

SiteStaffr processes customer interaction data to provide voice agent functionality.

Data may include:
* Caller contact details (if provided)
* Transcript text
* Session timing and usage metrics
* Business configuration you enter in settings

SiteStaffr does not use your data for advertising.

== Frequently Asked Questions ==

= How does SiteStaffr work? =

Visitors click the widget on your site and start a voice or text conversation. SiteStaffr's AI uses your synced website content to answer questions accurately. After each conversation, you get a transcript, summary, and follow-up notes in your WordPress admin.

= Do I need a phone number or any third-party accounts? =

No. Voice conversations happen directly in the browser using WebRTC. SiteStaffr handles all the AI infrastructure — there's nothing else to set up or manage.

= How does the AI know about my business? =

You sync your website pages from the AI Knowledge page in wp-admin. SiteStaffr indexes your content so the AI can answer questions about your services, pricing, hours, and more.

= What languages does it support? =

SiteStaffr supports 57+ languages for both voice and text conversations. Visitors can speak or type in their preferred language.

= Can I customize the widget appearance? =

Yes. You can change colors, position, border styles, icon, and choose between a fixed widget or an inline button. There are also 10 different AI voices to match your brand.

= Is audio recorded? =

No. Audio is not stored by this plugin. Conversation transcripts are saved in your WordPress database for your records.

= Does the widget show SiteStaffr branding? =

No. The widget does not display any SiteStaffr branding text.

= Is there a free trial? =

Yes. SiteStaffr includes a free 30-day trial so you can test it on your site before committing to a plan. Visit [sitestaffr.com](https://sitestaffr.com) for pricing details.

== Plans & Free Trial ==

SiteStaffr includes a **30-day free trial** to evaluate every feature before committing to a plan.

After your trial, choose a plan that fits your site:

* **Free Trial** — Full-featured access for 30 days
* **Pro** — Core AI voice and text chat for service businesses
* **Business** — Expanded limits and advanced controls for higher-volume sites

Optional add-ons (available on paid plans) can extend conversation capacity and knowledge pages.

Visit [sitestaffr.com](https://sitestaffr.com) for current pricing and plan details.

== Screenshots ==

1. Frontend widget in action on a live page (idle, fixed-position).
2. SiteStaffr admin dashboard with recent calls and transcript history.
3. Setup wizard flow for quick onboarding and site connection.
4. Widget customization settings (colors, icon, and position).
5. Call transcript detail view with summary and follow-up notes.
6. Inline button widget variant using the `[sitestaffr_button]` shortcode.
7. Widget during active listening/speaking voice interaction.

== Changelog ==

= 1.22.18 - 2026-06-05 =
* Improved: AI knowledge responses now automatically protect sensitive contact information in retrieved content.
* Improved: WordPress 7.0 compatibility fixes for admin button styling.
* Improved: SEO metadata compatibility with RankMath and sites without an SEO plugin.

= 1.18.0 - 2026-04-29 =
* New: My AI Agent page — centralized voice and behavior settings with voice selector, custom greeting, and AI instruction controls.
* New: AI instruction toggles for contact collection and personal information handling.
* Improved: Knowledge search accuracy with hybrid vector + keyword retrieval.
* Improved: Text chat response speed — knowledge answers now arrive faster.
* Improved: Text chat contact collection is significantly faster.

= 1.15.0 - 2026-04-22 =
* Improved: Voice and text chat now use the same hybrid search for consistent, accurate knowledge answers.
* Improved: Better handling of similar content (e.g., multiple pricing tiers on the same page).

= 1.12.0 - 2026-03-27 =
* Improved: Widget settings redesigned with tabbed layout (Appearance / Behavior).
* New: Border style controls (solid, dashed, dotted, double, none) for both widget types.
* Improved: Mobile-friendly transcript and session detail views.

= 1.11.0 - 2026-03-25 =
* Improved: AI business description generator now produces more accurate, structured descriptions.

= 1.7.0 - 2026-03-21 =
* New: AI Knowledge page — sync your website pages so the AI can answer questions about your business.
* New: Knowledge-powered voice and text chat sessions.

= 1.4.0 - 2026-03-17 =
* New: Persona support — use `[sitestaffr_button persona=”sales”]` and `[sitestaffr_widget persona=”support”]` for role-specific AI behavior.
* New: Inline button widget variant with customizable appearance.

= 1.2.0 - 2026-03-06 =
* New: One-click transcript viewer — access full conversation details directly from email notifications.
* New: Per-corner border radius controls for widget customization.
* Improved: Setup wizard with AI-powered business description generator.

= 1.0.0 - 2026-03-02 =
* First public release.
* Browser-based AI voice agent widget with WebRTC.
* Text chat widget for visitors who prefer typing.
* Conversation transcripts, AI-generated summaries, and follow-up notes.
* Admin dashboard with usage metrics and conversation history.
* Setup wizard for quick onboarding.
* Widget customization (colors, position, icon, border styles).
* Email notifications for new conversations.

== Upgrade Notice ==

= 1.22.18 =
Knowledge privacy improvements and WordPress 7.0 compatibility. Safe to update.

= 1.18.0 =
New My AI Agent page with centralized voice settings, faster text chat, and improved knowledge search accuracy.

= 1.15.0 =
More accurate knowledge answers for both voice and text chat conversations.

= 1.7.0 =
Major feature: AI Knowledge page lets your agent answer questions using your actual website content.

= 1.0.0 =
First public release of SiteStaffr — AI voice and text agent for WordPress.
