PetrichorCraft Chatbot

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.

Features

• Site-wide floating chat button with configurable colors, size, and mobile layout
• FAQ categories and question chips (works with no AI key)
• Optional free-text answers grounded in your FAQ content
• On WordPress 7.0+, uses the core WordPress AI Client (Settings → Connectors) when a connector is available
• Optional provider API keys (OpenAI, Anthropic Claude, or Google Gemini) as a fallback, including on WordPress 6.x
• Feedback buttons on answers (satisfied / not satisfied / unsure)
• Optional live chat: agents, live inbox, reopenable threads, offline leave-a-message emails
• Shortcode [pccalc_live_agent] for “Agent is live” / email fallback inside FAQ answers
• Encrypted API keys at rest, public AJAX rate limiting

External services

Free-text AI is optional. FAQ chip answers never call an AI service.

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 Settings → Connectors. That request is handled by WordPress core and the connector the site owner configured.

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:

• OpenAI — Terms · Privacy · API: https://api.openai.com/
• Anthropic (Claude) — Terms · Privacy · API: https://api.anthropic.com/
• Google Gemini — Terms · Privacy · API: https://generativelanguage.googleapis.com/

Live chat stays on your WordPress site (AJAX); notification emails use wp_mail.

Privacy

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 Settings → Privacy in WordPress and your own privacy policy. Suggested policy text is registered with WordPress when the plugin is active.