WordPress AI Chatbot
Add a Gemini AI-powered chat widget to any WordPress site. Answers visitor questions 24/7 — fully customizable and free to run.
by Vaibhav Kumar · github.com/vaibhavkumar-wpdev/wp-ai-chatbot · 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/vaibhavkumar-wpdev/wp-ai-chatbot/archive/refs/heads/main.zipA lightweight AI-powered chat widget for any WordPress site. Powered by Google Gemini — answers visitor questions 24/7, fully customizable, free to run.
Features
- Floating chat bubble — bottom right or left corner
- Real conversation with full message history context
- Customizable: bot name, avatar, welcome message, primary color, position
- Configurable system prompt — tell the bot about your business
- Rate limiting — 30 messages per IP per hour (prevents abuse)
- Typing indicator with animated dots
- Mobile responsive
- Gemini model switching with one click
- Live daily usage dashboard
- API key stored server-side — never exposed to visitors
- Nonce-based AJAX security
Screenshots
Frontend Chat Widget
Floating chat button in the bottom right corner. Clean chat window with bot and user messages.
Settings Page
Full customization: bot name, color, welcome message, system prompt, model selection.
Installation
- Download the plugin ZIP
- WordPress Admin → Plugins → Add New → Upload Plugin
- Activate
- Go to Settings → AI Chatbot
- Paste your Gemini API key
- Customize bot name, welcome message, and system prompt
- Save — widget appears on all frontend pages immediately
Getting a Free API Key
- Go to aistudio.google.com
- Sign in with Google
- Click "Create API key"
- Paste into plugin settings
Free tier: 1,500 messages/day on Gemini 2.0 Flash Lite. No credit card.
Customization
| Setting | Description |
|---|---|
| Bot Name | Displayed in chat header |
| Avatar | Emoji or 1-2 letters in button and messages |
| Welcome Message | First message shown when chat opens |
| Bot Instructions | System prompt — tell the bot about your business |
| Primary Color | Header and send button color |
| Position | Bottom right or bottom left |
Example System Prompt
You are a helpful assistant for Vaibhav's WordPress Development Agency.
We specialize in WooCommerce stores, custom plugins, and AI integrations.
Answer questions about our services clearly and professionally.
For pricing or project quotes, ask them to describe their project and
tell them to contact us via the contact form.
Requirements
- WordPress 5.8+
- PHP 7.4+
- Google Gemini API key (free)
Security
- API key stored server-side in wp_options — never sent to frontend
- All AJAX requests verified with WordPress nonces
- Rate limiting: 30 messages per IP per hour
- All user input sanitized before API calls
- Conversation history limited to last 10 messages
This Plugin as a Service
This demonstrates the kind of AI chatbot integrations I build for clients:
- Custom AI chatbots for WordPress and WooCommerce
- Chatbots trained on product catalogs and FAQs
- Lead qualification chatbots
- Customer support automation
- OpenAI, Claude, or Gemini API integration
Need a custom AI chatbot for your WordPress site? Contact me on Upwork
Author
Vaibhav Kumar — WordPress & AI Integration Developer Top Rated | 97% JSS | 3,100+ Hours
- Upwork: https://www.upwork.com/freelancers/vaibhavkumar
- GitHub: https://github.com/vaibhavkumar-WPDEV
Related Plugins
License
GPL v2 or later
Changelog
1.0.0
- Initial release
- Gemini API with full conversation history
- Customizable bot name, avatar, color, position
- System prompt configuration
- Rate limiting (30 msg/hour/IP)
- Typing indicator
- Mobile responsive
- Usage dashboard