Manova AI Sales Assistant

Description

Manova is an AI sales and support assistant for online shops, made for Persian-speaking stores. This plugin connects your WooCommerce store to your Manova assistant with a single key:

• One-step install. The Manova chat widget appears on every page of your site. No theme edits, no code.
• Live products. Product names, prices, sale prices, stock and images are synced to the assistant, and every change reaches it within seconds. The assistant never guesses a price.
• Product cards in the chat. When a customer asks about a product, the assistant shows cards with the picture, the price and an “Add to cart” button.
• Order tracking in the chat. A customer sends the order number and the mobile number used at checkout, and gets the order status, items and tracking code, on your website and in your Telegram and Bale bots. Both numbers must match, so nobody can read someone else’s order.
• Pay right in the chat. The assistant (if you allow it) and your support team can send a payment card for products. When the customer opens it, the plugin makes a pending order at your current prices and sends them to your own checkout’s pay page, so the money goes through your own gateway. When the order is paid, the card in the chat shows it.
• Know who is chatting (optional). Turn on “Tell Manova who logged-in customers are” and your support team sees a logged-in customer’s name, email and mobile number in the desk, marked “logged in on the site”, and the customer can ask where their order is without typing a mobile number. Off by default.
• A real team behind it. When the assistant cannot answer, the conversation goes to your support team in the Manova desk.

The plugin works with the standard WooCommerce order numbers and with the common sequential order number plugins, and reads tracking codes from WooCommerce Shipment Tracking and the usual tracking-code fields of Iranian post plugins. Developers can adjust lookups with the manova_find_order, manova_order_phones, manova_order_tracking and manova_order_answer filters.

A Manova account is required. You can start with a free trial at manova.ir.

External services

This plugin connects your site to Manova (https://manova.ir), the service that runs the AI assistant. It is needed for everything the plugin does.

• When you connect (you paste a connection key and click “Connect”) the plugin sends your site address, the address of its order-lookup endpoint, your store currency and the WordPress, WooCommerce and plugin versions to https://manova.ir/api/v1/external/store.
• Product sync. After connecting, and whenever a product changes, the plugin sends published products to the same address: name, link, image link, SKU, price, sale price, stock status and quantity, categories, tags, short description, an “add to cart” link and the number of sales. Hidden, draft, private and password-protected products are not sent. A full sync also runs once a day.
• Chat widget. Every page of your site loads the chat widget script from https://manova.ir/widget.js. What visitors type in the chat is sent to Manova to be answered. To keep a conversation going between pages, the widget stores a random visitor ID and a random device key in the visitor’s browser (local storage, not cookies); they contain no personal data.
• After an update. When the plugin is updated (by hand or automatically), it sends the same details as when you connected once more, so Manova knows which plugin version your site runs.
• Order lookups. When a customer asks about an order in the chat, Manova calls your site’s /wp-json/manova/v1/order endpoint with the order number and the mobile number the customer gave. The request is signed with your connection key and answered only when both numbers match an order. The answer contains the order status, date, total, item names and quantities, shipping method and tracking code. No other customer data leaves your site.

• Payments in the chat. When a customer opens a payment card from the chat, Manova calls your site’s /wp-json/manova/v1/payment-link endpoint (signed the same way) with the product ids and quantities and, if the customer left them in the chat, their name, mobile number and email. The plugin creates a pending order and answers with its number, total and pay page address. Manova may also call /wp-json/manova/v1/payment-status to check whether it was paid. When such an order is paid, cancelled or refunded, the plugin sends its number, status, total and pay page address to https://manova.ir/api/v1/external/store/payments.

• Logged-in customers (only if you turn on “Tell Manova who logged-in customers are”). For a customer who is logged in, the widget asks your site (/wp-admin/admin-ajax.php?action=manova_identity, with the customer’s own cookies, never cached) for a token. The plugin answers with a token that lives ten minutes and holds the user ID, name, email address and mobile number from the customer’s account, signed with a key derived from your connection secret (the secret itself never leaves your site). The widget sends the token to https://manova.ir/api/v1/external/widget/.../identify. Manova keeps the name, email and mobile number until a year after the customer was last seen in the chat, or until you ask Manova to delete them. When the customer asks about their orders, Manova calls your /wp-json/manova/v1/order endpoint with their user ID (signed like the other calls) and the answer contains the same order details as above. A cookie named manova_li (no personal data; it only says someone is logged in) is set for up to 14 days while the option is on. A suggested privacy policy text is added under Settings › Privacy.

Manova privacy policy: https://manova.ir/privacy

The chat widget shows a small “Powered by Manova” link inside the chat window. Paid Manova plans can turn it off in the Manova panel.