Samomind – AI Chatbot That Answers From Your Content Wordpress Plugin - Rating, Reviews, Demo & Download
Plugin Description
Visitors ask the same questions again and again: what do you charge, where are you, how do I book. Samomind lets your site answer them for you, from your own pages, and links to the page each answer came from.
Running a WooCommerce shop? Your customers can also ask “Where is my order?” and check their own order in the chat, after proving it is theirs.
The plugin connects this site to your Samomind account. Your public pages, posts and products are pushed to your Samomind knowledge base and kept up to date as you edit, so the assistant never answers from stale content. You can then show the Samomind chat widget on your site with one switch. A Samomind account is needed. Create one at https://app.samomind.com; it starts with a 7-day free trial, and plans are on https://samomind.com/pricing/.
- Connect with a one-time code from your Samomind dashboard: nothing to copy by hand.
- Full sync on connect, then updates as you publish, edit, trash or unpublish.
- Pages, posts and WooCommerce products by default; public custom post types if you tick them.
- Daily check-in and reconcile, so Samomind and the site stay in step.
- Runs in the background on Action Scheduler (with WooCommerce) or WP-Cron.
- Optional: adds the Samomind chat widget to every page.
- Optional, for WooCommerce 8.2 or newer: customers check the status of their own orders in the chat. Off until you switch it on.
- WP-CLI:
wp samomind status|connect|disconnect|sync|reconcile|checkin.
Order status in the chat
Order status is part of the Samomind service for shops running WooCommerce 8.2 or newer. A customer asks the assistant where their order is, and proves it is theirs in one of two ways: a 6-digit code that your shop emails to the order’s billing address, or by being signed in to your shop. The assistant shows the order number, status and dates, and, if you choose, the item names and the tracking details.
It is off until you switch it on under Samomind > Settings > Order status in the chat, accept the order-data terms and paste an orders key from your Samomind dashboard (Orders > Setup). You can switch it off again at any time on the same page. It works with WooCommerce’s order tables (HPOS) on or off. The settings are always shown on that page; if something is missing (WooCommerce, pretty permalinks), the page says what.
What is sent
Only published, public content that is not password-protected: for each page, post, public custom post type item or WooCommerce product, its id, address, title, text (the rendered content as plain text, the excerpt and, for products, the short description), type, last modified time and the names of its public categories and tags. Products add the price as the shop shows it to visitors (for example “$70.00 (was $100.00)” or “$30.00 to $50.00”) and the stock status.
Never sent by the content sync: drafts, scheduled, private or password-protected content, users, visitors, comments, form entries, orders, carts, customers or media files. Order status is separate: it reads one order at a time, only when a verified customer asks about it (see External services). WooCommerce products whose catalog visibility is Hidden are never sent; products set to Shop only or Search results only are, because their pages are public.
Choose the post types under Samomind > Settings > What is synced (posts, pages and WooCommerce products are ticked by default, other types start unticked). Unticking a type removes its items from Samomind. Developers can also use the SAMOMIND/content/post_types filter (it runs after that setting) and SAMOMIND/content/excluded_ids to leave out single posts.
External services
This plugin is the connector for Samomind, a hosted service of SoftwaresKe Ltd. It talks to two Samomind hosts: the Samomind API (https://api.samomind.com, or the API base URL an administrator sets) and, only if the chat widget is switched on, the widget host (https://widget.samomind.com).
Service: https://samomind.com
Terms of service: https://samomind.com/terms-and-conditions/
Privacy policy: https://samomind.com/privacy-policy/
1. The Samomind API, from the server
Nothing is sent when the plugin is installed or activated. Requests start only after an administrator saves an ingest key and clicks Connect (or runs wp samomind connect), or pastes a connection code and clicks Connect. Every request below except the connection code is a signed POST to /api/v1/ingest/.... Each carries the API version, the key id, a timestamp, a request id and an HMAC signature in headers; the secret itself is never sent. WordPress adds its standard User-Agent, which names the WordPress version and this site’s address, and Samomind sees the server’s IP address.
- Connect with a code (
/api/v1/plugin/connect): an unsigned HTTPS POST that carries the connection code the owner pasted, the site’s home address and site address, the plugin version and the WordPress version. When: only when an administrator pastes a code under Samomind > Settings and clicks Connect, never in the background. Why: to trade the one-time code for this site’s keys, so the owner does not have to copy three values by hand. Returns the public site key (for the chat widget), an ingest key id, a new ingest secret and the API address, which the plugin saves in its own settings (the secret is stored like a password, kept out of autoload and never shown again). The code is never saved or logged. The plugin sends it only to an https address (plain http only for localhost), checks the server’s certificate and does not follow redirects. - Connect, Reconnect (
/connect): the site address, the word “wordpress”, the plugin version and the WordPress version. Returns an id for this connection, the service’s limits and the check-in interval. A first sync follows. - Check-in (
/checkin): the connection id, the plugin version, the WordPress version and, if the last request failed, that error’s code and message (up to 500 characters). When: about once a day from WP-Cron, when an administrator clicks “Check in now” or opens Samomind > Status (at most once a minute), or runswp samomind checkin. Returns the connection status and how often to check in. - Sync (
/syncand/documents): when a sync starts and finishes, and in batches in between, for each published, public, not password-protected item of the post types ticked in Settings: its post id, address, title, text (the content as plain text, the excerpt and, for products, the short description), type (post, page, product or custom), last modified time and the names of its public categories and tags. Products add price and stock status. When: on Connect, on “Sync now” andwp samomind sync. Returns, per item, whether it was accepted, unchanged or refused. - Changes (
/documentsand/documents/delete): when an item is published, edited, unpublished, trashed or deleted, or when a post type is ticked or unticked. The first sends that item as above; the second sends only post ids. Sent about 30 seconds after the last save. - Reconcile (
/reconcile): the post id and last modified time of every included item, in pages, with the id range. When: daily after the check-in, “Reconcile now”,wp samomind reconcile. Returns the ids Samomind lacks, holds out of date or has removed, which the plugin then sends or ignores. - Disconnect (
/disconnect): the connection id and the reason, “admin” or “uninstall”. When: an administrator clicks Disconnect, or the plugin is deleted while connected. Deactivating sends nothing.
Never sent: drafts, scheduled, private or password-protected content, users, comments, form entries, orders, carts, customers, media files, the WordPress admin’s data, or the list of other plugins.
2. The Samomind chat widget, from your visitors’ browsers
Only if an administrator ticks “Show the Samomind chat widget on this site” and saves a site key. The plugin then adds one script tag to the pages visitors see (never the admin, login page, feeds or REST responses). The widget is off by default. No widget request of any kind happens unless an administrator switches the widget on; with it off, no page loads anything from Samomind.
- On every page view: the visitor’s browser requests
widget.jsandwidget.cssfromhttps://widget.samomind.com, and askshttps://api.samomind.com/api/v1/widget-appearancefor this site’s colours and label, passing the site key. Samomind therefore sees the visitor’s IP address, browser details and the address of the page. - When a visitor opens the chat: the browser loads the chat script
chat.jsfromhttps://widget.samomind.com. This is the service’s own code, not a copy of a third-party library. - When a visitor chats: the browser sends the site key and a random visitor id to
/api/v1/session, then each message the visitor types, with the conversation id, to/api/v1/chat, and reads the answer with its sources. If the visitor opens their history or asks for a human, the browser also requests their earlier conversations, or sends the name, email address or phone number they type into that form. The random visitor id and the conversation id are kept in the visitor’s browser (local storage) so the conversation continues; no cookie is set.
Like any web request, the visitor’s browser requests to widget.samomind.com and api.samomind.com reach Samomind’s servers with the visitor’s IP address and browser user agent. See the privacy policy: https://samomind.com/privacy-policy/
3. Order status in the chat (WooCommerce 8.2 or newer)
Part of the Samomind service. Off by default. Only if an administrator ticks “Let customers check order status in the chat” under Samomind > Settings, accepts the order-data terms (the version, the administrator’s user id and the time are recorded) and pastes an orders key from the Samomind dashboard. WooCommerce must be active; multisite networks are not supported. With this off, the plugin does nothing described in this section. The one exception is the short report below, which goes with the connect and check-in requests of section 1.
This is the one case where the plugin also receives requests from Samomind’s servers: HTTPS POSTs to /wp-json/samomind/v1/orders/ on this site. Each is signed with the orders key (a key separate from the ingest secret, never sent) and carries a timestamp and a one-time value; a request that is not validly signed is refused. The same WordPress site also answers its own visitors’ browsers at /wp-json/samomind/v1/orders/account-proof (same site only, for a logged-in customer) and admin-ajax.php?action=samomind_nonce.
- When a customer asks the chat about an order and types an order number and the billing email, Samomind sends this site the order number and the typed email address, to be checked. If they match, this site’s own WordPress mail sends a 6-digit code to the order’s billing address, from the sender WooCommerce uses for its emails. The code is stored on this site only as a hash, for 10 minutes by default.
- When the customer enters the code, Samomind sends the code to be checked. If it is right, this site lets that one chat read that one order for 30 minutes by default.
- A logged-in customer can skip the email: the browser asks this site for a signed proof that says the visitor is logged in (it names nobody), and this site records the login session it came from. Logging out of the shop ends access at once.
- While access lasts, Samomind asks for the order and this site answers with the order number, status, dates and, only if you share them, the item names, and the tracking carrier, number and link (read from WooCommerce Shipment Tracking or Advanced Shipment Tracking, if installed). Never sent: addresses, phone numbers, email addresses, payment details, totals, discounts, refunds, customer or order notes, the customer’s name or other orders.
- Once order status is on, the connect and check-in requests of section 1 also carry a short report: whether order status is on, the version of the order-data terms accepted, whether item names and tracking are shared, which tracking plugin was found (if any), whether the shop uses WooCommerce’s order tables, the WooCommerce version, how code emails are sent, and the reason if it is off. After you switch it off, one more report says so, and then the report stops.
- “Share tracking” is on and “Share item names” is off by default; both are shown next to the opt-in and are enforced on this site.
- Samomind does not store the email address, the code or orders. See the privacy policy for what it keeps. The plugin’s own request log never records an email, a code or order data.
- No order data is sent unless a customer verifies an order. With the setting off, nothing new leaves or enters this site, and no cookie is added.
No other outbound requests are made. There is no tracking, usage analytics or advertising. The plugin adds no links to your site’s pages. When you switch the chat widget on, the chat window’s footer shows “Powered by Samomind” with a link to https://samomind.com on plans that include it; it is left out on higher plans.
Screenshots
Samomind > Settings: connect with a code, the Advanced fold for entering keys by hand, the content types that are synced and the chat widget switch.
The content types list and the sync status, with the number of items kept in step with Samomind.
The chat widget’s welcome screen on a live site, with suggested questions.
An answer from the chat widget, with a link to the source page.
The chat widget on a phone-sized screen.
Order status in the chat: the opt-in, the order-data terms, the orders key and what the assistant may say.

