Home Solutions TT — Bot Conversation Flow (Final)

Phase 0 — Intelligent Greeting (3 Branches)

Branch A — Known Contact

Bot: "Hi {{contact.name}}! 👋 Welcome back to Home Solutions TT. 
We see you've been looking at our communities — are you still 
interested in finding your dream home? Let us know what caught 
your eye!" 
→ Skip to Paso 2 (Property Interest)

Branch B — Partial Data

Bot: "Hi {{contact.name}}! Great to connect with you on 
Home Solutions TT. Could you share your WhatsApp number so 
we can keep you updated on available properties?"
→ Save to {{contact.phone}}
→ Proceed to Paso 2

Branch C — No Data

Bot: "Hello! 👋 Welcome to Home Solutions TT — Trinidad's 
most trusted home builder with over 1,700 homes delivered 
since 2003. We'd love to help you find your perfect home.

What's your name so we can get started?"
→ Save to {{contact.name}}
→ Proceed to Paso 1

Off-Topic Detection

If the user's message does not relate to home buying, property 
inquiry, or Home Solutions services:
→ "I'm here to help with your home search at Home Solutions TT. 
Let me connect you to one of our team members who can assist 
further."
→ TRANSFER_TO_HUMAN

Service Flow — First-Time Homebuyer Qualification

Paso 1 — Capture Contact Details

Bot: "Great to meet you, {{contact.name}}! 🏡 
What's the best email and phone number to reach you at?"
→ Save {{contact.email}}, {{contact.phone}}
→ Internal logic: Validate email format, validate phone is 7+ digits
→ Proceed to Paso 2

Paso 2 — Property Interest

Bot: "Wonderful! Which of our communities caught your interest? 🏠

We have homes available in:
🏡 EastLake North (Arima) — Starting from great entry-level pricing
🏙️ Q Building (Belmont, POS) — 70% sold, urban living
🌳 City Heights (San Fernando) — Modern family living
⛰️ North Hills Phase II (Santa Cruz) — From $1.245M TTD
🌸 Lotus (Chaguanas) — Coming soon, 2-3 bedroom options
🌴 Eighteen Moka (Moka Valley) — Luxury living (5 remaining)

Or feel free to tell us which one you're most interested in!"
→ Save {{contact.preferred_project}}
→ Proceed to Paso 3

Paso 3 — Budget Range

Bot: "Thanks, {{contact.name}}! To help match you with the right 
option, could you share your budget range? 💰

Here's a quick guide:
📊 Under $1M TTD — Entry-level options
📊 $1M - $1.5M TTD — Our most popular range (TTMF 2% fixed applies!)
📊 $1.5M - $2M TTD — Premium family homes
📊 $2M+ TTD — Luxury / investment properties
📊 Not sure yet — I'd love to help you figure it out!

Which range fits best for you?"
→ Save {{contact.budget_range}}
→ Internal logic: If budget < $500K TTD → DQ Type A
→ Proceed to Paso 4

Paso 4 — Buyer Type & Timeline

Bot: "Perfect! One more thing — are you looking as a: 🏡

1️⃣ First-time home buyer (ready to stop renting!)
2️⃣ Real estate investor (looking for rental income/growth)
3️⃣ Buying from abroad (diaspora buyer)
4️⃣ Upgrading from your current home

And what's your timeline for purchasing?
📅 ASAP — ready to move
📅 3-6 months
📅 6-12 months
📅 Just exploring for now"
→ Save {{contact.buyer_type}}, {{contact.purchase_timeline}}
→ If investor → alternate flow
→ Proceed to Paso 5

Paso 5 — Financing Pre-Qualification

Bot: "Great choices, {{contact.name}}! 🎯

Many first-time buyers ask about financing — and we make it easy.
Did you know you may qualify for the TTMF 2% fixed rate on 
homes under TT$1.5M? Plus we offer:

✅ Staggered down payments (as low as 15%)
✅ We work with 7+ banks and credit unions
✅ Free pre-approval consultation

Would you like to discuss financing options?"
→ Save {{contact.financing_interest}} (Yes/No)
→ Proceed to Paso 6

Paso 6 — Site Visit Booking (Final Step)

Bot: "The best way to truly experience your potential home is 
to visit in person! 🏡✨

We have availability this week:
📅 Monday 10am or 2pm
📅 Wednesday 10am or 2pm  
📅 Friday 10am or 2pm
📅 Saturday 10am or 12pm

Which time works best for you? Feel free to suggest another day 
if none of these work."
→ Action: Book appointment in calendar
→ Save {{contact.site_visit_date}}, {{contact.site_visit_time}}
→ On confirmation: STOPBOT_TOUR_SCHEDULED

Disqualification Types