WP Manifestindependent plugin directory
manifest / ai / wp-ai-chatbot

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

★ 0stars
0forks

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.zip

A 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

  1. Download the plugin ZIP
  2. WordPress Admin → Plugins → Add New → Upload Plugin
  3. Activate
  4. Go to Settings → AI Chatbot
  5. Paste your Gemini API key
  6. Customize bot name, welcome message, and system prompt
  7. Save — widget appears on all frontend pages immediately

Getting a Free API Key

  1. Go to aistudio.google.com
  2. Sign in with Google
  3. Click "Create API key"
  4. 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

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