Humassistant

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)

  1. Auto-inject Footer – Automatically adds the chat widget to your site footer
  2. Shortcodes – Use [humassistant] to embed chat anywhere
  3. Elementor Widgets – Drag-and-drop widgets for Elementor page builder
  4. Gutenberg Blocks – Native blocks for the WordPress block editor
  5. 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 app.humassistant.com to authenticate and obtain an access token
  • Content synchronization – Post titles, content, metadata, and taxonomy terms are sent to app.humassistant.com to build the chatbot’s knowledge base
  • Widget loading – The chat widget JavaScript is loaded from widget.humassistant.com to 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

  1. Download the plugin zip file
  2. Go to Plugins > Add New in your WordPress admin
  3. Click Upload Plugin and choose the zip file
  4. Click Install Now and then Activate

Manual Installation

  1. Upload the humassistant folder to /wp-content/plugins/
  2. Activate the plugin through the Plugins menu in WordPress

Configuration

  1. Go to Humassistant in your WordPress admin menu
  2. Enter your API Key (get it from app.humassistant.com)
  3. Select your Organization and Chatbot from the dropdowns
  4. Choose a Widget to embed on your site
  5. Enable Content Synchronization and select post types to sync

FAQ

How do I get an API key?

  1. Sign up at app.humassistant.com
  2. Go to Settings > API Keys
  3. Create a new API key with WordPress integration scope
  4. 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.

Contributors

Translate “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.3

  • Updated widget CDN domain from cdn.humassistant.com to widget.humassistant.com

2.0.2

  • Updated API endpoint URL to use the new app.humassistant.com domain
  • Updated documentation to reflect the new API endpoint URL

2.0.1

  • Added Spanish (es_ES) translation
  • Added Italian (it_IT) translation

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