romfast/vfp_roaauto
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
vfp_roaauto/COMUN/utile/chatbot/CLAUDE.md

2.1 KiB
Raw Permalink Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a single-file chatbot application for Romfast technical support. The project consists of a standalone HTML file (chatbot_maria.html) that implements a full-featured chatbot interface using the Flowise embed library.

Architecture

The chatbot integrates with a Flowise API backend hosted at https://mutual-special-koala.ngrok-free.app using chatflow ID d4911620-07fe-41f8-adb4-f2f52d6ec766.

Key architectural components:

  • Flowise Integration: Uses the Flowise embed library from CDN for the main chatbot functionality
  • Direct API Mode: Supports URL parameter-based message handling that bypasses the chat interface and displays responses in a modal overlay
  • Dual Display Modes:
    • Standard chatbot widget with starter prompts
    • Direct API response modal when ?message= URL parameter is present

Key Features

  • Maria ChatBot: Romanian language technical support assistant for Romfast ROA system
  • URL Parameter Support: Can accept initial messages via ?message= URL parameter
  • Conditional UI: Hides starter prompts when a direct message is provided
  • Chat History: Saves conversation history to localStorage when transitioning from API mode to chat mode
  • Responsive Design: Mobile-friendly layout with collapsible menu

Configuration

The chatbot configuration is embedded in the JavaScript module:

  • API Host: https://mutual-special-koala.ngrok-free.app
  • Chatflow ID: d4911620-07fe-41f8-adb4-f2f52d6ec766
  • Romanian language interface with predefined starter prompts about eFactura, SAFT declarations, and auto service workflows

Development Notes

This is a static HTML file with no build process. To modify:

  1. Edit chatbot_maria.html directly
  2. Test by opening in a browser
  3. For URL parameter testing, use format: chatbot_maria.html?message=your%20message%20here

The application handles two distinct user flows based on URL parameters, switching between embedded chatbot widget and full-screen API response modal.