Description
Humassistant allows you to seamlessly integrate the Humassistant AI chatbot into your WordPress website. The plugin provides:
- Automatic Content Synchronization – Sync posts, pages, custom post types, and WooCommerce products to your chatbot’s knowledge base
- Multiple Integration Methods – 5 different ways to add the chatbot to your site
- User Data Mapping – Pass logged-in user data to the chatbot for personalized conversations
- Elementor Support – Extract content from Elementor pages for better synchronization
- WooCommerce Integration – Full support for product synchronization including attributes and variations
Chat Widget Integration (5 Methods)
- Auto-inject Footer – Automatically adds the chat widget to your site footer
- Shortcodes – Use
[humassistant]to embed chat anywhere - Elementor Widgets – Drag-and-drop widgets for Elementor page builder
- Gutenberg Blocks – Native blocks for the WordPress block editor
- WordPress Widget – Add to sidebars and footer areas via Appearance > Widgets
Display Modes
- Floating Widget – Fixed button that opens a chat popup
- Inline Chat – Embedded chat interface in your content
- Search Bar – Compact search-style interface
- Fullscreen – Full-page chat experience
Content Synchronization
The plugin automatically syncs your WordPress content to Humassistant:
- Posts and Pages
- Custom Post Types
- WooCommerce Products (with pricing, attributes, categories)
- Elementor page content extraction
- Custom field mapping
- Automatic deletion cleanup
Third-Party Service: Humassistant
This plugin connects to the Humassistant external service (humassistant.com) to provide AI chatbot functionality. The connection is required for the plugin to function, as the chatbot engine runs on Humassistant’s servers.
What data is sent to Humassistant:
- API authentication – Your API key is sent to
api.humassistant.comto authenticate and obtain an access token - Content synchronization – Post titles, content, metadata, and taxonomy terms are sent to
api.humassistant.comto build the chatbot’s knowledge base - Widget loading – The chat widget JavaScript is loaded from
cdn.humassistant.comto render the chatbot on your site. This is the core SaaS widget, dynamically generated per chatbot configuration (similar to services like Intercom, HubSpot, or Zendesk Chat) - User data (optional) – When explicitly enabled by the site administrator, basic logged-in user information (name, email) may be transmitted to personalize conversations. This is disabled by default and requires opt-in
Service links:
All data transmission uses secure HTTPS connections with JWT Bearer token authentication.
Screenshots




Blocks
This plugin provides 1 block.
- Humassistant Chat Embed the Humassistant chat widget. Configuration is managed from the Humassistant dashboard.
Installation
From WordPress Admin
- Download the plugin zip file
- Go to Plugins > Add New in your WordPress admin
- Click Upload Plugin and choose the zip file
- Click Install Now and then Activate
Manual Installation
- Upload the
humassistantfolder to/wp-content/plugins/ - Activate the plugin through the Plugins menu in WordPress
Configuration
- Go to Humassistant in your WordPress admin menu
- Enter your API Key (get it from app.humassistant.com)
- Select your Organization and Chatbot from the dropdowns
- Choose a Widget to embed on your site
- Enable Content Synchronization and select post types to sync
FAQ
-
How do I get an API key?
-
- Sign up at app.humassistant.com
- Go to Settings > API Keys
- Create a new API key with WordPress integration scope
- Copy the key and paste it in the plugin settings
-
Can I use multiple chatbots?
-
The plugin supports one chatbot per WordPress site. However, you can use shortcodes and blocks with custom parameters to create different chat experiences.
-
Does this work with page builders?
-
Yes! The plugin provides native integrations for:
- Elementor – Custom widgets with full content extraction
- Gutenberg – Native blocks
- Classic Editor – Via shortcodes and widgets
-
How does content synchronization work?
-
The plugin extracts content from your posts and pages and sends it to Humassistant’s API. For Elementor pages, it intelligently extracts text from widgets. For WooCommerce products, it includes pricing, descriptions, and attributes.
-
Can I customize the chatbot appearance?
-
Yes, all widget configuration (colors, position, avatar, voice, language) is managed from your Humassistant dashboard at app.humassistant.com.
-
Is user data secure?
-
User data sharing is optional and disabled by default. When enabled, it only shares basic information (name, email) for logged-in users to personalize conversations. All data transmission uses secure HTTPS connections with JWT authentication.
-
What about performance?
-
The plugin uses aggressive caching for API tokens (24 hours) and supports WordPress object cache for better performance. The widget script is loaded asynchronously and does not block page rendering.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Humassistant” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Humassistant” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.0.0
- Simplified widget embedding using widgetUuid approach
- All widget configuration managed from Humassistant dashboard
- Added WooCommerce customer sync on order completion
- Added WooCommerce custom checkout fields
- Added Elementor Pro form action integration
- Added per-chatbot content synchronization
- Added bulk include/exclude for content sync
- Improved API error handling with automatic token refresh
- Added developer hooks and filters
1.0.0
- Initial release
- Chat widget integration with 5 embedding methods
- Automatic content synchronization
- Elementor widgets
- Gutenberg blocks
- WordPress native widget
- User data mapping
- WooCommerce product sync