How b4ian0-1980/-noahbot works
NoahBot V3 is an omnichannel WhatsApp service-desk bot integrated with GLPI, AI, and an operations dashboard. Its primary workflow receives WhatsApp messages through Evolution and RabbitMQ, processes conversational state and authentication, then handles support actions such as AI triage or ticket operations. Separate branches cover monitoring, administration, and real-time dashboard updates. The README documents the main external integrations; source-index references and excerpts support selected internal links, while unsampled subsystem wiring is not inferred.
Main entry points: main.py Backend API · bot_engine.py Bot Engine · App.tsx Dashboard App · evolution_consumer.py Message Consumer
Components 23
Messaging & Conversation
- Message Consumer
backend/app/consumers/evolution_consumer.py - Bot Engine
backend/app/engine/bot_engine.py - Conversation State
backend/app/services/redis_service.py - Media Processing
backend/app/engine/media
Support Workflows
- Conversation Authentication
backend/app/handlers/auth/auth_processor.py - AI & Triage
backend/app/services/ai_service.py - GLPI Services
backend/app/services/glpi_service.py
External Integrations
- Evolution API
- RabbitMQ
- GLPI
- Ollama
Operations & Administration
- Bot Metadata
backend/app/repositories/bot_metadata_repository.py - Zabbix Consumer
backend/app/consumers/zabbix_consumer.py - Zabbix Poller
backend/app/engine/zabbix_poller.py - GLPI Ticket Poller
backend/app/engine/glpi_ticket_poller.py - Backend API
backend/main.py - WebSocket Manager
backend/app/core/ws_manager.py - Admin Services
backend/app/domains/admin
Web Dashboard
- Dashboard App
frontend/src/App.tsx - Chat Module
frontend/src/components/chat/ChatModule.tsx - Login Page
frontend/src/pages/Login.tsx - Admin Views
frontend/src/components/admin
Other components
- WhatsApp User
Connections 24
- WhatsApp User → Evolution API: sends WhatsApp
README.md - Evolution API → RabbitMQ: queues messages
README.md - RabbitMQ → Message Consumer: delivers messages
README.md - Message Consumer → Bot Engine: processes messages
backend/app/consumers/evolution_consumer.py - Message Consumer → Conversation State: uses state
backend/app/consumers/evolution_consumer.py - Message Consumer → Bot Metadata: uses metadata
backend/app/consumers/evolution_consumer.py - Bot Engine → Conversation Authentication: delegates authentication
backend/app/engine/bot_engine.py - Bot Engine → Conversation State: loads conversation state
backend/app/engine/bot_engine.py - Bot Engine → AI & Triage: uses AI services
backend/app/engine/bot_engine.py - Bot Engine → GLPI Services: uses GLPI services
backend/app/engine/bot_engine.py - Bot Engine → Media Processing: dispatches media
backend/app/engine/bot_engine.py - AI & Triage → Ollama: runs inference
README.md - GLPI Services → GLPI: calls GLPI
README.md - Zabbix Consumer → Backend API: starts in background
backend/main.py - Zabbix Poller → Backend API: starts in background
backend/main.py - GLPI Ticket Poller → Backend API: starts in background
backend/main.py - Backend API → Message Consumer: starts listener
backend/main.py - Backend API → WebSocket Manager: serves WebSocket
backend/main.py - Backend API → Admin Services: mounts admin routes
backend/main.py - Backend API → Dashboard App: serves dashboard API
README.md - Dashboard App → Login Page: renders login
frontend/src/App.tsx - Dashboard App → Chat Module: renders chat
frontend/src/App.tsx - Dashboard App → Admin Views: renders admin views
frontend/src/App.tsx - Dashboard App → WebSocket Manager: receives live updates