Plug ChatBot

Description

Plug ChatBot is an AI-powered chatbot plugin for WordPress. Version 2.0.1 adds xAI Grok alongside the existing OpenAI integration.

The site administrator can configure both providers and select one active chat provider. OpenAI and Grok Knowledge Bases are managed separately so files are sent only to the selected provider.

Current plugin capabilities include:

  • OpenAI and xAI Grok chat integrations
  • Provider-specific conversation state
  • OpenAI Vector Store Knowledge Base management
  • xAI Collection Knowledge Base management
  • File Search and Code Interpreter controls per provider
  • Custom bot identity, tone, and guardrail prompt
  • Visitor capture before chat
  • Optional chat history saved in WordPress
  • Admin email notifications for chat transcripts
  • Optional OpenAI Text-to-Speech responses
  • Responsive chat widget customization
  • Adjustable rate limiting

External services

This plugin connects to external AI services only when the corresponding integration or feature is configured and used.

OpenAI

OpenAI may receive:

  • Visitor chat messages and chatbot instructions
  • Optional visitor contact details included in the conversation context
  • Knowledge Base files uploaded under the OpenAI Knowledge Base tab
  • Optional moderation requests
  • Optional text sent for voice generation

Service information:

  • API documentation: https://platform.openai.com/docs/api-reference
  • Privacy policy: https://openai.com/policies/privacy-policy/
  • Terms of use: https://openai.com/policies/terms-of-use/

xAI

xAI may receive:

  • Visitor chat messages and chatbot instructions when Grok is the active provider
  • Optional visitor contact details included in the conversation context
  • Files uploaded under the Grok Knowledge Base tab
  • Collection management requests when an xAI Management API key is configured

Service information:

  • API documentation: https://docs.x.ai/
  • Privacy policy: https://x.ai/legal/privacy-policy
  • Terms of service: https://x.ai/legal/terms-of-service

If local chat logging is enabled, the plugin may store visitor email addresses, chat transcripts, and IP addresses in the WordPress database. A short-lived browser cookie is used to maintain chatbot state for logged-out visitors.

Features

  • Select OpenAI or Grok as the active chat provider
  • Configure separate API keys and models
  • Use only the five approved Grok model IDs included in the plugin
  • Manage OpenAI Vector Stores and xAI Collections independently
  • Upload, attach, detach, list, and delete Knowledge Base files
  • Enable File Search and Code Interpreter separately for each provider
  • Preserve existing OpenAI settings during the 2.0.1 upgrade
  • Use OpenAI moderation when an OpenAI key is configured
  • Use optional OpenAI Text-to-Speech even when Grok handles chat
  • Store chat logs and send transcript notifications

Installation

  1. Upload the plugin folder to /wp-content/plugins/plug-chatbot/.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. Go to Plug ChatBot > Settings > General & Keys.
  4. Configure OpenAI, Grok, or both integrations.
  5. Select the active chat provider and model.
  6. For full Grok Knowledge Base management, add both an xAI API key and an xAI Management API key.
  7. Open Plug ChatBot > Knowledge Base and manage the provider-specific files.
  8. Configure identity, interface, email, and optional voice settings.

FAQ

Do I need both OpenAI and xAI API keys?

No. Configure the provider you want to use for chat. Both can be saved so the active provider can be changed later.

Which Grok models are available?

The plugin allows only these model IDs:

  • grok-build-0.1
  • grok-4.3
  • grok-4.20-multi-agent-0309
  • grok-4.20-0309-reasoning
  • grok-4.20-0309-non-reasoning

Why is a separate xAI Management API key required?

The standard xAI API key is used for chat and file upload. xAI requires a Management API key for Collection creation and document attachment or removal.

Does Grok use the OpenAI Knowledge Base?

No. OpenAI Vector Stores and xAI Collections are separate. Upload a file under the provider tab that should use it.

Does Grok provide the voice response?

Not in version 2.0.1. The existing voice feature continues to use OpenAI Text-to-Speech and requires a saved OpenAI API key.

Does this plugin send data to external services?

Yes. Messages and configured instructions are sent to the active AI provider. Knowledge Base files are sent to the provider selected on the Knowledge Base page. OpenAI moderation and voice requests are sent only when those optional features are enabled.

Can I store chat logs in WordPress?

Yes. The plugin includes an option to save chat history in the WordPress database.

Reviews

There are no reviews for this plugin.

Contributors & Developers

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

Contributors

Translate “Plug ChatBot” 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.2

  • Fixed a frontend fatal error when conversation starters were not yet saved.
  • Fixed Grok Collection and document listing requests.
  • Fixed the xAI Management API key warning state.
  • Improved OpenAI model discovery and surfaced model-loading errors.

2.0.1

  • Added xAI Grok chat integration.
  • Added separate OpenAI and Grok integration cards.
  • Added strict five-model Grok allowlist.
  • Added provider-specific conversation state and API error handling.
  • Added Grok Collection Knowledge Base management.
  • Added provider tabs to the Knowledge Base page.
  • Added provider-specific File Search and Code Interpreter settings.
  • Preserved OpenAI settings through an automatic upgrade migration.
  • Kept moderation and Text-to-Speech on OpenAI for compatibility.
  • Updated privacy and external-service disclosures.