crm-ai-agent

# 🤖 AI-Powered CRM Assistant

[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
![Generated Image January 04, 2026 - 3_37PM](https://github.com/user-attachments/assets/8ead2b5a-806a-4028-bb55-0b9f95732e5a)

An intelligent CRM automation system that uses **Google Gemini AI** and **LangGraph** to analyze leads from amoCRM and provide actionable insights via Telegram. Features a human-in-the-loop architecture to ensure critical business decisions remain under manager control.

## ✨ Key Features

### 🧠 AI-Powered Analysis
- **LangGraph Workflows**: Multi-step reasoning chains for complex lead analysis
- **Batch Processing**: Efficient analysis of multiple leads simultaneously
- **Smart Filtering**: Identifies high-priority leads that need attention
- **Risk Scoring**: Calculates deal loss risk based on activity patterns

### 📱 Telegram Integration
- **Interactive Cards**: Rich action proposals with approve/reject buttons
- **Natural Language Commands**: Understands plain text like "show hot leads"
- **Real-time Notifications**: Instant alerts for critical situations
- **Command Dashboard**: `/today`, `/hot`, `/risk`, `/stats` and more

### ⏰ Automated Reporting
- **Morning Digest** (9:00 AM): Daily overview of tasks and priorities
- **Evening Report** (6:00 PM): End-of-day summary
- **Weekly Overview** (Monday 10:00 AM): Week-in-review statistics

### 🔐 Human-in-the-Loop
- Manager approval required for all CRM actions
- Complete audit trail of all AI decisions
- Configurable risk thresholds and business rules

### 💾 Persistent Storage
- SQLite database for lead scores and action history
- Tracks score trends over time
- Searchable decision logs

---

## 🏗️ Architecture
![Generated Image January 04, 2026 - 3_42PM](https://github.com/user-attachments/assets/