https://github.com/alihassanml/lead-qualification-agent
An AI-powered lead qualification and appointment booking agent built with a frontend interface. It guides leads through qualification steps using natural human-like conversation and books meetings directly on GoHighLevel (GHL).
https://github.com/alihassanml/lead-qualification-agent
booking lead n8n qualification
Last synced: about 2 months ago
JSON representation
An AI-powered lead qualification and appointment booking agent built with a frontend interface. It guides leads through qualification steps using natural human-like conversation and books meetings directly on GoHighLevel (GHL).
- Host: GitHub
- URL: https://github.com/alihassanml/lead-qualification-agent
- Owner: alihassanml
- License: mit
- Created: 2025-07-12T23:23:04.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-12T23:28:57.000Z (3 months ago)
- Last Synced: 2025-07-13T01:16:29.295Z (3 months ago)
- Topics: booking, lead, n8n, qualification
- Homepage:
- Size: 338 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🤖 Lead Qualification Agent
An AI-powered lead qualification and appointment booking agent built with a frontend interface. It guides leads through qualification steps using natural human-like conversation and books meetings directly on **GoHighLevel (GHL)**.
---
## 🚀 Features
- ✨ Natural LLM-based lead interaction
- 🎯 Qualification logic via FSM (Finite State Machine)
- 🧠 Memory-enabled conversation flow
- 📆 Meeting booking integration with GoHighLevel
- 🧩 Frontend for user interaction
- 📊 Lead intent tagging and dynamic flow adaptation
---
## 🖼️ Demo Screenshot
> Add your actual screenshot or screen recording (replace link)
---
## 🛠️ Tech Stack
| Layer | Tech Used |
|-------------|--------------------------------|
| Frontend | React / Next.js |
| Backend | FastAPI / Flask / Node.js |
| AI Core | OpenAI GPT-4 / LangChain |
| Flow Engine | FSM with Intent Tagging |
| Booking | GoHighLevel API |
| Hosting | Vercel / Render / Railway |
---
## ⚙️ Setup Instructions
### 1. Clone the repo
```bash
git clone https://github.com/alihassanml/Lead-Qualification-Agent.git
cd Lead-Qualification-Agent
````
### 2. Set up environment variables
Create a `.env` file:
```env
OPENAI_API_KEY=your_openai_key
GHL_API_KEY=your_ghl_key
GHL_LOCATION_ID=your_location_id
```
### 3. Install dependencies
For backend:
```bash
cd backend
pip install -r requirements.txt
```
For frontend:
```bash
cd frontend
npm install
```
### 4. Run the app
```bash
# Run backend
cd backend
uvicorn main:app --reload
# Run frontend
cd frontend
npm run dev
```
---
## 📅 Booking Integration (GHL)
Meeting booking is handled by sending lead data to GoHighLevel using the GHL API. Make sure you have:
* Created a calendar inside GHL
* Set the correct `GHL_LOCATION_ID` and `GHL_API_KEY`
* Confirmed availability is configured correctly
---
## 📁 Folder Structure
```
Lead-Qualification-Agent/
│
├── backend/ # API + AI logic
│ └── main.py
├── frontend/ # React UI
│ └── components/
│
├── utils/ # FSM, memory, flow logic
├── .env.example
└── README.md
```
---
## 📬 Contact
Built with 💻 by [Ali Hassan](https://github.com/alihassanml)
For issues or enhancements, please open a pull request or issue.
---
## 📜 License
MIT License