{"id":361998,"date":"2026-09-05T01:43:18","date_gmt":"2026-09-05T01:43:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ai-connector-chatbot\/"},"modified":"2026-09-05T01:42:47","modified_gmt":"2026-09-05T01:42:47","slug":"guzmandrade-ai-chatbot","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/guzmandrade-ai-chatbot\/","author":16119404,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.1","stable_tag":"1.1.1","tested":"7.1","requires":"7.0","requires_php":"8.0","requires_plugins":null,"header_name":"Guzmandrade AI Chatbot","header_author":"Mauricio Andrade","header_description":"AI-powered frontend chatbot with a knowledge base, Akismet spam protection, and Cloudflare Turnstile captcha. Leverages the WordPress 7.0 Connectors API and the PHP AI Client SDK \u2014 no custom AI provider code required.","assets_banners_color":"","last_updated":"2026-09-05 01:42:47","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/guzmandrade-dev\/guzmandrade-ai-chatbot","header_author_uri":"https:\/\/profiles.wordpress.org\/h4l9k\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":25,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.1":{"tag":"1.1.1","author":"h4l9k","date":"2026-09-05 01:42:47","revision":3681965}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.1"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[2353,362,5707,2364,599],"plugin_category":[41,44,54],"plugin_contributors":[223705],"plugin_business_model":[],"class_list":["post-361998","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-captcha","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-spam","plugin_category-communication","plugin_category-discussion-and-community","plugin_category-security-and-spam-protection","plugin_contributors-h4l9k","plugin_committers-h4l9k"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/guzmandrade-ai-chatbot.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Guzmandrade AI Chatbot adds an AI-powered chatbot to the frontend of your WordPress site. It leverages the WordPress 7.0 Connectors API and the PHP AI Client SDK \u2014 meaning no custom AI provider integration code is needed. Configure your AI provider under <strong>Settings \u203a Connectors<\/strong> and you're ready.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li><strong>Frontend Chat Widget<\/strong> \u2014 A floating chat button that opens a conversational panel. Place it site-wide or via shortcode.<\/li>\n<li><strong>Knowledge Base<\/strong> \u2014 A custom post type (<code>gaic_article<\/code>) for curated content the chatbot can reference. The article content is where you write the information the chatbot should know. Optionally include standard posts and pages as context.<\/li>\n<li><strong>Spam Protection<\/strong> \u2014 Integrates with Akismet to detect and block spam messages. Falls back to rate-limiting when Akismet is not available.<\/li>\n<li><strong>Captcha Protection<\/strong> \u2014 Integrates with the Simple CAPTCHA with Cloudflare Turnstile plugin to verify human visitors before they can send messages.<\/li>\n<li><strong>Lead Capture<\/strong> \u2014 Uses AI function calling to detect when users share contact information in conversation and automatically saves leads. Delivers via email and\/or webhook (connects to Zapier, Make, n8n, Google Sheets, CRMs). No forms or database tables needed.<\/li>\n<li><strong>Minimal Custom Code<\/strong> \u2014 Uses WordPress Core's Connectors API for AI provider settings, the PHP AI Client SDK for AI calls, Akismet for spam, and Cloudflare Turnstile for captcha \u2014 no duplicate infrastructure.<\/li>\n<\/ul>\n\n<h4>Dependencies<\/h4>\n\n<ul>\n<li><strong>WordPress 7.0+<\/strong> \u2014 Provides the Connectors API for AI provider configuration.<\/li>\n<li><strong>AI Plugin or Core AI<\/strong> \u2014 The PHP AI Client SDK must be available (<code>wp_ai_client_prompt()<\/code>). Install the <a href=\"https:\/\/wordpress.org\/plugins\/ai\/\">AI plugin<\/a> if running WP &lt; 7.0 or need the latest features.<\/li>\n<li><strong>AI Provider Connector<\/strong> \u2014 Install a provider connector plugin (e.g., <a href=\"https:\/\/wordpress.org\/plugins\/ai-provider-for-openai\/\">OpenAI<\/a>, <a href=\"https:\/\/wordpress.org\/plugins\/ai-provider-for-anthropic\/\">Anthropic<\/a>, <a href=\"https:\/\/wordpress.org\/plugins\/ai-provider-for-google\/\">Google<\/a>) and configure the API key under Settings \u203a Connectors.<\/li>\n<li><strong>Akismet<\/strong> (recommended) \u2014 For spam detection on chat messages. Rate-limiting fallback is used when Akismet is not active.<\/li>\n<li><strong>Simple CAPTCHA with Cloudflare Turnstile<\/strong> (optional) \u2014 For captcha verification on chat messages. Install and configure it at Settings \u203a Cloudflare Turnstile, then enable captcha in the chatbot settings.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>guzmandrade-ai-chatbot<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate the plugin through the <strong>Plugins<\/strong> menu in WordPress.<\/li>\n<li>Navigate to <strong>Settings \u203a Guzmandrade AI Chatbot<\/strong> to configure the chatbot.<\/li>\n<li>Enable the chatbot toggle and configure the system instructions.<\/li>\n<li>Ensure an AI provider connector is installed and configured under <strong>Settings \u203a Connectors<\/strong>.<\/li>\n<li>Optionally install and activate Akismet for spam protection.<\/li>\n<li>Optionally install the Simple CAPTCHA with Cloudflare Turnstile plugin for captcha protection, configure it at Settings \u203a Cloudflare Turnstile, then enable captcha in the chatbot settings.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20configure%20my%20ai%20api%20key%3F\"><h3>Where do I configure my AI API key?<\/h3><\/dt>\n<dd><p>Guzmandrade AI Chatbot does not manage API keys. Use the WordPress 7.0 <strong>Settings \u203a Connectors<\/strong> screen to register and configure AI providers (OpenAI, Anthropic, Google, etc.).<\/p><\/dd>\n<dt id=\"can%20i%20use%20the%20chatbot%20on%20specific%20pages%20only%3F\"><h3>Can I use the chatbot on specific pages only?<\/h3><\/dt>\n<dd><p>Yes. Use the <code>[gaic_chatbot]<\/code> shortcode on any page or post. For a site-wide floating widget, enable it in the plugin settings.<\/p><\/dd>\n<dt id=\"can%20i%20show%20a%20gravatar%20instead%20of%20the%20%22ai%22%20badge%3F\"><h3>Can I show a Gravatar instead of the \"AI\" badge?<\/h3><\/dt>\n<dd><p>Yes. Enter an email address in the \"Assistant avatar email\" field in the plugin settings and the assistant's messages will display its Gravatar. If the email has no Gravatar, or the field is empty, your default avatar from Settings \u203a Discussion is used \u2014 the same fallback as comment avatars.<\/p><\/dd>\n<dt id=\"how%20does%20the%20knowledge%20base%20work%3F\"><h3>How does the knowledge base work?<\/h3><\/dt>\n<dd><p>Knowledge Base Articles (the <code>gaic_article<\/code> custom post type) are the primary knowledge source. You create articles with a title and content \u2014 the content is where you write the information\/instructions the chatbot should know. You can also include standard posts and pages. The plugin retrieves relevant content based on keywords in the user's message and includes it as context for the AI.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20akismet%20is%20not%20installed%3F\"><h3>What happens if Akismet is not installed?<\/h3><\/dt>\n<dd><p>Rate-limiting is used as a fallback. Each IP address can send a limited number of messages per hour (configurable in settings). Install Akismet for full spam detection.<\/p><\/dd>\n<dt id=\"how%20does%20captcha%20work%3F\"><h3>How does captcha work?<\/h3><\/dt>\n<dd><p>Captcha uses Cloudflare Turnstile via the \"Simple CAPTCHA with Cloudflare Turnstile\" plugin. After installing and configuring that plugin (Settings \u203a Cloudflare Turnstile), enable captcha in the chatbot settings. A Turnstile challenge widget will appear in the chat panel before users can send their first message.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Renamed the plugin from Just Another Generic Chatbot to Guzmandrade AI Chatbot.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Renamed the plugin from AI Connector Chatbot to Just Another Generic Chatbot.<\/li>\n<li>Added an optional Gravatar for the assistant, configured by email in the plugin settings.<\/li>\n<li>The assistant avatar falls back to your default avatar from Settings \u203a Discussion, the same fallback as comment avatars.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Frontend chatbot widget (floating button + chat panel).<\/li>\n<li>Knowledge base via <code>gaic_article<\/code> custom post type with keyword-based context retrieval.<\/li>\n<li>Akismet spam integration with rate-limiting fallback.<\/li>\n<li>Cloudflare Turnstile captcha integration via Simple CAPTCHA plugin.<\/li>\n<li>Lead capture via AI function calling \u2014 delivers leads via email and\/or webhook (Zapier, Make, n8n, Google Sheets, CRMs).<\/li>\n<li>Admin settings page under Settings \u203a Guzmandrade AI Chatbot.<\/li>\n<li>Leverages WordPress 7.0 Connectors API and PHP AI Client SDK.<\/li>\n<\/ul>","raw_excerpt":"AI-powered frontend chatbot with a knowledge base, Akismet spam protection, and Cloudflare Turnstile captcha.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/361998","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=361998"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/h4l9k"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=361998"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=361998"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=361998"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=361998"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=361998"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=361998"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}