ChatMaxima AI Chatbot
AI-powered chatbot WordPress plugin with customizable themes and social media integration
by ChatMaxima · github.com/chatmaxima-com/chatmaxima-ai-chatbot-wordpress · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/chatmaxima-com/chatmaxima-ai-chatbot-wordpress/archive/refs/heads/main.zipChatMaxima AI Chatbot - WordPress Plugin
AI-powered chatbot integration for WordPress with customizable themes, social media support, and knowledge source management.
Features
- AI-Powered Conversations - Advanced chatbot technology for natural interactions
- Customizable Theme Colors - Match your brand with custom color schemes
- Social Media Integration - Connect Facebook, Instagram, WhatsApp, Telegram, and more
- Knowledge Source Management - Create and manage knowledge sources via API
- Content Sync - Sync WordPress posts and pages to ChatMaxima knowledge sources
- Bulk Sync - Sync all published content with progress tracking
- Auto-Sync - Automatically sync new posts when published
- Easy Configuration - Simple admin interface for quick setup
- Responsive Design - Works perfectly on desktop and mobile devices
Requirements
- WordPress 5.0 or higher
- PHP 7.4 or higher
- A ChatMaxima account
Installation
From WordPress Admin (Recommended)
- Download the latest release zip file
- Go to Plugins > Add New > Upload Plugin
- Choose the zip file and click "Install Now"
- Activate the plugin
Manual Installation
- Download and extract the plugin files
- Upload the
chatmaxima-ai-chatbotfolder to/wp-content/plugins/ - Activate the plugin through the WordPress admin
Configuration
API Connection
- Go to Settings > ChatMaxima Chatbot
- Enter your ChatMaxima email and password
- Click Connect to authenticate
Knowledge Source
- After connecting, select an existing knowledge source or create a new one
- Choose the LLM type (OpenAI, Claude, or Gemini)
Content Sync
- Select which post types to sync (Posts, Pages, etc.)
- Enable Auto Sync to automatically sync new posts when published
- Click Sync All Content to bulk sync existing content
Chatbot Widget
- Enter your ChatMaxima Token ID (required for the widget to appear)
- Select your preferred theme color
- Add your social media handles and contact information
- Save settings
Plugin Structure
chatmaxima-ai-chatbot/
├── chatmaxima-ai-chatbot.php # Main plugin file
├── readme.txt # WordPress.org readme
├── uninstall.php # Cleanup on uninstall
├── includes/
│ ├── class-api-client.php # ChatMaxima API v2 client
│ ├── class-admin-settings.php # Admin settings page
│ └── class-content-sync.php # Content sync functionality
├── assets/
│ ├── admin.js # Admin JavaScript
│ ├── admin.css # Admin styles
│ └── README.md # Asset guidelines
└── README.md # This file
API Endpoints Used
The plugin uses ChatMaxima API v2:
| Endpoint | Method | Description |
|---|---|---|
/api/v2/auth/login/ |
POST | User authentication |
/api/v2/auth/refresh/ |
POST | Token refresh |
/api/v2/auth/me/ |
GET | Get current user |
/api/v2/knowledge-sources/ |
POST | List/Create knowledge sources |
/api/v2/knowledge-sources/{alias}/ |
GET | Get single knowledge source |
/api/v2/knowledge-sources/{alias}/training/ |
POST | Add training URLs |
Hooks and Filters
Actions
publish_post- Triggered when a post is published (auto-sync)publish_page- Triggered when a page is published (auto-sync)wp_insert_post- Triggered for custom post types (auto-sync)
Bulk Actions
- Sync to ChatMaxima - Available in Posts and Pages list
Meta Box
- ChatMaxima Sync - Shows sync status on post edit screen
- Option to exclude individual posts from sync
Development
Building the Plugin
# Create distribution zip
zip -r chatmaxima-ai-chatbot.zip chatmaxima-ai-chatbot -x "*.git*"
Testing
- Install the plugin on a WordPress development site
- Configure API credentials
- Test sync functionality with sample posts
Changelog
2.0.0
- Added API v2 authentication (JWT)
- Added knowledge source management
- Added content sync feature
- Added bulk sync with progress tracking
- Added auto-sync on publish
- Added post meta box for sync control
- Added bulk action for syncing multiple posts
- Improved admin UI with card-based layout
1.0.0
- Initial release
- AI chatbot widget integration
- Theme color customization
- Social media platform support
- Token-based authentication
Privacy
This plugin connects to ChatMaxima services to provide chatbot and knowledge source functionality. Please review ChatMaxima's privacy policy for information about data handling.
Support
- Documentation: ChatMaxima Docs
- Support Email: support@chatmaxima.com
- Issues: GitHub Issues
License
This plugin is licensed under the GPL v2 or later.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
About ChatMaxima
ChatMaxima is a leading AI-powered customer engagement platform. Learn more at chatmaxima.com.
Made with care by the ChatMaxima Team