=== RecomAI Sales Agent ===
Contributors: recomai
Tags: chatbot, ai, woocommerce, customer-support, automation
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.0.2
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Integrate your WordPress and WooCommerce site with RecomAI's powerful AI chatbot platform to drive sales and automate support.

== Description ==

RecomAI is an advanced AI-powered e-commerce personalization platform designed to boost sales and enhance customer experiences on platforms like Shopify, WooCommerce, and Magento. It combines intelligent product recommendations, an AI chatbot for real-time support, and features like AI skin analysis to guide shoppers, automate interactions, and increase conversions.

Built by Destinova AI Labs, RecomAI helps e-commerce brands turn visitor interactions into revenue by providing personalized suggestions, handling queries 24/7, and optimizing average order value (AOV). Whether you are looking to automate your support or drive more sales through intelligent recommendations, RecomAI is the ultimate AI assistant for your store.

= AI Chatbot & Multi-Channel Support =

* **24/7 AI Chat Agent:** AI assistant that instantly handles customer questions, product inquiries, order tracking, and sales conversations with personalized, real-time responses across 100+ languages.
* **Multi-Channel Customer Support:** Connect and manage customer conversations from WhatsApp, Facebook Messenger, Instagram, Email, website chat, and other channels from a single unified inbox.
* **Hybrid AI + Human Support:** Seamlessly hand off complex or high-value conversations from AI to live support agents, allowing your team to take over while maintaining the full conversation context.
* **Multilingual AI Support:** Engage customers globally with AI-powered conversations across 100+ languages, providing consistent and personalized support across every connected channel.

= Sales & Conversions =
* **AI Product Recommendations:** Deliver personalized, real-time product recommendations based on shopper intent, behavior, preferences, and browsing context to help customers discover the right products faster.
* **AI Sales Assistant:** Automatically identify opportunities to upsell premium products and cross-sell relevant accessories or complementary items to increase cart value and average order value.
* **AI Auto-Nudge:** Engage shoppers at the right moment with contextual, non-intrusive AI-powered popups that highlight relevant products, offers, and recommendations to encourage conversions.
* **Proactive Campaigns:** Create targeted campaigns that automatically engage shoppers based on their behavior, browsing activity, products viewed, and other customer signals.
* **AI Product Summaries:** Help shoppers make faster purchase decisions with concise, AI-generated product summaries that highlight key benefits, features, and specifications.

= Lead Capture & Integrations =

* **Lead Capture:** Collect valuable customer information such as name, email, phone number, preferences, and other details through customizable pre-chat forms.
* **Conversational Lead Qualification:** Use multi-step question flows to engage visitors, qualify leads, understand their needs, and collect structured customer information.
* **WooCommerce Integration:** Connect your WooCommerce store and automatically sync your product catalog to power accurate AI-driven product recommendations and customer conversations.
* **Multi-Channel Integrations:** Connect customer conversations across channels such as WhatsApp, Facebook Messenger, Instagram, Email, and website chat to manage support and sales from one place.

= Personalization & Intelligence =

* **Cart-Aware AI:** Understand what shoppers already have in their cart and provide relevant recommendations, complementary products, and personalized assistance based on their current purchase.
* **Context-Aware Conversations:** Use customer conversations, browsing context, product interests, and shopping intent to deliver more relevant responses and recommendations.
* **Order Tracking:** Let customers check their order status directly through the chatbot, reducing support workload while providing instant access to order information.
* **AI-Powered Insights & Analytics:** Track conversations, customer behavior, product interactions, and conversion activity to understand what drives engagement and sales.

= Customization & Branding =

* **Fully Customizable AI Widget:** Customize the chatbot experience to match your brand, including size, position, colors, fonts, header design, launcher icon, labels, spacing, and overall appearance.
* **Starter Messages & Quick Actions:** Guide visitors with predefined starter messages, suggested questions, and quick-access actions that make it easier to start conversations.
* **Custom Home Experience:** Create a branded chatbot home screen that highlights key actions, products, recommendations, and frequently used features.
* **Organized Customer Experience:** Provide a simple, intuitive interface for shoppers to chat with AI, explore recommendations, and track orders from a single widget.

== External Services ==

This plugin relies on the **RecomAI** platform, a SaaS service developed and operated by Destinova AI Labs, to deliver its AI chatbot functionality. A RecomAI account is required to use this plugin. No data is sent to RecomAI until the store administrator has signed in and enabled the chatbot.

= RecomAI REST API (https://api.recomai.one/api) =

The plugin's server-side PHP code and the chatbot widget communicate with the RecomAI REST API:

* **Authentication (admin only):** When a store administrator signs in, signs up, verifies an email OTP, or resets a password from the plugin settings page, the plugin sends the provided credentials (email, password, OTP, phone number, store URL, and store name) to the RecomAI authentication endpoints.
* **Chatbot configuration (admin only):** After login, the plugin retrieves the chatbot embed token and widget configuration from the API using the administrator's email and authentication token.
* **WooCommerce connection (admin only):** When the administrator connects WooCommerce, the plugin sends WooCommerce REST API consumer keys and the store URL to the RecomAI API so that products can be synced for AI-powered recommendations.
* **Chat messages (storefront):** When a visitor sends a message through the chatbot widget, the message text, chatbot auth key, chat session ID, current store URL, and (if available) the Shopify/WooCommerce customer ID and cart contents are sent to the API. Responses are streamed back via Server-Sent Events (SSE).
* **Visitor registration (storefront):** When a visitor submits the pre-chat form, their name, email, phone number, and message are sent to the API to create a chat session.
* **Auto-nudge recommendations (storefront):** When a visitor views a product page, the product name and store owner ID are sent to the API to fetch contextual cross-sell suggestions.
* **Customer recommendations (storefront):** For logged-in customers, the customer ID, store URL, and auth token are sent to fetch personalized product recommendations.
* **Cart click tracking (storefront):** When a visitor clicks a product recommendation, the click event data is sent to the API for analytics.

= RecomAI Socket.IO (https://api.recomai.one) =

The chatbot widget establishes a persistent Socket.IO (WebSocket) connection to `https://api.recomai.one` for real-time features:

* **Live support chat:** When the conversation is handed off to a human agent, messages from the agent are received in real time, and visitor messages and typing indicators are sent over this connection.
* **Session management:** The chat session ID is emitted on connection to associate the socket with the active conversation.
* **Support mode toggle:** The server can switch the conversation between AI and human-support modes in real time.
* **Message feedback:** When a message rating is submitted, the feedback is synchronized via this connection.

This connection is only established when the chatbot widget is loaded on the storefront and the chatbot is enabled.

= RecomAI Dashboard (https://app.recomai.one) =

The plugin links to the RecomAI web dashboard for chatbot management and onboarding. The administrator's authentication token is passed as a URL parameter when redirecting to the dashboard. No visitor data is sent to this URL.

* **Service provider:** Destinova AI Labs
* **Service URL:** https://recomai.one
* **Terms of Use:** https://www.recomai.one/ai-terms
* **Privacy Policy:** https://www.recomai.one/privacy-policy



== Frequently Asked Questions ==

= What is RecomAI? =

RecomAI is an advanced AI-powered e-commerce personalization platform designed to boost sales and enhance customer experiences. It combines intelligent product recommendations, an AI chatbot for real-time support, and features like AI skin analysis to guide shoppers, automate interactions, and increase conversions.

= How does RecomAI work? =

RecomAI works by analyzing shopper intent through browsing behavior, chat interactions, and data like facial scans (for skincare). It uses GPT-powered AI to generate real-time personalized recommendations, automate responses via its chatbot, and apply smart logic-based suggestions to guide purchases.

= Is RecomAI legit? =

Yes, RecomAI is a legitimate platform trusted by over 100 active Shopify stores and has influenced more than $2 million in merchant revenue. It's developed by the DPIIT-registered startup Destinova AI Labs and is available on the official Shopify App Store with a 5-star rating. The platform complies with data privacy regulations like GDPR and CCPA.

= Does RecomAI slow down my site? =

No, RecomAI is designed for high-speed performance. It uses a lightweight integration script that ensures your site's loading speed and user experience remain top-notch.

= Do I need a RecomAI account? =

Yes, this plugin serves as a bridge to the RecomAI SaaS platform. You will need to sign up at RecomAI to activate the chatbot functionality.

= Is it free? =

The plugin itself is free to install. RecomAI offers various plans, including a Forever Free plan for smaller stores and a 14-day free trial for premium features.

= What happens if the AI can't answer a question? =

RecomAI supports a hybrid model where it can automatically offer to hand over the conversation to a human support agent if it encounters a complex query it cannot resolve.


== Screenshots ==

1. The RecomAI Chatbot admin dashboard
2. The AI Chatbot widget on a WooCommerce store front
3. WooCommerce product synchronization and connection status
4. Advanced store analytics and AI insights within the dashboard
5. Store analytics and AI insights within the dashboard

== Changelog ==

= 1.0.2 =
* Updated the chatbot widget to the latest version.
* Added contact action bar with social media links.
* Improved question chaining flows.
* Improved phone number matching for order tracking (international formats).
* Added HTML sanitization for chatbot content.

= 1.0.1 =
* Initial public release.
* Added WooCommerce automated authorization flow.
* Fixed guidelines compliance issues.

