# The owner's original flowchart spec (as given on 2026-10-02)

> Verbatim copy of `storage/app/workflow/PropertyLab Flow.md`. That folder is **git-ignored**, so the original exists only on the owner's machine; the drawings `PropertyLab Flow.drawio.svg` and `PropertyLab Flow.webp` sit beside it there.
> This is the INPUT the session started from. The open questions at its end were answered later: see [02-decisions.md](02-decisions.md).
> What was actually BUILT, and where it differs from this spec: [06-sales-workflow.md](06-sales-workflow.md).

---

# PropertyLab Lead Flow

Funnel for the **AI买房训练营 by Wai Kit** webinar programme: how a lead moves from the landing page to a closed sale.

- Source: `PropertyLab Flow.drawio.svg` / `PropertyLab Flow.webp`
- Visual version: https://claude.ai/artifact/Y8T7Up2ER6cGh5iH9PL3Mr

---

## 1. Overview

The flow has **3 stages**, separated by **3 milestones**:

| # | Stage | Starts at | Ends at (milestone) | Analysis data captured |
|---|-------|-----------|---------------------|------------------------|
| 1 | Registration | Landing page registration | **Preview Webinar Start** | DATA 1, DATA 2 |
| 2 | Preview Webinar follow-up | After the Preview Webinar | **Project Webinar Start** | DATA 3, DATA 4 (paid path: DATA 3+4) |
| 3 | Project Webinar follow-up | After the Project Webinar | **Closing** → Won / Not closed | DATA 3, DATA 4 (paid path: DATA 5) |

Stages 2 and 3 use the same structure:

1. **Attended?** No-shows get a WhatsApp follow-up, then an AI call.
2. **Paid?**
   - Paid leads get a dedicated REP and a Human Zoom.
   - Unpaid leads get a WhatsApp follow-up, an AI call, then a human call.

### Recurring sub-process: the AI call loop

Used in all 3 stages:

```
AI Call ──► Picked up?
              ├─ Yes ─► System auto-records call notes (DATA n) ─► Human Call / Zoom
              └─ No ──► WhatsApp "missed call" message with call-back button ─► Clicked?
                                                                   ├─ Yes ─► AI Call (retry)
                                                                   └─ No ──► Human Call / Zoom
```

### Step types

| Type | Meaning |
|------|---------|
| WhatsApp | Automated WhatsApp message (templates M1–M4 below) |
| AI Call | AI voice agent calls the lead, asks and records details, and books a human appointment |
| Human | Human sales / REP call or Zoom |
| System | Automatic system action (record notes, assign REP) |
| Reminder | Scheduled reminder messages (R1, R2 below) |
| DATA n | Point where analysis data about the lead is captured |

---

## 2. Stage 1: Registration → Preview Webinar

```mermaid
flowchart TD
  S([Start]) --> LP[System: Landing page registration]
  LP --> Q1{Ticked OK for<br/>AI call now?}
  Q1 -- Yes --> W1[WhatsApp: Welcome message M1]
  Q1 -- No --> W2[WhatsApp: Welcome message M1]
  W2 -- after 2 min --> W3[WhatsApp: Offer an AI call M2]
  W1 --> AI[AI Call]
  AI --> PU{Picked up?}
  PU -- Yes --> REC[System: Auto-record call notes<br/>DATA 1]
  PU -- No --> W4[WhatsApp: Missed-call message M3]
  W3 --> CK{Clicked?}
  W4 --> CK
  CK -- Yes --> AI
  CK -- No --> HC
  REC --> HC[Human Call / Zoom, round robin<br/>DATA 2]
  HC --> RM[Reminder messages R1]
  RM --> PW([Preview Webinar Start])
  PW -.-> R2[During the webinar R2]
```

### Steps

1. **Start**: lead registers on the landing page.
2. **Decision: Ticked OK for AI call now?** (checkbox on the registration form)
   - **Yes**
     1. WhatsApp **M1 Welcome message**.
     2. **AI Call**.
   - **No**
     1. WhatsApp **M1 Welcome message**.
     2. **After 2 minutes**: WhatsApp **M2 Offer an AI call**.
     3. **Decision: Clicked?**
        - Yes → **AI Call**.
        - No → **Human Call / Zoom**.
3. **AI Call**
   - AI asks and records details: 1) 2) 3) *(questions not yet defined)*.
   - Action item: **generate an appointment for a Human Call / Zoom**.
4. **Decision: Picked up?**
   - **Yes**: the system auto-records the info in the lead's discussion. **Analysis Data (1)** is captured. Then go to Human Call / Zoom.
   - **No**
     1. WhatsApp **M3 Missed call · before webinar**.
     2. **Decision: Clicked?**
        - Yes → AI Call again.
        - No → Human Call / Zoom.
5. **Human Call / Zoom** (assigned by **round robin**). **Analysis Data (2)** is captured.
   - Human asks and records details: 1) 2) 3) *(questions not yet defined)*.
   - Action item: **remind them to join the webinar**.
6. **Reminder messages**: see schedule **R1**.
7. **Milestone: Preview Webinar Start**.
   - Runs during the webinar: **R2**.

---

## 3. Stage 2: Preview Webinar → Project Webinar

```mermaid
flowchart TD
  IN([After the Preview Webinar]) --> AT{Attended?}
  AT -- No --> NS[WhatsApp: Follow-up, why didn't you attend?]
  AT -- Yes --> PD{Paid?}
  PD -- Yes --> PAY[WhatsApp: Payment received]
  PAY --> ASG[System: Auto-assign a REP<br/>REP calls lead directly to book Zoom<br/>DATA 3+4]
  ASG --> HZ[Human Zoom]
  PD -- No --> FU[WhatsApp: Follow-up message]
  FU --> AI[AI Call]
  NS --> AI
  AI --> PU{Picked up?}
  PU -- Yes --> REC[System: Auto-record call notes<br/>DATA 3]
  PU -- No --> MS[WhatsApp: Missed-call message M4]
  MS --> CK{Clicked?}
  CK -- Yes --> AI
  CK -- No --> HC
  REC --> HC[Human Call / Zoom<br/>DATA 4]
  HC --> RM[Reminder messages R1]
  HZ --> RM
  RM --> PJ([Project Webinar Start])
  PJ -.-> R2[During the webinar R2]
```

### Steps

1. **Decision: Attended?** (the Preview Webinar)
   - **No**
     1. WhatsApp **follow-up message asking why they did not attend** *(copy not written yet)*.
     2. **AI Call**: AI asks and records details 1) 2) 3); action item: generate an appointment for a Human Call / Zoom.
     3. Join the **Picked up?** step below.
   - **Yes** → **Decision: Paid?**
2. **Paid? = Yes** (paid path)
   1. WhatsApp **Payment received message** *(copy not written yet)*.
   2. **System auto-assigns a REP**. The REP **must call the lead directly** to schedule a Zoom appointment. **Analysis Data (3 + 4)** is captured.
   3. **Human Zoom**
      - Human asks and records details 1) 2) 3).
      - Action item: **remind them to join the project sharing webinar**.
   4. → Reminder messages.
3. **Paid? = No** (unpaid path)
   1. WhatsApp **Follow-up message** *(copy not written yet)*.
   2. **AI Call**: AI asks and records details 1) 2) 3); action item: generate an appointment for a Human Call / Zoom.
   3. **Decision: Picked up?**
      - **Yes**: the system auto-records the info in the lead's discussion. **Analysis Data (3)** is captured. Then go to Human Call / Zoom.
      - **No**
        1. WhatsApp **M4 Missed call · after webinar**.
        2. **Decision: Clicked?**
           - Yes → AI Call again.
           - No → Human Call / Zoom.
   4. **Human Call / Zoom**. **Analysis Data (4)** is captured.
      - Human asks and records details 1) 2) 3).
      - Action item: **remind them to join the project sharing webinar**.
   5. → Reminder messages.
4. **Reminder messages**: see schedule **R1**.
5. **Milestone: Project Webinar Start**.
   - Runs during the webinar: **R2**.

---

## 4. Stage 3: Project Webinar → Closing

```mermaid
flowchart TD
  IN([After the Project Webinar]) --> AT{Attended?}
  AT -- No --> NS[WhatsApp: Follow-up, why didn't you attend?]
  AT -- Yes --> PD{Paid?}
  PD -- Yes --> PAY[WhatsApp: Payment received]
  PAY --> ASG[System: Auto-assign a REP<br/>REP calls lead directly to book Zoom<br/>DATA 5]
  ASG --> HZ[Human Zoom]
  PD -- No --> FU[WhatsApp: Follow-up message]
  FU --> AI[AI Call]
  NS --> AI
  AI --> PU{Picked up?}
  PU -- Yes --> REC[System: Auto-record call notes<br/>DATA 3]
  PU -- No --> MS[WhatsApp: Missed-call message M4]
  MS --> CK{Clicked?}
  CK -- Yes --> AI
  CK -- No --> HC
  REC --> HC[Human Call / Zoom<br/>DATA 4]
  HC --> CL([Closing])
  HZ --> CL
  CL --> CC{Closed?}
  CC -- Yes --> WON[Won: Congratulations!<br/>Keep following up until converted]
  CC -- No --> LOST[Not closed: system must record the reason]
```

### Steps

1. **Decision: Attended?** (the Project Webinar)
   - **No**: WhatsApp follow-up asking why they did not attend → **AI Call** → join **Picked up?**.
   - **Yes** → **Decision: Paid?**
2. **Paid? = Yes** (paid path)
   1. WhatsApp **Payment received message**.
   2. **System auto-assigns a REP**. The REP must call the lead directly to schedule a Zoom appointment. **Analysis Data (5)** is captured.
   3. **Human Zoom**: human asks and records details 1) 2) 3).
      - Action item: the original repeats "Remind them to join project sharing webinar" *(to confirm, see open questions)*.
   4. → **Closing**.
3. **Paid? = No** (unpaid path)
   1. WhatsApp **Follow-up message**.
   2. **AI Call**: AI asks and records details 1) 2) 3); action item: generate an appointment for a Human Call / Zoom.
   3. **Decision: Picked up?**
      - **Yes**: the system auto-records the info. **Analysis Data (3)** is captured *(numbering as in the original)*.
      - **No**: WhatsApp **M4** → **Clicked?**
        - Yes → AI Call again.
        - No → Human Call / Zoom.
   4. **Human Call / Zoom**. **Analysis Data (4)** is captured *(numbering as in the original)*.
      - Action item: the original repeats "Remind them to join project sharing webinar" *(to confirm)*.
   5. → **Closing**.
4. **Milestone: Closing**.
5. **Decision: Close?**
   - **Yes → Won**: "Congratulations! Please keep following up to make sure the lead is converted."
   - **No → Not closed**: in the end the system **must show the reason**, for example:
     - Not ready to buy property?
     - No loan eligibility?

---

## 5. Reminder schedules

### R1: Before each webinar (Preview and Project)

| When | Channel | Sent to |
|------|---------|---------|
| 24 hours before the webinar | WhatsApp | PM (private message) |
| Webinar day, 5 hours before | WhatsApp | Group |
| Webinar day, 3 hours before | WhatsApp | PM |
| Webinar day, 30 minutes before | SMS | PM |

Rule: leads who said they will **join next time** stop receiving reminders for this session.

### R2: During each webinar

| When | Channel | Action |
|------|---------|--------|
| 15 minutes after start | AI Call | Call leads who have not joined |
| 1 hour after start | WhatsApp | Post a screenshot to the group |

---

## 6. WhatsApp message templates

### M1: Welcome message

- **Sent:** right after registration, on both the "OK for AI call" Yes and No paths.
- **Button:** `Yes, 我已进群了`

```text
Hi XXX 👋 恭喜你成功报名AI买房训练营 by Wai Kit!

*Step 1：加入AI买房训练营拿Bonus🧧*
👉 https://chat.whatsapp.com/xxxxxxxx

*Step 2：登入领取你的专属AI买房建议📊*
👉 https://app.propertylab.com.my/auth/sign-in/… (一键 login link)

活动详情:
📅: 16 September 2026
⏰: 8:00pm - 10:00pm
Link: https://app.propertylab.com.my/zoom/xxxxxx (他自己的 Zoom link)

你的位子已confirm✅
进群后，回复 *Yes, 我已进群了* 领取你的专属福利！ 😉

[ 按钮：Yes, 我已进群了 ]
```

### M2: Offer an AI call

- **Sent:** 2 minutes after M1, only to leads who did **not** tick "OK for AI call".
- **Button:** `让 AI 助理 call 我` → `https://propertylabglobal.com/ai-callback/{{1}}`

```text
Hi XXX👋 这里是 PropertyLab 的报名跟进助理。

你报名 webinar 的时候选择了「暂时不要 AI 助理 call 你」，所以我们没有打扰你 😊

不过在 webinar 开始前，AI 助理可以用 2 分钟了解你最想听什么、目前遇到什么问题，帮你把内容安排成你要的。

想要的话，按下面的按钮，AI 助理会马上 call 你 📞
不想也没关系，webinar 的 reminder 会照常 send 给你，到时见 👋

[ 按钮：让 AI 助理 call 我 ]  →  https://propertylabglobal.com/ai-callback/{{1}}
```

### M3: Missed call, before the webinar

- **Sent:** the Stage 1 AI call was not picked up.
- **Button:** `让 AI 助理打给我` → `https://propertylabglobal.com/ai-callback/{{1}}`

```text
Hi XXXX，这里是 PropertyLab 的报名跟进助理。

关于你刚刚的 webinar 报名：我们有致电想跟你确认一些细节（为了把内容安排成你想听的），但没有联系上你。

方便的时候，点下面的按钮，AI 助理会立刻回电给你，大约两分钟。

[ 按钮：让 AI 助理打给我 ]  →  https://propertylabglobal.com/ai-callback/{{1}}
```

### M4: Missed call, after the webinar (Stages 2 and 3)

- **Sent:** a post-webinar AI call was not picked up.
- **Button:** `让 AI 助理打给我` → `https://propertylabglobal.com/ai-callback/{{1}}`

```text
Hi XXXX，这里是 PropertyLab 的Webinar跟进助理。

XXXX，但没有联系上你。

方便的时候，点下面的按钮，AI 助理会立刻回电给你，大约两分钟。

[ 按钮：让 AI 助理打给我 ]  →  https://propertylabglobal.com/ai-callback/{{1}}
```

> The second line is incomplete in the original ("XXXX，但没有联系上你。").

### Messages without copy yet

| Message | Used in | When |
|---------|---------|------|
| Payment received | Stages 2 and 3, paid path | Lead has paid |
| Follow-up: why didn't you attend? | Stages 2 and 3, no-show path | Lead did not join the webinar |
| Follow-up message | Stages 2 and 3, unpaid path | Lead attended but has not paid |

---

## 7. Call scripts

| Call | Stage | Who | Asks & records | Action item |
|------|-------|-----|----------------|-------------|
| AI Call | 1 | AI agent | 1) 2) 3) *(TBD)* | Generate an appointment for a Human Call / Zoom |
| Human Call / Zoom (round robin) | 1 | Human | 1) 2) 3) *(TBD)* | Remind them to join the webinar |
| AI Call | 2, 3 | AI agent | 1) 2) 3) *(TBD)* | Generate an appointment for a Human Call / Zoom |
| Human Call / Zoom | 2 | Human | 1) 2) 3) *(TBD)* | Remind them to join the project sharing webinar |
| Human Zoom (assigned REP) | 2 | REP | 1) 2) 3) *(TBD)* | Remind them to join the project sharing webinar |
| Human Call / Zoom | 3 | Human | 1) 2) 3) *(TBD)* | *To confirm* |
| Human Zoom (assigned REP) | 3 | REP | 1) 2) 3) *(TBD)* | *To confirm* |

---

## 8. Analysis data capture points

| Label | Stage | Captured at |
|-------|-------|-------------|
| DATA 1 | 1 | AI call picked up, system auto-records |
| DATA 2 | 1 | Human Call / Zoom (round robin) |
| DATA 3 + 4 | 2 | Paid path: REP auto-assigned |
| DATA 3 | 2 | Unpaid / no-show path: AI call picked up, system auto-records |
| DATA 4 | 2 | Unpaid / no-show path: Human Call / Zoom |
| DATA 5 | 3 | Paid path: REP auto-assigned |
| DATA 3 *(as in original)* | 3 | Unpaid / no-show path: AI call picked up |
| DATA 4 *(as in original)* | 3 | Unpaid / no-show path: Human Call / Zoom |

---

## 9. Open questions

1. **DATA numbering in Stage 3.** The unpaid path reuses DATA 3 / DATA 4 from Stage 2. Is this intended, or should they be new numbers (e.g. DATA 6 / DATA 7)?
2. **Stage 3 human action item.** Both Stage 3 human steps say "Remind them to join project sharing webinar", but that webinar has already happened. What should the action be (e.g. push for closing)?
3. **What "Paid?" means.** Do Stage 2 and Stage 3 check the same payment (e.g. a booking fee) or different products?
4. **M4 copy** is incomplete.
5. **Missing copy** for Payment received, the no-show follow-up and the unpaid follow-up.
6. **Call questions** 1) 2) 3) for every AI and human call are not defined yet.
