{"id":353155,"date":"2026-08-19T14:44:18","date_gmt":"2026-08-19T14:44:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/petrichorcraft-chatbot\/"},"modified":"2026-08-19T14:44:01","modified_gmt":"2026-08-19T14:44:01","slug":"pcc-ai-live-chat","status":"publish","type":"plugin","link":"https:\/\/zul.wordpress.org\/plugins\/pcc-ai-live-chat\/","author":15753799,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.6.4","stable_tag":"1.6.4","tested":"7.0.4","requires":"6.0","requires_php":"8.0","requires_plugins":null,"header_name":"PetrichorCraft Chatbot","header_author":"PetrichorCraft","header_description":"Hybrid FAQ + AI chatbot with a site-wide floating widget. Guided question chips and free-text answers grounded in your FAQ knowledge.","assets_banners_color":"","last_updated":"2026-08-19 14:44:01","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/petrichorcraft.com\/","header_plugin_uri":"","header_author_uri":"https:\/\/petrichorcraft.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":43,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.6.4":{"tag":"1.6.4","author":"csoftech","date":"2026-08-19 14:44:01"}},"upgrade_notice":{"1.6.3":"<p>Uses the WordPress AI Client when available. Existing settings, FAQs, and chat tables are migrated automatically.<\/p>","1.6.0":"<p>Adds optional live chat, agents, and inbox. Review Behavior \u2192 Live chat after updating.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.6.4"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Floating help widget with FAQ topics","2":"Chatbot settings \u2014 Behavior","3":"Live inbox for agents"}},"plugin_section":[],"plugin_tags":[2353,2364,2369,1643,2379],"plugin_category":[],"plugin_contributors":[274364],"plugin_business_model":[],"class_list":["post-353155","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chatbot","plugin_tags-customer-support","plugin_tags-faq","plugin_tags-live-chat","plugin_contributors-csoftech","plugin_committers-csoftech"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/pcc-ai-live-chat.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>PetrichorCraft Chatbot adds a floating help widget so visitors can browse FAQ topics, ask free-text questions (optional AI), or talk to a human agent.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Site-wide floating chat button with configurable colors, size, and mobile layout<\/li>\n<li>FAQ categories and question chips (works with no AI key)<\/li>\n<li>Optional free-text answers grounded in your FAQ content<\/li>\n<li>On WordPress 7.0+, uses the core WordPress AI Client (Settings \u2192 Connectors) when a connector is available<\/li>\n<li>Optional provider API keys (OpenAI, Anthropic Claude, or Google Gemini) as a fallback, including on WordPress 6.x<\/li>\n<li>Feedback buttons on answers (satisfied \/ not satisfied \/ unsure)<\/li>\n<li>Optional live chat: agents, live inbox, reopenable threads, offline leave-a-message emails<\/li>\n<li>Shortcode <code>[pccalc_live_agent]<\/code> for \u201cAgent is live\u201d \/ email fallback inside FAQ answers<\/li>\n<li>Encrypted API keys at rest, public AJAX rate limiting<\/li>\n<\/ul>\n\n<h4>External services<\/h4>\n\n<p>Free-text AI is <strong>optional<\/strong>. FAQ chip answers never call an AI service.<\/p>\n\n<p>On WordPress 7.0 or later, if the site has an AI connector, free-text questions are sent through the WordPress AI Client. The site owner chooses the provider under <strong>Settings \u2192 Connectors<\/strong>. That request is handled by WordPress core and the connector the site owner configured.<\/p>\n\n<p>If no core connector is available (WordPress 6.x, or no connector set up), and you add a provider API key and enable free-text questions, the plugin sends the question plus selected FAQ context to the provider you configure:<\/p>\n\n<ul>\n<li>OpenAI \u2014 <a href=\"https:\/\/openai.com\/policies\/terms-of-use\/\">Terms<\/a> \u00b7 <a href=\"https:\/\/openai.com\/policies\/privacy-policy\/\">Privacy<\/a> \u00b7 API: <code>https:\/\/api.openai.com\/<\/code><\/li>\n<li>Anthropic (Claude) \u2014 <a href=\"https:\/\/www.anthropic.com\/legal\/consumer-terms\">Terms<\/a> \u00b7 <a href=\"https:\/\/www.anthropic.com\/legal\/privacy\">Privacy<\/a> \u00b7 API: <code>https:\/\/api.anthropic.com\/<\/code><\/li>\n<li>Google Gemini \u2014 <a href=\"https:\/\/ai.google.dev\/gemini-api\/terms\">Terms<\/a> \u00b7 <a href=\"https:\/\/policies.google.com\/privacy\">Privacy<\/a> \u00b7 API: <code>https:\/\/generativelanguage.googleapis.com\/<\/code><\/li>\n<\/ul>\n\n<p>Live chat stays on your WordPress site (AJAX); notification emails use <code>wp_mail<\/code>.<\/p>\n\n<h4>Privacy<\/h4>\n\n<p>Depending on settings, the plugin may store visitor questions, answers, feedback, and (if enabled) name \/ email \/ phone for live chat. Ask logs may store a hashed IP for rate limiting. Review <strong>Settings \u2192 Privacy<\/strong> in WordPress and your own privacy policy. Suggested policy text is registered with WordPress when the plugin is active.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>pcc-ai-live-chat<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install the zip via <strong>Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>.<\/li>\n<li>Activate <strong>PetrichorCraft Chatbot<\/strong> under <strong>Plugins<\/strong>.<\/li>\n<li>Open <strong>Chatbot<\/strong> in the admin menu and configure Behavior, Appearance, and (optionally) AI Provider.<\/li>\n<li>Edit or replace the sample FAQs under <strong>Chatbot \u2192 FAQs<\/strong> (or Import).<\/li>\n<li>Optional (WordPress 7.0+): add an AI connector under <strong>Settings \u2192 Connectors<\/strong>.<\/li>\n<li>Optional: add an OpenAI, Claude, or Gemini API key for free-text answers when no core connector is available.<\/li>\n<li>Optional: enable Live chat, add agents under <strong>Chatbot \u2192 Agents<\/strong>, and monitor <strong>Chatbot \u2192 Live inbox<\/strong>.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20free-text%20ai%20work%20without%20an%20api%20key%3F\"><h3>Does free-text AI work without an API key?<\/h3><\/dt>\n<dd><p>FAQ chips work without any AI setup. Free-text needs \u201cAllow free-text\u201d enabled, plus either a WordPress 7.0 AI connector (Settings \u2192 Connectors) or a provider API key.<\/p><\/dd>\n<dt id=\"is%20live%20chat%20required%3F\"><h3>Is live chat required?<\/h3><\/dt>\n<dd><p>No. Leave Live chat disabled if you only want FAQ \/ AI.<\/p><\/dd>\n<dt id=\"where%20do%20visitor%20messages%20go%20when%20agents%20are%20offline%3F\"><h3>Where do visitor messages go when agents are offline?<\/h3><\/dt>\n<dd><p>Visitors can leave a message in the widget. The plugin emails configured notify addresses \/ support email \/ linked agent WordPress users.<\/p><\/dd>\n<dt id=\"will%20uninstall%20delete%20my%20faqs%3F\"><h3>Will uninstall delete my FAQs?<\/h3><\/dt>\n<dd><p>Settings are removed on uninstall. FAQ posts, chat tables, and logs are deleted only if you enable <strong>Delete chatbot content on uninstall<\/strong> in Behavior settings.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.6.4<\/h4>\n\n<ul>\n<li>Prefix uninstall locals; silence one-time meta_key migration warning<\/li>\n<\/ul>\n\n<h4>1.6.3<\/h4>\n\n<ul>\n<li>Use unique <code>pccalc<\/code> prefixes for options, AJAX, CPT, scripts, and shortcodes<\/li>\n<li>Use the WordPress AI Client on WP 7.0+ when a site connector is available<\/li>\n<li>Add WordPress.org username to Contributors<\/li>\n<\/ul>\n\n<h4>1.6.2<\/h4>\n\n<ul>\n<li>Silence Plugin Check DB warnings with $wpdb-&gt;prefix table SQL and phpcs ignores<\/li>\n<\/ul>\n\n<h4>1.6.1<\/h4>\n\n<ul>\n<li>Align text domain and zip slug with WordPress.org plugin slug <code>pcc-ai-live-chat<\/code><\/li>\n<\/ul>\n\n<h4>1.6.0<\/h4>\n\n<ul>\n<li>Live chat: agents, live inbox, reopenable sessions, offline messaging and email alerts<\/li>\n<li>Shortcode <code>[pccalc_live_agent]<\/code> for agent-online \/ email fallback in FAQ answers<\/li>\n<li>Mobile panel size settings; visitor resume via localStorage<\/li>\n<li>Admin doorbell on new \/ reopened chats; chat close control top-right<\/li>\n<li>WordPress.org packaging: readme, license, privacy text, external admin JS assets<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release: floating widget, FAQ CPT, hybrid AI chat<\/li>\n<\/ul>","raw_excerpt":"Hybrid FAQ + optional AI answers and live agent chat in a floating site widget.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/353155","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=353155"}],"author":[{"embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/csoftech"}],"wp:attachment":[{"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=353155"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=353155"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=353155"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=353155"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=353155"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=353155"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}