Bitrix24 AI-Powered RAG Chatbot for Open Line Channels

Overview Transform your Bitrix24 Open Line channels with an intelligent chatbot that leverages Retrieval-Augmented Generation (RAG) technology to provide accurate, document-based responses to customer inquiries in real-time. Use Case This workflow is designed for organizations that want to enhance their customer support capabilities in Bitrix24 by providing automated, knowledge-based responses to customer inquiries. It's particularly useful for: - Customer service teams handling repetitive questions - Support departments with extensive documentation - Sales teams needing quick access to product information - Organizations looking to provide 24/7 customer support What This Workflow Does Smart Document Processing - Automatically processes uploaded PDF documents - Splits documents into manageable chunks - Generates vector embeddings for semantic understanding - Indexes content for efficient retrieval AI-Powered Responses - Utilizes Google Gemini AI to generate natural language responses - Constructs answers based on relevant document content - Maintains conversation context for coherent interactions - Provides fallback responses when information is not available Vector Database Integration - Stores document embeddings in Qdrant vector database - Enables semantic search beyond simple keyword matching - Retrieves the most relevant information for each query - Maintains a persistent knowledge base that grows over time Webhook Handler - Processes incoming messages from Bitrix24 Open Line channels - Handles authentication and security validation - Routes different types of events to appropriate handlers - Manages session and conversation state Event Routing - Intelligently routes different event types: - ONIMBOTMESSAGEADD: Processes new user messages - ONIMBOTJOINCHAT: Handles bot joining a conversation - ONAPPINSTALL: Manages application installation - ONIMBOTDELETE: Handles bot deletion Document Management - Organizes processed documents in designated folders - Tracks document processing status - Moves indexed documents to appropriate locations - Maintains document metadata for reference Interactive Menu - Provides menu-based options for common user requests - Customizable menu items and responses - Easy navigation for users seeking specific information - Fallback to operator option when needed Technical Architecture Components 1. Webhook Handler: Receives and validates incoming requests from Bitrix24 2. Credential Manager: Securely manages authentication tokens and API keys 3. Event Router: Directs events to appropriate processing functions 4. Document Processor: Handles document loading, chunking, and embedding 5. Vector Store: Qdrant database for storing and retrieving document embeddings 6. Retrieval System: Searches for relevant document chunks based on user queries 7. LLM Integration: Google Gemini model for generating natural language responses 8. Response Manager: Formats and sends responses back to Bitrix24 Integration Points - Bitrix24 API: For bot registration, message handling, and user interaction - Ollama API: For generating document embeddings - Qdrant API: For vector storage and retrieval - Google Gemini API: For AI-powered response generation Setup Instructions Prerequisites - Active Bitrix24 account with Open Line channels enabled - Access to n8n workflow system - Ollama API credentials - Qdrant vector database access - Google Gemini API key Configuration Steps 1. Initial Setup - Import the workflow into your n8n instance - Configure credentials for all services - Set up webhook endpoints 2. Bitrix24 Configuration - Create a new Bitrix24 application - Configure webhook URLs - Set appropriate permissions - Install the application to your Bitrix24 account 3. Document Storage - Create a designated folder in Bitrix24 for knowledge base documents - Configure folder paths in the workflow settings - Upload initial documents to be processed 4. Bot Configuration - Customize bot name, avatar, and description - Configure welc