Custom AI Chatbot Module for Drupal 9.x, 10.x and 11.x

Latest version supports Open AI, Google Gemini, Anthropic Claude and Mistral.

The AI Chatbot module provides a frontend chatbot block and acts as an AI agent for your website. It interacts with site visitors using your custom content/data. The module supports Open AI, Google Gemini, Anthropic Claude and Mistral. The AI prompt, context can be customized so that the AI agent just talks about your website/company and nothing else. Module supports configurable AI prompt, welcome message, agent name and more.

Features

- Configurable AI prompt and welcome message
- Configurable agent name
- AI works on your custom data context
- The module can use basic HTML formatting in context, which can be provided the custom data field like- 'strong', 'b', 'em', 'a', 'ol', 'ul', 'li', 'br', 'p'.
- The prompt can be configured/instructed to use basic HTML tags.
- Mobile-friendly frontend chat UI (fixed bottom-right)
- Open/Close chat window with smooth scroll
- Session persistence and reset functionality
- Caching of response for improved performance

Configuration

- Configure the AI API Settings (/admin/config/aichatbot/api)
- Configure the AI Prompt, Custom data (/admin/config/services/aichatbot-prompt)

Requirements

- AI Service (Open AI / Gemini / Claude / Mistral) API Key.

Installation

- Install as you would normally install a contributed Drupal module.

Frontend Block

The module provides a block titled "AI Chatbot".

- Go to: /admin/structure/block
- Place the block in a region (e.g., Header)
- The Chatbot block appears fixed in the bottom-right of the screen

Technical Notes

- Uses session to store chat history with 30-minute timeout
- Cache stores answers for 30 minutes using hashed question+prompt
- Module use your custom data context before calling AI service

Curl Commands to test your API Key and Model integration

OpenAI

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCOUNT_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "What is Drupal?"
      }
    ],
    "max_tokens": 512,
  }'

Anthropic Claude

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: YOUR_ACCOUNT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Just Say Hi!"
      }
    ]
  }'

Gemini

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H 'Content-Type: application/json' \
  -H 'X-goog-api-key: YOUR_ACCOUNT_API_KEY' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Just Say Hi!"
          }
        ]
      }
    ]
  }'

Mistral

curl --location "https://api.mistral.ai/v1/chat/completions" \
     --header 'Content-Type: application/json' \
     --header 'Accept: application/json' \
     --header "Authorization: Bearer YOUR_ACCOUNT_API_KEY" \
     --data '{
    "model": "magistral-medium-latest",
    "messages": [{"role": "user", "content": "Just Say Hi!"}]
  }'

Maintainers
Current maintainer:
Gaurav Kumar - https://www.drupal.org/u/gauravkumar