WordPress Plugin

Add ChatReact AI chatbots, contact forms, and FAQ accordions to your WordPress site with our official plugin.

Download

Download ChatReact Plugin v1.1.0

Installation

Method 1: Upload via WordPress Admin

Download the plugin ZIP file above
Go to Plugins → Add New → Upload Plugin
Choose the ZIP file and click Install Now
Click Activate Plugin

Method 2: Manual Upload via FTP

Extract the ZIP file
Upload the chatreact folder to /wp-content/plugins/
Go to Plugins in WordPress admin
Find "ChatReact" and click Activate

Configuration

After activation, go to Settings → ChatReact for usage instructions.

Finding Your Chatbot ID

Log in to chatreact.ai
Go to your chatbot's Dashboard
Click the Copy button next to the Chatbot ID (shown at the top)

Finding Your Form ID

Log in to chatreact.ai
Go to Forms
Select your form
Copy the Form ID

Usage Options

The plugin offers multiple ways to add ChatReact to your site:

1. Shortcodes

Add to any page, post, or widget area:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Optional attributes: position, language, primary_color, auto_open

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Optional attributes: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Optional attributes: categories, container, language

2. Gutenberg Blocks

In the block editor:

Click + to add a block
Search for "ChatReact"
Choose Chat Widget, Form Widget, or FAQ Widget
Enter your ID in the block settings

3. Elementor

If you use Elementor:

Edit your page with Elementor
Search for "ChatReact" in widgets
Drag the widget to your page
Configure in the left panel

4. Page-Level Assignment

Assign widgets to specific pages without shortcodes:

Edit any page or post
Find the "ChatReact Widget" meta box
Select a widget type
Enter your ID
Save the page

Shortcode Examples

Basic Chat Widget

[chatreact id="abc123"]

Chat Widget with Options

[chatreact id="abc123" position="bottom-left" language="de" auto_open="true"]

FAQ with Category Filter

[chatreact_faq id="abc123" categories="shipping,returns"]

Styled Contact Form

[chatreact_form id="form123" language="en"]

Supported Languages

The plugin supports 24 EU languages:

Bulgarian, Croatian, Czech, Danish, Dutch, English
Estonian, Finnish, French, German, Greek, Hungarian
Irish, Italian, Latvian, Lithuanian, Maltese, Polish
Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish

Troubleshooting

Widget Not Appearing

Verify your Chatbot ID is correct
Check if the chatbot is active in your ChatReact dashboard
Clear any page caching plugins (see below)
Check browser console for JavaScript errors

Caching Plugin Compatibility

The plugin is fully compatible with popular caching and optimization plugins including WP Rocket, LiteSpeed Cache, Autoptimize, and WP Super Cache. The plugin automatically prevents these tools from minifying or caching ChatReact scripts.

If you still experience issues (e.g., 404 errors, widget not loading for logged-out visitors):

Clear your caching plugin's cache
Exclude chatreact from JS minification/combination in your caching plugin settings
The plugin uses data-api-url attributes as a fallback to ensure correct API communication

Styling Conflicts

If the widget looks broken:

The widget uses isolated CSS
Check for CSS !important rules in your theme
Try disabling other chat plugins temporarily

Multiple Widgets

You can use different chatbots on different pages by specifying unique IDs in each shortcode or block.

CMS Integration (Smart Sitemap)

Starting with version 1.1.0, the ChatReact WordPress plugin includes a Smart Sitemap feature that provides the ChatReact crawler with structured content metadata directly from your WordPress site.

How It Works

Generate an Integration Key on the ChatReact dashboard (Knowledge Base → Websites → CMS Integrations)
Paste the key in the WordPress plugin settings under the Integration tab
Select content types you want to share (Pages, Posts, Custom Post Types)
Set priorities (High/Medium/Low) per content type
When you crawl your website, ChatReact will automatically use the smart sitemap instead of regular link-based discovery

Benefits

Faster crawling – Direct URL list instead of link-by-link discovery
Content type awareness – The crawler knows whether a URL is a Page, Post, or Custom Post Type
Priority-based indexing – Important content (like Pages) can be weighted higher than blog posts
Selective sharing – Only share the content types you want
Per-post exclusion – Exclude individual posts/pages from the sitemap via the meta box

Priority Levels

Priority	Default for	Description
High	Pages	Core business content (About, Services, Contact)
Medium	Posts	Blog articles, news updates
Low	–	Supplementary content

Security

The smart sitemap endpoint (/wp-json/chatreact/v1/sitemap) is protected by the Integration Key. It is not visible to search engines or other crawlers — only ChatReact can access it with the correct key.

Excluding Individual Posts

In the WordPress editor, each post/page has a ChatReact Widget meta box with an option to "Exclude from ChatReact Sitemap". Checked posts will not appear in the smart sitemap.

Requirements

WordPress 5.8 or higher
PHP 7.4 or higher
A ChatReact account (sign up free)

Changelog

1.1.0

NEW: Smart Sitemap (CMS Integration) — structured content sharing with ChatReact crawler
NEW: Integration tab in plugin settings
NEW: Content type selection with priority levels
NEW: Per-post exclusion from sitemap via meta box
NEW: Protected REST API endpoint for smart sitemap
FIX: Full compatibility with caching plugins (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
FIX: Widget loading issues for logged-out visitors with caching plugins
CHANGED: Widget settings are now managed centrally in the ChatReact dashboard — removed position, language, primary color, and auto-open settings from the plugin

1.0.24

Gutenberg blocks support
Elementor integration
24 language translations
Page-level widget assignment