WhatsApp Business Integration: Complete Setup Guide

WhatsApp is a dominant communication channel in UAE. TenancyDesk's official WhatsApp Business API integration transforms tenant communication — higher open rates than email and SMS, with faster document collection and response times.

Why WhatsApp Integration

Business benefits (qualitative):

• High message open rate on WhatsApp vs email and SMS
• Faster document collection via tenant WhatsApp uploads
• Reduced phone call volume through automated reminders
• Quicker tenant response times with instant notifications
• Improved rent collection via timely reminders

---

Prerequisites

1. Meta Business Account

Required (free):

1. Visit business.facebook.com
2. Create Business Account
3. Verify business (trade license, website)
4. Add WhatsApp product

Verification time: 1-3 business days

2. WhatsApp Phone Number

Requirements:

• UAE number recommended (+971 5X XXX XXXX)
• Cannot be personal WhatsApp number
• Dedicated for business use only
• Verified via SMS/call

Cost: Phone number free (Meta), or virtual number from BSP (~AED 50/month)

3. Business Solution Provider (BSP)

What is BSP: Meta-certified provider for WhatsApp Business API access

Options for UAE:

• Infobip (recommended): Full-featured, 24/7 support
• 2Factor: India-based, competitive pricing
• Direct Meta (Enterprise only): Requires significant volume

Pricing (Infobip example):

• Free tier: 1,000 conversations/month
• Session messages: Free (within 24h of user message)
• Template messages: ~AED 0.15-0.30 per message
• Customer service conversations: Free

---

Setup Process

Step 1: Register with BSP (Infobip Example)

1. Visit infobip.com/whatsapp
2. Click Start Free Trial
3. Enter business details:
   • Company name
   • Trade license (upload)
   • Contact information
4. Email verification (instant)
5. Business verification (1-2 days)

Step 2: Get WhatsApp API Credentials

1. Infobip dashboard → WhatsApp → Setup
2. Register phone number (+971 5X XXX XXXX)
3. Verify via SMS code
4. Copy API credentials:
   • API Key: eyJhbGc...
   • API Base URL: https://api.infobip.com
   • Sender (phone): +9715XXXXXXXX

Step 3: Connect to TenancyDesk

1. TenancyDesk → Settings → Integrations → WhatsApp
2. Click Connect WhatsApp Business
3. Enter credentials from Infobip:
   • API Key
   • API Base URL
   • Sender phone number
4. Test connection → sends test message to your phone
5. Connected (green indicator)

Step 4: Configure Message Templates

Meta requires pre-approval for all templates (spam prevention)

TenancyDesk pre-approved templates (ready to use):

1. Rent Reminder (7 days before):

   Hello {{tenant_name}},
   
   Your rent payment of AED {{amount}} is due on {{due_date}}.
   
   Please deposit cheque #{{cheque_num}} by the due date.
   
   - TenancyDesk ({{agent_name}})
   

2. Document Request:

   Hi {{tenant_name}},
   
   We still need your {{document_type}} for deal {{deal_ref}}.
   
   Upload here: {{portal_link}}
   
   Thanks!
   

3. Payment Confirmation:

   Payment received! 
   
   AED {{amount}} for {{property_address}}
   
   Receipt: {{receipt_url}}
   

4. Ejari Approval:

   Great news! Your Ejari certificate is approved.
   
   Certificate #: {{ejari_number}}
   
   Download: {{certificate_url}}
   

Custom template creation:

1. WhatsApp Settings → Message Templates
2. Click Create Template
3. Write message (use {{variables}})
4. Submit for Meta approval
5. Approval time: 1-3 days
6. Use in TenancyDesk automation

---

Automation Rules

Settings → WhatsApp Automation

Trigger → Action:

• Payment due in 7 days → Send rent reminder
• Document missing → Send upload request (every 2 days, max 3 times)
• Payment received → Send confirmation
• Document verified → Send confirmation link
• Compliance issue → Alert manager (not tenant)

Customization:

• Set trigger timing (3, 7, 14 days)
• Choose templates per trigger
• Enable/disable per deal type
• Dubai business hours only (09:00–18:00 GST)

---

Compliance & Best Practices

GDPR/PDPL Compliance

Opt-in required:

• Tenants must consent to WhatsApp communication
• TenancyDesk tracks consent in Deal Portal
• Opt-out anytime via "STOP" message

Data privacy:

• No PII in message content (use variables)
• Messages encrypted end-to-end (WhatsApp)
• Logs retained 90 days (compliance)

Best Practices

** DO**:

• Use pre-approved templates only
• Send during Dubai business hours (09:00–18:00 GST)
• Max 1 message/day per tenant (avoid spam)
• Respond to tenant replies within 24h (free session)
• Test with small group before full rollout

** DON'T**:

• Send marketing messages (WhatsApp prohibits)
• Use unapproved templates (account suspension risk)
• Send outside business hours (annoys tenants)
• Ignore tenant "STOP" requests (illegal)

Message Frequency Limits

• Rent reminders: Max 1 per payment (7 days before)
• Document requests: Max 3 per document
• General updates: Max 1/week per tenant
• Response to tenant message: Unlimited (within 24h session)

---

WhatsApp integration improves tenant satisfaction and reduces agent workload. Setup takes minutes; benefits compound over time.