=== SiteStaffr ===
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

AI voice and text agent for WordPress — visitors talk or type, SiteStaffr answers using your business knowledge, in 57+ languages.

== Description ==

SiteStaffr is an AI-powered voice and text agent built for service businesses on WordPress. It answers your website visitors 24/7 — by voice or text chat — using knowledge from your actual website content. Every conversation is logged with transcripts, summaries, and follow-up notes so nothing 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.

== 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.
