Shuriken AI Chatbot - Powered by Google Gemini

Contributors: Shuriken Dev Tags: chatbot, ai, gemini, google, support, lead generation, artificial intelligence Requires at least: 5.8 Tested up to: 6.4 Requires PHP: 7.4 License: GPLv2 or later

Transform your WordPress site with a smart, AI-powered chatbot built on the Google Gemini API. Capture leads, engage visitors 24/7, and answer queries automatically based on your custom training data.

---

🚀 Features

🤖 AI-Powered Conversations

Uses Google's advanced Gemini API to understand natural language and provide accurate, context-aware responses to your visitors.

📝 Lead Generation First

Automatically captures visitor details (Name, Email, Phone Number) before starting the chat. Turn every conversation into a potential business opportunity.

🧠 Smart Training System

"Train" your bot easily from the dashboard. Simply paste your company details, services, pricing, and FAQs into the Organization Information field, and the AI will answer questions based strictly on that data.

🎨 Fully Customizable

• Appearance: Change the theme color to match your brand.
• Avatars: Upload custom icons for the Bot and User.
• Position: Place the chat widget on the Bottom-Right or Bottom-Left.
• Welcome Message: Set a custom greeting to engage users.

⚡ Quick Actions

Define up to 5 Quick-Reply Buttons (e.g., "Pricing", "Support", "Services") to help users find answers faster without typing.

📊 Admin Dashboard & Analytics

• Dashboard: View quick stats on total entries and bot status.
• Entries Management: View a list of all captured leads.
• Chat History: Read full conversation transcripts for every lead to understand customer needs better.
• User Location: Automatically detects and logs the user's country based on IP.

---

📋 Requirements

1. WordPress: Version 5.8 or higher.
2. PHP: Version 7.4 or higher.
3. Google Gemini API Key: You need a free or paid API key from Google AI Studio.

---

🛠️ Installation

1. Download the plugin zip file shuriken-ai-chatbot.zip.
2. Log in to your WordPress Admin Dashboard.
3. Go to Plugins > Add New.
4. Click Upload Plugin and select the zip file.
5. Click Install Now and then Activate.

Once activated, you will see a new menu item "Shuriken AI Chatbot" in your sidebar.

---

⚙️ Setup & Configuration Tutorial

Follow these steps to get your bot live in under 5 minutes.

Step 1: Get Your API Key

1. Go to Google AI Studio.
2. Create a new project (or select an existing one).
3. Click on "Get API key".
4. Copy the key string.

Step 2: Configure General Settings

1. Navigate to Shuriken AI Chatbot > Settings.
2. Paste your key into the Gemini API Key field.
3. Ensure Chatbot On/Off is checked.
4. Appearance:
   • Choose a Theme Color (e.g., your brand's primary color).
   • Upload a Bot Image (your logo) and User Image (default avatar).
   • Select the Position (Bottom Right is standard).
5. Click Save Changes.

Step 3: Train Your Bot (Crucial!)

This is where the magic happens. The bot needs to know who it is.

1. Navigate to Shuriken AI Chatbot > Train Bot.
2. Organization Information: This is the "brain" of your bot. Enter details like:
   • Company Name & Description
   • Services/Products offered
   • Contact details & Hours
   • Return policies or FAQ answers
   • Example: "We are ShurikenIT, a web development agency. We offer WordPress services starting at $500. Our support email is..."
3. Welcome Message: Set a friendly opening line (e.g., "Hi! How can I help you grow your business today?").
4. Fallback Response: What the bot says if it's confused (e.g., "I'm sorry, I didn't quite get that. Could you rephrase?").
5. Quick-Reply Buttons: Add text like "Pricing" or "Contact Us" to guide users.
6. Click Save Changes.

Step 4: Test It

Visit your website's homepage. You should see the chatbot icon in the corner.

1. Click the icon to open.
2. Fill in the Lead Form (Name/Email/Phone).
3. Start chatting! Ask it a question based on the info you entered in Step 3.

---

🕵️ Managing Leads & Conversations

Every time a user fills out the form and chats, data is saved.

1. Go to Shuriken AI Chatbot > Entries.
2. You will see a list of all leads.
3. Click on "View" (or the lead's name) to see details.
4. On the details page, you can see:
   • User Contact Info (Name, Email, Phone).
   • User Location (Country).
   • Chat History: The full transcript of their conversation with the AI.

---

❓ FAQ / Troubleshooting

Q: The chatbot isn't showing up on my site.

• Check Shuriken AI Chatbot > Settings and ensure "Chatbot On/Off" is checked.
• Clear your website cache (if using caching plugins).
• Check if the Theme Color is set (it must have a value).

Q: The bot replies "I'm sorry, I didn't catch that" to everything.

• This usually means the API connection failed.
• Verify your Gemini API Key is correct.
• Check if your Google Cloud project has billing enabled (if using paid tiers) or if you've exceeded free limits.

Q: Can I disable the Lead Capture form?

• Currently, the lead capture form is designed to maximize value by gathering contact info before allowing chat access.

Q: Does it work on mobile?

• Yes, the chatbot is fully responsive and adjusts its position and size for mobile devices.

---

📝 Developer Notes

• CSS Customization: The plugin adds variables to the root (e.g., --chatbot-theme-color). You can override styles in your theme's CSS if needed.
• Data Storage: Entries are stored as a Custom Post Type (wph_entries) with custom meta fields.

---

Enjoy using Shuriken AI Chatbot! If you like this plugin, please consider leaving a rating.