How Can an AI Voice Agent Qualify Real-Estate Leads?

from pydantic import BaseModel, Field
from typing import Optional, Literal
import httpx

class BuyerQualification(BaseModel):
    caller_phone: str
    property_address: str
    financing_type: Literal["cash", "pre_approved", "needs_lender", "unqualified"]
    pre_approval_amount: Optional[int] = Field(default=None)
    timeframe_days: int
    has_home_to_sell: bool
    has_signed_broker_agreement: bool

async def evaluate_real_estate_lead(lead: BuyerQualification, fow_api_key: str):
    # Rule 1: Cannot solicit buyers with exclusive representation
    if lead.has_signed_broker_agreement:
        return {"action": "polite_decline", "reason": "Exclusive buyer agent already retained"}

    # Rule 2: High Priority Lead -> Instant Warm Transfer to Duty Agent
    is_high_intent = (
        lead.financing_type in ["cash", "pre_approved"] and
        lead.timeframe_days <= 60 and
        (lead.pre_approval_amount or 0) >= 450000
    )

    async with httpx.AsyncClient() as client:
        if is_high_intent:
            # Sync to Follow Up Boss with Hot Lead tag
            await client.post(
                "https://api.followupboss.com/v1/events",
                headers={"Authorization": f"Basic {fow_api_key}"},
                json={
                    "type": "General Inquiry",
                    "person": {"phone": lead.caller_phone},
                    "message": f"HOT BUYER: Pre-approved for ${lead.pre_approval_amount:,}. Ready in {lead.timeframe_days}d for {lead.property_address}.",
                    "tags": ["AI-Hot-Lead", "Instant-Showing-Requested"]
                }
            )
            return {"action": "warm_transfer", "target_queue": "on_duty_listing_agents"}
        
        # Rule 3: Nurture & Mortgage Partner Handoff
        return {"action": "schedule_lender_consult", "crm_pipeline": "lender_nurture_30d"}