smart_faq_chatbot

Smart FAQ Chatbot

Smart FAQ Chatbot provides an AI-powered conversational assistant that dynamically answers user questions using your site’s internal content. It supports filtering by content type, taxonomy term, and product type.

Features

Smart FAQ Chatbot leverages Google's Gemini API to create a chatbot interface that can:

Answer user-submitted questions using actual content from your site.
Use context from nodes, taxonomy terms, and Commerce product types.
Display AI answers in a chat-style interface.
Automatically logs recent questions and answers for display below the input field.

Supports filtering by:

Node content type (e.g. Articles, Blogs)
Taxonomy term (e.g. Topic, Industry)
Product type (for Commerce sites)

Unique Features:

Context-aware AI: Limits answers to site content only.
FAQ-style expandable recent questions display.
Gemini integration via the Generative Language API.
Site-wide configuration with prompt customization.

Use Cases:

Provide a dynamic, searchable knowledge base for content-heavy sites.
Let site visitors ask questions about portfolio projects, products, or documentation.
Replace static FAQ pages with an interactive AI chatbot.

Post-Installation

Once the module is enabled:

Visit the configuration form:

Navigate to: Admin → Configuration → Smart FAQ Chatbot

Or visit: /admin/config/system/smart-faq-chatbot

To use the Smart FAQ Chatbot, you'll need a valid Gemini API key from Google.

Go to: https://aistudio.google.com/app/apikey
Click on "Create API Key"

Copy the generated key

Paste it into the Gemini API Key field in the chatbot configuration form

Optionally customize:

System Prompt
Max Tokens
Site name
Site Description
Site Features
Site Keywords(used in the AI prompt for better context)

Place the Chatbot Block using the block layout system to any region.

Ensure nodes exist of any content types you plan to use for context.

Users can now:

Select filters, ask questions, view responses and recent popular queries.

Additional Requirements

This module requires:

A valid API key for Google’s Gemini API.
Drupal 10 or 11.
(Optional) Commerce module (if using product type filtering).
At least one content type with meaningful content.

Recommended modules/libraries

While not required,this module can improve your experience:
Token – for dynamic prompt variables in future enhancements.

Similar projects

OpenAI / ChatGPT modules – General AI integrations, often open-ended without filtering by internal site content.
FAQ or Helpdesk modules – Static and manually managed.

Smart FAQ Chatbot is unique in that it strictly grounds AI responses in your existing site content, making it reliable, consistent, and safe for production use.

Supporting this Module

If this module helps your site or clients:

Star the project on Drupal.org!
Submit issues or feature ideas in the issue queue.
Contact the maintainer to sponsor future improvements or enterprise features.
Maintained by the open-source community. Contributions, bug reports, and feature requests are welcome on Drupal.org or GitHub.

Community Documentation

Setup guides and usage examples are available in the README.md file included with the module