# 0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai architecture

> Architecture diagram of the GitHub repository 0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai
- Repository: https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai

## Overview

This repository is a single n8n workflow for qualifying real-estate enquiries and automating follow-up. A form submission is checked for duplicates before AI scoring; valid Hot/Warm/Cold results are recorded, routed to team alerts and personalized outreach, with delayed follow-up for Hot and Warm leads. Duplicate and classification failures have separate handling. The workflow JSON was not available as a source excerpt, so the graph reflects documented README relationships only; all workflow components use the exact workflow file path.

Main entry points: [`Real Estate Lead Qualification and Outreach with AI (1).json`](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json) (Duplicate check)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Lead intake"]
  node_form["Form trigger"]
  node_dedupe["Duplicate check"]
  node_duplicate["Duplicate route"]
end

subgraph group_qualification["AI qualification"]
  node_agent["AI agent"]
  node_parser["Output parser"]
  node_normalize["Normalize result"]
  node_validity["Classification check"]
  node_record["Create lead record"]
  node_router["Classification router"]
end

subgraph group_outreach["Outreach"]
  node_hot["Hot outreach"]
  node_warm["Warm outreach"]
  node_cold["Cold outreach"]
  node_wait["48-hour wait"]
  node_followup["Follow-up email"]
  node_status["Update lead status"]
end

subgraph group_recovery["Exceptions"]
  node_ai_error["Agent error handler"]
  node_review["Manual review logger"]
  node_failure_alert["Failure alert"]
end

node_seller(("Seller"))
node_airtable[("Airtable")]
node_groq["Groq / Llama"]
node_slack["Slack"]
node_gmail["Gmail"]

node_seller -->|"submits enquiry"| node_form
node_form -->|"checks email"| node_dedupe
node_dedupe -->|"searches records"| node_airtable
node_dedupe -->|"routes duplicate"| node_duplicate
node_duplicate -->|"alerts team"| node_slack
node_dedupe -->|"passes new lead"| node_agent
node_agent -->|"requests scoring"| node_groq
node_agent -->|"uses structured output"| node_parser
node_agent -->|"routes agent errors"| node_ai_error
node_parser -->|"returns result"| node_normalize
node_normalize -->|"checks classification"| node_validity
node_validity -->|"routes invalid result"| node_review
node_validity -->|"routes valid result"| node_record
node_record -->|"creates lead"| node_airtable
node_record -->|"passes classification"| node_router
node_router -->|"routes Hot"| node_hot
node_router -->|"routes Warm"| node_warm
node_router -->|"routes Cold"| node_cold
node_hot -->|"sends urgent alert"| node_slack
node_warm -->|"sends team alert"| node_slack
node_cold -->|"sends nurture alert"| node_slack
node_hot -->|"sends outreach"| node_gmail
node_warm -->|"sends outreach"| node_gmail
node_cold -->|"sends outreach"| node_gmail
node_hot -->|"starts follow-up delay"| node_wait
node_warm -->|"starts follow-up delay"| node_wait
node_wait -->|"continues after 48 hours"| node_followup
node_followup -->|"sends follow-up"| node_gmail
node_followup -->|"updates status"| node_status
node_status -->|"updates lead"| node_airtable
node_ai_error -->|"logs error"| node_review
node_ai_error -->|"notifies team"| node_failure_alert
node_review -->|"logs for review"| node_airtable
node_review -->|"notifies team"| node_failure_alert
node_failure_alert -->|"sends alert"| node_slack

click node_form "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_dedupe "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_duplicate "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_agent "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_parser "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_normalize "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_validity "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_record "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_router "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_hot "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_warm "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_cold "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_wait "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_followup "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_status "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_ai_error "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_review "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"
click node_failure_alert "https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_form,node_dedupe,node_duplicate toneBlue
class node_agent,node_parser,node_normalize,node_validity,node_record,node_router,node_airtable toneAmber
class node_hot,node_warm,node_cold,node_wait,node_followup,node_status toneMint
class node_ai_error,node_review,node_failure_alert toneRose
class node_seller,node_groq,node_slack,node_gmail toneIndigo
```

## Components

### Lead intake

- [Form trigger](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Duplicate check](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Duplicate route](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`

### AI qualification

- [AI agent](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Output parser](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Normalize result](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Classification check](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Create lead record](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Classification router](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`

### Outreach

- [Hot outreach](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Warm outreach](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Cold outreach](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [48-hour wait](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Follow-up email](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Update lead status](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`

### Exceptions

- [Agent error handler](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Manual review logger](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`
- [Failure alert](https://github.com/0xshahbaz/real-estate-lead-qualification-and-outreach-with-ai/blob/main/Real%20Estate%20Lead%20Qualification%20and%20Outreach%20with%20AI%20(1).json): `Real Estate Lead Qualification and Outreach with AI (1).json`

### Other components

- **Seller**
- **Airtable**
- **Groq / Llama**
- **Slack**
- **Gmail**

## Connections

- Seller → Form trigger: submits enquiry
- Form trigger → Duplicate check: checks email
- Duplicate check → Airtable: searches records
- Duplicate check → Duplicate route: routes duplicate
- Duplicate route → Slack: alerts team
- Duplicate check → AI agent: passes new lead
- AI agent → Groq / Llama: requests scoring
- AI agent → Output parser: uses structured output
- AI agent → Agent error handler: routes agent errors
- Output parser → Normalize result: returns result
- Normalize result → Classification check: checks classification
- Classification check → Manual review logger: routes invalid result
- Classification check → Create lead record: routes valid result
- Create lead record → Airtable: creates lead
- Create lead record → Classification router: passes classification
- Classification router → Hot outreach: routes Hot
- Classification router → Warm outreach: routes Warm
- Classification router → Cold outreach: routes Cold
- Hot outreach → Slack: sends urgent alert
- Warm outreach → Slack: sends team alert
- Cold outreach → Slack: sends nurture alert
- Hot outreach → Gmail: sends outreach
- Warm outreach → Gmail: sends outreach
- Cold outreach → Gmail: sends outreach
- Hot outreach → 48-hour wait: starts follow-up delay
- Warm outreach → 48-hour wait: starts follow-up delay
- 48-hour wait → Follow-up email: continues after 48 hours
- Follow-up email → Gmail: sends follow-up
- Follow-up email → Update lead status: updates status
- Update lead status → Airtable: updates lead
- Agent error handler → Manual review logger: logs error
- Agent error handler → Failure alert: notifies team
- Manual review logger → Airtable: logs for review
- Manual review logger → Failure alert: notifies team
- Failure alert → Slack: sends alert
