=== 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.24.3
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, post-conversation processing, and AI blog content generation (manual and scheduled Autopilot posts, including topic suggestions)
* Data sent: Site URL, installation identifier, business context/settings, transcript text, and usage metadata required to deliver service features. For blog generation: the post topic/keyword, your business name and description, titles/URLs/short excerpts of your published pages (for internal linking), and your site's category/tag names. Generated posts are delivered directly back to your site and are not stored on SiteStaffr servers.
* Privacy Policy: https://sitestaffr.com/privacy
* Terms of Service: https://sitestaffr.com/terms

**OpenAI (Required via SiteStaffr service)**
* Purpose: Real-time voice conversation, AI-generated summaries, and AI blog content/image generation
* Data sent: Voice stream during active sessions, transcript text, and prompt context needed to generate responses/summaries; for blog posts, the topic and business context needed to research and write the article
* 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.24.3 - 2026-06-14 =
* Fixed: Saved voice call transcripts no longer show an internal control word (like "end_session") in the agent's closing line. These are now removed so your call logs, transcript links, and report emails read cleanly.

= 1.24.2 - 2026-06-13 =
* Fixed: Blog Agent now always appears under My AI Agent. It was hidden behind a leftover development flag, so it only showed on sites that manually enabled it. Blog Agent is now permanently on for all plans.

= 1.24.1 - 2026-06-13 =
* Changed: Blog post credits now reset on your billing renewal date instead of the 1st of the month. Trials include one post for the whole trial, and upgrading gives you a fresh allowance right away.
* Improved: The Blog Agent page shows your real reset date instead of "this month".

= 1.24.0 - 2026-06-12 =
* New: Blog Agent — your website's AI content writer. Generates SEO-optimized blog posts grounded in your business: research, writing, metadata, categories/tags that reuse your site's taxonomy, internal links to your real pages, FAQ sections, and a brand-colored featured image.
* New: Suggested topic queue with one-click Generate and Skip, plus a Suggest Topic button on the New Post form.
* New: Autopilot — scheduled, hands-off post generation on your chosen weekly cadence, publishing automatically or landing as drafts for review.
* New: Monthly post allowances follow your plan — Starter 2, Business 4, Pro 8 (trial 1) — enforced by the SiteStaffr service.
* Improved: Posts are delivered server-to-server with signed requests; your browser doesn't need to stay open.
* Improved: Generated posts always receive a real category, never name competitors, and never store your business content on SiteStaffr servers.

= 1.23.19 - 2026-06-10 =
* Improved: Deleting a Blog Agent entry now moves its WordPress post to the Trash (recoverable for 30 days) instead of deleting it permanently.
* New: Ready drafts have a Publish button right in the drafts list — no need to open the preview.

= 1.23.18 - 2026-06-10 =
* Changed: The Autopilot section appears in Blog Agent settings on plans that include it.

= 1.23.17 - 2026-06-10 =
* Changed: Autopilot is available to all plans — your plan's monthly post allowance is the only limit, applied by the SiteStaffr service.
* Improved: Generated posts always receive a category — no more Uncategorized posts.
* Improved: Blog posts never name or recommend competing products; your business is always the recommendation.

= 1.23.16 - 2026-06-10 =
* New: Blog Agent monthly post limits now follow your plan — Starter 2, Business 4, Pro 8 (trial 1), with topic suggestions at double your post limit.
* New: Autopilot scheduled generation is available on the Business and Pro plans.
* Improved: Clear, plan-aware messages when a monthly limit is reached.

= 1.23.15 - 2026-06-10 =
* Improved: Publish times now display consistently as "ET" (Eastern Time) everywhere, on one line, instead of mixing EST/EDT.
* Improved: With Autopilot enabled, the empty drafts message now says your next post is on the way instead of pointing to the New Post tab.

= 1.23.14 - 2026-06-10 =
* New: Skipping a topic now brings in a fresh replacement right away — the queue stays topped up at 8 upcoming topics (while monthly topic credits last).
* Improved: Published posts now show "Published" instead of "Ready" in the drafts list.
* Changed: Removed the topic-approval toggle — every suggested topic is scheduled automatically, and Skip is how you reject one.

= 1.23.13 - 2026-06-10 =
* New: Upcoming topics now show the date and time each post will publish (Eastern Time).
* Improved: Featured images now use a keyword-rich filename and a descriptive media title, and echo your widget's brand color in their palette.
* Improved: Blog posts no longer link to competing businesses — external citations are restricted to neutral, non-commercial sources.
* Removed: Image Upload Smoke Test section.

= 1.23.12 - 2026-06-10 =
* New: Blog Agent Autopilot now runs entirely on your own site — the schedule (WP-Cron), topic queue, and monthly budgets all live in your WordPress database. No business or content data is stored on SiteStaffr servers.
* Improved: Upcoming topics are suggested on demand and stored locally; approve or skip them right from the Blog Agent page.
* Fixed: Site categories and tags are now actually sent with generation requests so the AI reuses your existing taxonomy.

= 1.23.11 - 2026-06-09 =
* Improved: Blog Agent FAQ sections now render with proper spacing between questions and answers, on the published post and in the preview window.
* Improved: Blog Agent sends a short excerpt for each existing page so generated posts choose internal links that match the blog topic and the section they appear in.

= 1.23.10 - 2026-06-09 =
* Changed: Bumped the Blog Agent Phase 1 staging/dev handoff version after the merged admin styling and preview Publish updates so WordPress recognizes the refreshed test zip as newer.

= 1.23.9 - 2026-06-09 =
* New: Blog Agent manual post preview now has a primary Publish button, with Open in Editor and Close as secondary actions.
* Improved: Blog Agent now reuses existing categories and tags more conservatively during generated-post publishing.
* Improved: Blog Agent admin tab and card styling now has scoped fallbacks so the Generate Blog Post tab remains polished if shared CSS load order changes.

= 1.23.6 - 2026-06-07 =
* New: Google Tag Manager / dataLayer conversion tracking — the widget pushes open, conversation-start, lead-captured, qualified-lead, and conversation-end events (with engagement-depth metadata) so you can trigger GA4, Facebook, or any tag-manager tags without extra setup. The Widget & Button settings page includes an event reference table and a full step-by-step Google Analytics 4 setup guide.

= 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.24.3 =
Cleans up an internal control word that could appear in saved voice transcripts. Recommended for all sites.

= 1.24.2 =
Fixes Blog Agent not appearing under My AI Agent. Recommended for all sites.

= 1.24.1 =
Blog post credits now reset on your billing renewal date and the Blog Agent page shows your real reset date. Safe to update.

= 1.24.0 =
Major new feature: the Blog Agent writes SEO blog posts for your site, with topic suggestions, scheduling, and plan-based monthly allowances. Safe to update.

= 1.23.12 =
Blog Agent Autopilot now runs fully on your own site with zero business data stored on SiteStaffr servers. Safe to update.

= 1.23.11 =
Blog Agent link-quality and FAQ spacing improvements for the Phase 1 test build. Safe to update.

= 1.23.10 =
Refreshed Blog Agent Phase 1 staging/dev build with a version bump so WordPress recognizes the newly updated zip. Safe to update.

= 1.23.6 =
New Google Tag Manager / Google Analytics 4 conversion tracking with a built-in setup guide on the Widget & Button settings page. Safe to update.

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