Description

Kreechat is a live-chat widget developed by SSPS Ltd. It gives you an easily modifiable chat widget for your WordPress website, connecting it to the Kreechat support platform.

Developed by Kristian Lachev, Kristiyan Danchov and Kristian Lalov.

Features

Six built-in widget themes (Daylight, Midnight, Aurora, Forest, Sunset, Graphite)
Advanced theme customization seeded from any built-in theme (colors, gradients, backgrounds)
Selectable icons for the launcher, send, attach, and minimize actions
Customizable buttons (labels, style, corners, width)
Customizable scrollbar (grip and track colors including transparent, hover and held-grip colors, thickness, corners, instant or fading hold)
Widget layout controls (position, header alignment, composer order)
Three admin-page themes with live preview
File exchange
Text chat
Customizable chat display name
Customizable welcome message

Requirements

WordPress 6.5 or higher — The chat widget uses the Script Modules / Interactivity API introduced in WordPress 6.5. The plugin will not activate on older versions.
PHP 7.4 or higher

External services

In order for the Kreechat plugin to work with our external messaging app, it communicates with our external API.
We use our external API to store and retrieve multiple important things.

widget/partials/api.js:6 const response = await fetch(“https://us1.kreechat.app/server/get-wordpress-messages”,{:
Retrieve the messages once a user opens the Kreechat widget. It sends the stored kreechat_token and the email of the user to our servers.
Terms of service: https://www.kreechat.com/privacy-policy/

widget/partials/script.js:280 const response = await fetch(‘https://us1.kreechat.app/server/send-wordpress-file’, {:
Stores files on our server sent by the Kreechat widget. The company wordpress token is sent to the server.
Terms of service: https://www.kreechat.com/privacy-policy/

$api_url = ‘https://us1.kreechat.app/server/create-wordpress-ticket’;
Creates a ticket when a new user opens the Widget and enters their email address. We send the company wordpress token and email to the server. This endpoint is used when a user opens the chat for the first time.
Terms of service: https://www.kreechat.com/privacy-policy/

includes/api-handler.php:35 $api_url = ‘https://us1.kreechat.app/server/register-wp-token’;:
Registers the WordPress token which the user has created previously inside of the Kreechat application.
Terms of service: https://www.kreechat.com/privacy-policy/

includes/api-handler.php:174 $api_url = ‘https://us1.kreechat.app/server/unregister-wordpress-token’;:
Deletes and unregisters the WordPress token previously registered. Nothing is sent to the Kreechat servers. Only the origin of the request.
Terms of service: https://www.kreechat.com/privacy-policy/

widget/partials/script.js:48 await fetch(‘https://us1.kreechat.app/server/new-url’, {:
Saves each visited route of the website the user is currently on for display inside of the Kreechat app. Sends the saved company wordpress token to our servers.
Terms of service: https://www.kreechat.com/privacy-policy/

/${message?.path}:
Retrieves a file from our servers. The message id alongside the company wordpress token are sent to our servers.
Terms of service: https://www.kreechat.com/privacy-policy/

wp_enqueue_script(‘socketio-client’, plugin_dir_url(FILE) . ‘assets/js/socket.io.min.js’, [], ‘4.7.5’, true);:
Kreechat uses socket.io for real-time communication between our servers and the Kreechat plugin.
Terms of service: https://www.kreechat.com/privacy-policy/

widget/partials/sockets.js:203 const response = await fetch(‘https://us1.kreechat.app/server/get-wordpress-jwt’, {:
This endpoint is used to create a secure JWT for our socket communication. It sends the company token to our servers when the token has expired or when a new connection is made.
Terms of service: https://www.kreechat.com/privacy-policy/

Installation

Login to your WordPress admin panel.
Go to “Plugins” on the sidebar.
Click on “Add Plugin” and search for “Kreechat”.
Install and activate Kreechat. The setup screen opens by itself.
Press “Connect instantly”. You will be asked to sign in — or to create a free account if you do not have one yet.
Confirm your site, then press “Connect site”. You are sent back to WordPress and the widget is live.

Prefer to do it by hand? Open “Use a token instead” on the setup screen, then generate a token in the Kreechat app under Admin Panel (top left icon) > Settings > Communication Services > WordPress. Each site needs its own token.

FAQ

Do I need a Kreechat account?: Yes, but you do not have to create one first. Press “Connect instantly” on the setup screen and you can register along the way — you will be brought straight back to finish connecting.
Can I use one token on more than one site?: No. Each site registers its own token, and a token already in use on another site is refused. Connect each site separately.
Is Kreechat free?: Yes, the WordPress plugin is free to use.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Kreechat” is open source software. The following people have contributed to this plugin.

SSPS

Translate “Kreechat” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.6

Added one-click “Connect instantly” setup: sign in, confirm your site, and you are sent back with the widget already live. No token to copy.
Setup is now a guided three step flow — connect, choose a look, go live — with a progress indicator on every step.
Finishing setup opens Kreechat in a second tab and points out that chats are answered there, not in WordPress.
The last step links straight to your own site so you can open the widget and try it.
Sites can now be connected without a Kreechat account first — you can register during setup and return to finish.
The setup screen explains what Kreechat is and links to account creation; pasting a token by hand is still available.
Kreechat now opens its setup screen on activation, adds a Connect link on the plugins list, and prompts while the site is unconnected.
Connection failures now say what went wrong and what to do — including when a token is already in use on another site.
The settings page no longer blocks on a token validation request every time it is opened.

1.1.5

Added an optional logout button so clients can clear their session and continue with another email address.
Stored WordPress tokens are now validated against Kreechat, including during WebSocket authentication.
Invalid tokens are disconnected safely and prompt administrators to connect a valid token.

1.1.4

Added scrollbar design controls: grip and track colors (solid, gradient, or transparent), hover and held-grip colors, thickness, corners, and whether the held grip changes instantly or fades in.
Scrollbar colors are now part of each built-in theme and of advanced customization, so “Reset to theme” restores them.
Every scrolling area in the widget now shares one scrollbar design, and Firefox picks up the grip and track colors.
The Appearance preview shows a longer sample conversation and stays pinned to the newest message.
Support bots can be exported to a JSON file, one at a time or all at once.
Bot export files can be imported from the Bots tab, including onto another site.
Fixed “Highlight edited area” drawing its outline over the neighbouring component when the message list or composer was the edited area.

1.1.3

Attachments that are too large or of an unsupported type now explain why instead of failing silently.
Oversized attachments are rejected when picked, before the upload starts.

1.1.2

Fixed WordPress chat message rate limiting.
Added automated support flows.
Improved real-time reconnection and chat history caching.
Fixed department selection and ticket state updates.

1.1.1

Fixed the plugin being unusable for logged-in WordPress administrators.

1.1.0

Fixed new chat messages requiring a page refresh to appear after the connection was dropped by the server.

1.0.9

Six built-in widget themes with WCAG AA validated palettes
Advanced customization mode seeded from the selected theme: colors, structured gradients, icons, layout, buttons
Live widget preview inside the admin Appearance tab
Tabbed admin settings (General, Appearance, Behavior) with three admin themes
Inline token management: masked display, reveal, copy, and safe in-place replacement that validates the new token before touching the old one
Save confirmations shown as dismissible notices
Uninstall now cleans up all plugin options

1.0.8

Fixed the emoji picker showing no emojis when the chat history failed to load.

1.0.7

Added edge case handling for blocked clients, closed tickets, and email re-verification restarts.

1.0.6

Fixed the logger module failing to load, which stopped the chat widget from initializing.

1.0.5

Initial Kreechat release