Description
KolossusAI Chat connects your WordPress site to your AI agent built in KolossusAI. Visitors can ask questions and get answers from your assistant without leaving the page.
- A chat bubble on every page, or only where you add the KolossusAI Chat button block or the
[kolossus_chat]shortcode. - Bubble, sidebar or bottom-bar layout, set in your KolossusAI dashboard.
- Choose light, dark or automatic theme, the accent colour and the layout from WordPress.
- Place the chat bubble anywhere: pick the bottom-right or bottom-left corner and set the X and Y distance in pixels. Small, medium or large size.
- Choose what happens on page load: remember each visitor’s last state, always open, or start minimized.
- Optional: logged-in WordPress users chat under their own name, with their history kept (needs the widget secret, which stays on your server).
For WooCommerce stores (the options appear in the settings when WooCommerce is active, and are off until you turn them on):
- An “Ask about this product” button on every product page, below Add to cart or below the product summary. Shown also for out-of-stock products, and the text is yours to change.
- Hide the chat bubble on the Cart, Checkout and Order received pages, so shoppers stay focused while they pay. Works with the classic and the block-based Cart and Checkout.
- Logged-in customers chat under their own name and keep their history (with the widget secret).
- Compatible with High-Performance Order Storage (HPOS) and the Cart and Checkout blocks. The plugin never reads or changes your orders, products or customers.
You need a KolossusAI account and a widget created for your agent in the KolossusAI dashboard.
Don’t have an agent yet? Contact the KolossusAI team at kolossus.ai. They will set up a personalised agent for your business and give you the widget token to use with this plugin.
External services
This plugin connects to the KolossusAI service to show the chat and answer questions. Without it the plugin does nothing.
- What is loaded: the chat script (
widget.js) from the KolossusAI server set as the Host URL in Settings KolossusAI Chat (https://engine.kolossus.aiunless you change it). Nothing loads until you save a widget token. It then loads on every front-end page when the site-wide bubble is on (except store pages you chose to hide it on), otherwise only on pages that show a chat button: the block, the[kolossus_chat]shortcode or the WooCommerce product button. - What is sent, and when: when the page loads, the visitor’s browser sends your widget token to load the chat settings. When the visitor chats, it sends their messages, any files they attach, their IP address and approximate location (city and country) to the KolossusAI server so the assistant can reply.
- Service provider: KolossusAI. Terms of service: https://kolossusai.in/terms/. Privacy policy: https://kolossusai.in/privacy/.
Blocks
This plugin provides 1 block.
- KolossusAI Chat button A button that opens your KolossusAI chat. Uses the widget token from Settings → KolossusAI Chat.
Installation
- Install and activate the plugin.
- In your KolossusAI dashboard, create a widget for your agent and add your site’s domain (for example
example.org) to its allowed domains. - In WordPress, go to Settings KolossusAI Chat.
- Enter the widget token, which starts with
wt_. The KolossusAI Host URL is already filled in (https://engine.kolossus.ai); change it only if you were given a different address. Optionally add the widget secret (ws_) and choose the theme, accent colour and layout. - Leave “Show the chat on every page” ticked for a site-wide bubble, or untick it and add the KolossusAI Chat button block or the shortcode where you want a button.
- On a WooCommerce store, optionally turn on the product page button and choose the store pages to hide the bubble on, in the WooCommerce section of the same settings page.
If your site uses a Content Security Policy, allow your KolossusAI host in script-src and in connect-src (both https:// and wss://).
FAQ
-
Where do I find the widget token?
-
In your KolossusAI dashboard, open the settings of your agent’s widget. Use the public token that starts with
wt_. If you don’t have an agent or a dashboard account yet, contact the KolossusAI team at https://kolossus.ai/ and they will provide your agent and its token. The widget secret (it starts withws_) is optional and goes in its own field. It never reaches visitors’ browsers. -
What does the widget secret do?
-
When it is saved, WordPress signs the email of each logged-in user with it (HMAC-SHA256) and passes the signature to the chat. KolossusAI checks the signature, so those users get a verified chat under their own name and keep their history. Visitors who are not logged in chat anonymously.
-
The bubble does not appear.
-
Check that the Host URL starts with
https://, that the token is correct, and that your site’s domain is in the widget’s allowed domains. Caching or security plugins (for example Cloudflare or Wordfence) may also need to allow your KolossusAI host. -
In the block editor, add the KolossusAI Chat button block and set its text in the block settings. It takes your theme’s button style. Or add the shortcode
[kolossus_chat label="Ask our assistant"]; you can add your own CSS class withclass="my-button". -
Does it work with WooCommerce?
-
Yes. With WooCommerce active, the settings page gets a WooCommerce section: an “Ask about this product” button for product pages, and options to hide the chat bubble on the Cart, Checkout and Order received pages. The button opens the chat; your assistant is not told which product the shopper is looking at. Shoppers who are logged in chat under their own name when the widget secret is saved; guests chat anonymously.
-
Some block themes and page builders build the product page without WooCommerce’s usual hooks. Add the KolossusAI Chat button block to the Single Product template (Appearance Editor Templates), or the shortcode to your product layout, instead.
-
How do I hide the bubble on some pages?
-
On WooCommerce stores, tick the pages under “Hide the chat bubble on”. For any other page, use the
kolossus_chat_show_sitewidefilter:add_filter( 'kolossus_chat_show_sitewide', function ( $show ) { return is_page( 'contact' ) ? false : $show; } );To hide the product button on some products, use
kolossus_chat_show_product_button, which also receives the product. -
Does it work on WordPress.com?
-
Yes on Business and Commerce plans, which allow plugins. Not on the Free, Personal or Premium plans.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“KolossusAI Chat” is open source software. The following people have contributed to this plugin.
Contributors
Translate “KolossusAI Chat” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.4.0
- WooCommerce: an “Ask about this product” button for product pages, with its own text, placed below Add to cart or below the product summary.
- WooCommerce: hide the chat bubble on the Cart, Checkout and Order received pages, including the block-based Cart and Checkout.
- WooCommerce: declared compatible with High-Performance Order Storage and the Cart and Checkout blocks.
- New KolossusAI Chat button block for the block editor and site editor.
- Nothing changes on your site until you turn the new options on.
1.3.0
- Bubble position settings: corner (bottom right or bottom left) plus horizontal (X) and vertical (Y) offsets in pixels. The chat panel opens just above the bubble.
- “Bubble size” setting: small, medium (default) or large.
1.2.1
- The Host URL is now pre-filled with the KolossusAI server, so you only need to add the widget token. You can still change it.
- Settings page explains how to get a personalised agent from the KolossusAI team.
- Use the KolossusAI name throughout.
1.2.0
- “On page load” setting: remember the visitor’s last state (default), always open, or start minimized. Previously the chat always reopened on refresh.
1.1.0
- Theme (auto, light, dark), accent colour and layout settings.
- Optional widget secret for verified chat for logged-in users.
- Accept http:// Host URLs on localhost for testing.
1.0.0
- First release.