WhatsApp Experience
Overview
LandlordX is designed as a WhatsApp-first application, particularly for tenants who primarily interact with the platform via WhatsApp rather than the PWA. Landlords also benefit from WhatsApp notifications and quick actions, though they have full access to the PWA dashboard.
WhatsApp Architecture
Tenant WhatsApp Flows
Tenants interact primarily via WhatsApp, with signup required only during agreement eSigning.
Tenant Capabilities
1. Fetch Lease Agreement
Sample Interaction:
Tenant: Show my agreement
Bot: 📄 *Your Lease Agreement*
Property: Flat 101, Sunshine Apartments
Monthly Rent: ₹25,000
Tenure: 11 months (ends Dec 2025)
Status: Active ✅
[📥 Download Agreement]2. View Property & Landlord Details
Sample Interaction:
Tenant: Property details
Bot: 🏠 *Property Details*
Flat 101, Tower A
Sunshine Apartments
Koregaon Park, Pune 411001
👤 *Landlord*
Rahul Sharma
📞 +91 98765 43210
🏷️ *Agreement Terms*
Rent: ₹25,000/month
Deposit: ₹75,000
Rent Due: 5th of every month3. Payment Reminders & Payment
Reminder Schedule:
| Days Before/After Due | Message |
|---|---|
| -5 days | Friendly reminder |
| Due date | Rent due today |
| +3 days | Overdue notice |
| +7 days | Late fee warning |
Sample Interaction:
Bot: 💰 *Rent Reminder*
Hi Priya! Your rent of ₹25,000 is due on 5th Nov.
[💳 Pay Now] [📅 Set Reminder]
---
Tenant: Pay rent
Bot: 💰 *Pay Rent*
Amount: ₹25,000
Property: Flat 101, Sunshine Apartments
Due: 5th Nov 2024
[💳 Pay ₹25,000]4. Maintenance Requests
Sample Interaction:
Tenant: I have a maintenance issue
Bot: 🔧 *Maintenance Request*
What type of issue?
[Plumbing] [Electrical] [AC/Appliance]
[Door/Window] [Pest Control] [Other]
Tenant: [Plumbing]
Bot: Please describe the plumbing issue:
Tenant: Bathroom tap is leaking continuously
Bot: 📸 Please share photos of the issue (optional)
Or type "skip" to continue
Tenant: [Uploads photo]
Bot: ✅ *Request Created*
Ticket: #MNT-2024-0089
Issue: Plumbing - Bathroom tap leaking
Status: Open
We've notified your landlord.
You'll receive updates here.5. Check Request Status
Sample Interaction:
Tenant: Maintenance status
Bot: 🔧 *Your Maintenance Requests*
#MNT-2024-0089 - Plumbing
Status: In Progress 🔄
Assigned: Ravi (Plumber)
ETA: Today 4 PM
#MNT-2024-0076 - AC Service
Status: Resolved ✅
Completed: 28 Oct 2024Landlord WhatsApp Flows
Landlords receive notifications and can perform quick actions via WhatsApp, with full functionality available in the PWA.
Landlord Capabilities
1. Fetch Tenant Details
Sample Interaction:
Landlord: Show my tenants
Bot: 👥 *Your Tenants*
🏠 Flat 101, Sunshine Apartments
👤 Priya Patel
📞 +91 98765 12345
💰 Rent: ₹25,000 | Due: 5th
📄 Agreement: Active (ends Dec 2025)
🏠 Flat 203, Green Valley
👤 Amit Kumar
📞 +91 98765 67890
💰 Rent: ₹18,000 | Due: 1st
📄 Agreement: Active (ends Mar 2025)
[View in App]2. Rent Due This Month
Sample Interaction:
Landlord: Rent due this month
Bot: 💰 *Rent Due - November 2024*
Total Expected: ₹43,000
🔴 Flat 101 - ₹25,000 (Due: 5th)
Priya Patel - Not Paid
[Send Reminder]
🟢 Flat 203 - ₹18,000 (Due: 1st)
Amit Kumar - Paid ✅3. Track Rent Collected
Sample Interaction:
Landlord: Rent collected this month
Bot: 💵 *Rent Collection - November 2024*
Total Collected: ₹18,000 / ₹43,000
✅ Flat 203 - ₹18,000
Paid on: 1st Nov 2024
Via: UPI
⏳ Flat 101 - ₹25,000
Status: Pending
Due: 5th Nov 2024
[View Details in App]4. Maintenance Request Management
Sample Interaction:
Bot → Landlord:
🔧 *New Maintenance Request*
Property: Flat 101, Sunshine Apartments
Tenant: Priya Patel
Issue: Plumbing - Bathroom tap leaking
Priority: Medium
Created: 2 Nov 2024, 10:30 AM
[📷 View Photos] [✅ Acknowledge] [🔄 Assign]
---
Landlord: [✅ Acknowledge]
Bot: Request #MNT-2024-0089 acknowledged.
Would you like to:
[Assign to someone] [Add comment] [Mark resolved]WhatsApp Menu System
Main Menu
Both tenants and landlords can access the main menu:
Tenant: Hi / Menu / Help
Bot: 👋 Welcome to LandlordX!
What would you like to do?
[📄 My Agreement] [💰 Pay Rent]
[🏠 Property Details] [🔧 Maintenance]
[📜 Payment History] [❓ Help]Landlord: Hi / Menu / Help
Bot: 👋 Welcome to LandlordX!
What would you like to do?
[👥 My Tenants] [💰 Rent Status]
[💵 Collections] [🔧 Maintenance]
[📄 Agreements] [❓ Help]Interactive Message Types
| Type | Use Case | Example |
|---|---|---|
| Text | Informational messages | Status updates, details |
| Document | Sharing files | Agreement PDF, receipts |
| Buttons | Quick actions (max 3) | Pay Now, View Details |
| List | Multiple options | Maintenance categories |
| Payment Links | Integrated payments | Pay rent button |
Bot Command Reference
Tenant Commands
| Command | Action |
|---|---|
agreement / my agreement | Fetch lease agreement |
property / details | View property & landlord info |
pay rent / payment | Get payment link |
history / receipts | View payment history |
maintenance / issue | Raise maintenance request |
status | Check maintenance status |
help | Show help menu |
Landlord Commands
| Command | Action |
|---|---|
tenants / my tenants | List all tenants |
rent due / pending | Show pending rent |
collected / received | Show collected rent |
maintenance | View maintenance requests |
remind [tenant] | Send payment reminder |
help | Show help menu |
WhatsApp vs PWA Feature Comparison
| Feature | Tenant WhatsApp | Tenant PWA | Landlord WhatsApp | Landlord PWA |
|---|---|---|---|---|
| View agreement | ✅ | ✅ | ✅ | ✅ |
| Pay rent | ✅ | ✅ | - | - |
| Payment history | ✅ | ✅ | ✅ | ✅ |
| Raise maintenance | ✅ | ✅ | - | ✅ |
| Manage maintenance | ❌ | ❌ | Basic | ✅ Full |
| Create agreement | ❌ | ❌ | ❌ | ✅ |
| Add property | ❌ | ❌ | ❌ | ✅ |
| eSign agreement | Link only | ✅ | Link only | ✅ |
| Analytics/Reports | ❌ | ❌ | ❌ | ✅ |
Session & Context Management
- Sessions expire after 24 hours of inactivity
- Context maintained for multi-step flows (e.g., maintenance request)
- User identified by WhatsApp phone number
Security Considerations
- Phone Verification: WhatsApp number linked to verified account
- Sensitive Data: Masked in messages (e.g., ****1234)
- Payment Links: Tokenized, single-use URLs
- Document Access: Temporary URLs, expire in 24 hours
- Session Timeout: Auto-logout after inactivity
Related Documentation
- Notifications - Multi-channel notification system
- User Onboarding - Tenant onboarding via invite links
- Lease Agreement Generation & Signing - Agreement creation and eSign process
- Lease Agreement Generation - Agreement workflow