=== NoahFirst AI Sales Associate ===
Contributors: noahfirstai, noahfirst
Tags: woocommerce, ecommerce, ai sales associate, customer support, live chat
Requires at least: 5.0
Requires PHP: 7.1
Tested up to: 7.1
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
AI sales associate for online stores that answers buyer questions using your own store data.

== Description ==

NoahFirst is an AI sales associate for independent online stores. It uses your own
store knowledge—products, inventory, product details, and published WordPress
content—to answer buyer questions while they decide.

Unlike a generic chatbot, NoahFirst is designed around ecommerce buying questions.
The official WordPress plugin connects the store to NoahFirst, loads the storefront
assistant, and keeps structured WooCommerce product knowledge synchronized.

== Why NoahFirst? ==

NoahFirst works from your store data rather than guessing from unrelated sources.
Structured WooCommerce product facts such as price, stock status, SKU, variants,
attributes, and canonical product URLs remain authoritative for shopper answers.

Customers ask. NoahFirst answers. Sales happen.

== Key Features ==

* Store-grounded answers: Uses WooCommerce products and published WordPress content as store knowledge
* Automatic store sync: Product, inventory, variation, pricing, and post changes schedule a NoahFirst sync
* Scheduled safety sync: A twice-daily heartbeat refreshes connected store knowledge
* Manual resync: Store administrators can trigger a sync and see the latest sync status
* Structured commerce ingestion: Sends product facts directly to NoahFirst without WooCommerce REST consumer credentials
* Last-known-good protection: NoahFirst keeps the prior successful catalog if an ingestion attempt fails
* Secure connection settings: The Integration Secret is encrypted at rest inside WordPress
* Multi-language shopper responses: NoahFirst can respond based on the shopper's language
* Lightweight storefront loader: The assistant script loads on connected storefronts
* No-code setup: Install the plugin, connect the store, and let NoahFirst handle ongoing sync

== How It Works ==

1. Install and activate the NoahFirst plugin
2. Copy the Store Token and Integration Secret from NoahFirst → Store
3. Save the connection in WordPress
4. NoahFirst performs the initial store sync
5. Product, stock, variation, and post changes schedule future syncs automatically
6. The storefront assistant can answer shoppers using the connected store knowledge

== Use Cases ==

* Product-detail and product-selection questions
* Size, compatibility, availability, and usage questions
* Product comparison and catalog guidance
* Store-policy questions supported by published store knowledge
* Shopper questions when the merchant team is unavailable

== Frequently Asked Questions ==

= Does NoahFirst require WooCommerce? =
NoahFirst is optimized for WooCommerce stores. The plugin can also sync published
WordPress posts as supporting store knowledge.

= Does NoahFirst use my store data? =
Yes. NoahFirst uses connected store knowledge to provide relevant answers.

= How does automatic sync work? =
Connected stores schedule a sync when WooCommerce products, variations, stock, or
published WordPress posts change. A scheduled heartbeat also refreshes the store
periodically. Administrators can trigger a manual sync from the plugin settings page.

= Does NoahFirst use WooCommerce REST API consumer keys? =
No. The official plugin pushes structured store data to NoahFirst using the Store
Token and Integration Secret configured by the administrator.

= Is technical setup required? =
No coding is required. A store administrator installs the plugin and connects the
credentials supplied by NoahFirst.

== External Services ==

This plugin connects to the NoahFirst API (https://api.noahfirst.com) and loads the
NoahFirst storefront assistant script from NoahFirst infrastructure.

Service: NoahFirst API
Purpose: Authenticates the connected store, receives structured store knowledge,
and powers shopper-facing NoahFirst responses.
Data Sent During Store Sync: Store Token, Integration Secret for request
authentication, site URL, WooCommerce product and variation data (including names,
descriptions, prices, stock, SKUs, attributes, categories, and product URLs), and
published WordPress post content selected by the plugin.
When Store Data Is Sent: After connection settings are saved, when relevant
WooCommerce product/stock/variation or WordPress post changes schedule a sync,
during the scheduled store-sync heartbeat, or when an administrator chooses
"Sync now".
Shopper Data: When a shopper uses the NoahFirst storefront assistant, the widget
communicates with the NoahFirst service to process that shopper conversation.
Subprocessors: NoahFirst uses OpenAI for AI processing and IDCloudHost for
infrastructure hosting.
Security: Data is transmitted over HTTPS. The WordPress Integration Secret is
stored encrypted by the plugin using the WordPress installation's authentication salt.

Policies:
Privacy Policy: https://noahfirst.com/privacy
Terms of Service: https://noahfirst.com/terms
Security: https://noahfirst.com/security

== Screenshots ==

1. NoahFirst answers product questions using connected store information
2. NoahFirst supports delivery and policy questions when the store provides that knowledge
3. NoahFirst helps shoppers compare and select products
4. NoahFirst can answer availability and product-detail questions

== Changelog ==

= 1.1.0 =

* Added structured WooCommerce product and variation ingestion
* Added automatic sync hooks for product, stock, variation, and WordPress post changes
* Added twice-daily sync heartbeat and manual "Sync now" control
* Added sync status visibility for store administrators
* Added encrypted storage for the Integration Secret
* Added last-known-good catalog protection through the NoahFirst ingestion contract
* Added real WordPress and WooCommerce runtime verification in CI

= 1.0.0 =

* Initial release

== Upgrade Notice ==

= 1.1.0 =
Adds automatic structured store sync and secure connection storage for the official
NoahFirst WordPress integration.
