Title: KolossusAI Chat
Author: kolossusai
Published: <strong>9 أكتوبر، 2026</strong>
Last modified: 27 أكتوبر، 2026

---

البحث عن الإضافات

![](https://ps.w.org/kolossusai-chat/assets/icon-256x256.png?rev=3736363)

# KolossusAI Chat

 بواسطة [kolossusai](https://profiles.wordpress.org/kolossusai/)

[تنزيل](https://downloads.wordpress.org/plugin/kolossusai-chat.1.6.0.zip)

 * [تفاصيل](https://ar.wordpress.org/plugins/kolossusai-chat/#description)
 * [المراجعات](https://ar.wordpress.org/plugins/kolossusai-chat/#reviews)
 *  [التنصيب](https://ar.wordpress.org/plugins/kolossusai-chat/#installation)
 * [التطوير](https://ar.wordpress.org/plugins/kolossusai-chat/#developers)

 [الدعم](https://wordpress.org/support/plugin/kolossusai-chat/)

## الوصف

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, or you can use the free FAQ assistant.

**No account? Use the free FAQ assistant.** Tick “Use free FAQ assistant (no Kolossus
account needed)” in the settings and save. The chat then answers visitors’ questions
from your website’s own public pages (products, policies, contact details and so
on), with a limited number of messages per visitor.

**Don’t have an agent yet?** Contact the KolossusAI team at [kolossus.ai](https://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.ai`
   unless you change it). Nothing loads until you save a widget token or choose 
   the free FAQ assistant. 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.
 * **Free FAQ assistant only:** with each message the browser also sends the address
   of the page the visitor is on (without its query string), and the KolossusAI 
   server reads your site’s public pages (that page, your sitemap and a few matching
   pages) to answer. That page text is sent, with the visitor’s question, to the
   AI model that writes the answer, and may be kept with that chat and in a short-
   term cache (up to an hour).
 * **Service provider:** KolossusAI. Terms of service: https://kolossusai.in/terms/.
   Privacy policy: https://kolossusai.in/privacy/.

## المكوّنات

تقدّم هذه الإضافة مكوّن واحد (1).

 *   KolossusAI Chat button A button that opens your KolossusAI chat. Uses the widget
   token from Settings → KolossusAI Chat.

## التنصيب

 1. Install and activate the plugin.
 2. In your KolossusAI dashboard, create a widget for your agent and add your site’s
    domain (for example `example.org`) to its allowed domains.
 3. In WordPress, go to Settings  KolossusAI Chat.
 4. Enter the widget token, which starts with `wt_`, or tick “Use free FAQ assistant”
    if you have no KolossusAI account (skip step 2 then). 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.
 5. 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.
 6. 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://`).

## الأسئلة المتكررّة

### 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 with `ws_`) is optional and goes
in its own field. It never reaches visitors’ browsers.

### What is the free FAQ assistant?

A ready-made KolossusAI assistant for sites without a KolossusAI account. Tick “
Use free FAQ assistant (no Kolossus account needed)” under the widget token and 
save. It answers from your website’s public pages only, so it can’t answer about
orders, accounts or anything behind a login. Each visitor gets a limited number 
of messages. The widget secret is not used with it, so all its chats are anonymous.
For your own trained agent, untick it and enter a widget token.

### 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.

### How do I add a chat button to a page?

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 with `class="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.

### The product page button does not appear.

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_sitewide` filter:

    ```
    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.

## المراجعات

لا توجد مراجعات لهذه الإضافة.

## المساهمون والمطوّرون

“KolossusAI Chat” هو برنامج مفتوح المصدر. وقد ساهم هؤلاء الأشخاص بالأسفل في هذه 
الإضافة.

المساهمون

 *   [ kolossusai ](https://profiles.wordpress.org/kolossusai/)

[ترجمة ”KolossusAI Chat“ إلى لغتك.](https://translate.wordpress.org/projects/wp-plugins/kolossusai-chat)

### مُهتم بالتطوير؟

[تصفّح الشفرة](https://plugins.trac.wordpress.org/browser/kolossusai-chat/)، تحقق
من [مستودع SVN](https://plugins.svn.wordpress.org/kolossusai-chat/)، أو الاشتراك
في [سجل التطوير](https://plugins.trac.wordpress.org/log/kolossusai-chat/) بواسطة
[RSS](https://plugins.trac.wordpress.org/log/kolossusai-chat/?limit=100&mode=stop_on_copy&format=rss).

## سجل التغييرات

#### 1.6.0

 * Works on older sites: WordPress 5.8 and newer, WooCommerce 6.0 and newer.
 * Fixed a fatal error on product pages on WordPress 5.8.

#### 1.5.0

 * New “Use free FAQ assistant (no Kolossus account needed)” option: the chat answers
   visitors from your website’s own pages, without a widget token.
 * Saving without a widget token now shows a message asking for one or for the free
   FAQ assistant.

#### 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.

## ميتا Meta

 *  Version **1.6.0**
 *  Last updated **قبل 22 ساعة**
 *  Active installations **أقل من 10**
 *  WordPress version ** 5.8 أو أعلى **
 *  Tested up to **7.1.3**
 *  PHP version ** 7.4 أو أعلى **
 *  Language
 * [English (US)](https://wordpress.org/plugins/kolossusai-chat/)
 * Tags
 * [AI](https://ar.wordpress.org/plugins/tags/ai/)[chat](https://ar.wordpress.org/plugins/tags/chat/)
   [chatbot](https://ar.wordpress.org/plugins/tags/chatbot/)[live chat](https://ar.wordpress.org/plugins/tags/live-chat/)
   [woocommerce](https://ar.wordpress.org/plugins/tags/woocommerce/)
 *  [عرض متقدم](https://ar.wordpress.org/plugins/kolossusai-chat/advanced/)

## التقييم

لم يتم تقديم أي مراجعات بعد.

[Your review](https://wordpress.org/support/plugin/kolossusai-chat/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/kolossusai-chat/reviews/)

## المساهمون

 *   [ kolossusai ](https://profiles.wordpress.org/kolossusai/)

## الدعم

لديك شيء لتقوله؟ بحاجة الى مساعدة؟

 [عرض منتدى الدعم](https://wordpress.org/support/plugin/kolossusai-chat/)