Real Estate Lead Nurture System

How It Works

1. 1
   Webhook Receipt

   Receive HubSpot webhook notification containing lead ID and trigger event details, validate webhook signature and extract lead identifier

   HubSpot Webhooks API
2. 2
   Lead Data Retrieval

   Query HubSpot Contacts API using lead ID to fetch complete contact record including name, phone, property interests, lead source, and custom fields

   HubSpot Contacts API
3. 3
   Message Personalization

   Generate personalized SMS content using lead data and property interest templates, incorporating lead name and specific property types they inquired about

   Custom Template Engine
4. 4
   SMS Dispatch

   Send personalized message via Twilio SMS API, including opt-out instructions and agent contact information for immediate follow-up

   Twilio Messaging API
5. 5
   Activity Logging

   Record SMS delivery status and timestamp back to HubSpot lead record, create activity entry for sales team visibility and compliance tracking

   HubSpot Activities API

Implementation

# Speed-to-Lead Bot Implementation

## File Structure
```
speed-to-lead-bot/
├── app.py                 # Flask webhook receiver
├── lead_processor.py      # Core lead processing logic
├── message_templates.py   # SMS template management
├── hubspot_client.py      # HubSpot API wrapper
├── twilio_client.py       # Twilio SMS client
├── config/
│   ├── settings.py        # Environment configuration
│   └── templates.json     # Message templates by property type
├── requirements.txt
└── deploy/
    └── docker-compose.yml
```

## Core Implementation

### app.py
```python
from flask import Flask, request, jsonify
from lead_processor import process_new_lead
import logging

app = Flask(__name__)

@app.route('/webhook/hubspot', methods=['POST'])
def hubspot_webhook():
    try:
        lead_data = request.json
        lead_id = lead_data['objectId']
        process_new_lead(lead_id)
        return jsonify({'status': 'success'})
    except Exception as e:
        logging.error(f'Webhook processing failed: {e}')
        return jsonify({'error': str(e)}), 500
```

### Environment Variables
```
HUBSPOT_API_KEY=your_hubspot_key
TWILIO_ACCOUNT_SID=your_twilio_sid
TWILIO_AUTH_TOKEN=your_twilio_token
TWILIO_PHONE_NUMBER=+1234567890
WEBHOOK_SECRET=your_webhook_secret
```

## Deployment
```bash
docker-compose up -d
ngrok http 5000  # For webhook testing
# Configure HubSpot webhook URL: https://your-domain.com/webhook/hubspot
```

Data Flow

Prerequisites

• -HubSpot webhook endpoint configured and SSL secured
• -Twilio phone number with SMS capabilities activated
• -Lead opt-in consent mechanism for SMS compliance
• -Flask/Python runtime environment with internet access

Error Handling