E-008: Channel Integrations

Status: Next Owner: @bilal @deen Priority: P1 — Ship to Production

Objective

Connect real communication channels so tenants can reach the AI via WhatsApp, SMS, voice, and email.

Tasks

Twilio (WhatsApp + SMS)

TaskIDDescriptionStatus
Account setupINT-TWILIO-001Twilio account, phone number, WhatsApp sandboxPlanned
Webhook tunnelINT-TWILIO-002ngrok/cloudflared for local testingPlanned
E2E testINT-TWILIO-003WhatsApp inbound → identity → conversation → issuePlanned
SMS notificationsINT-TWILIO-004Landlord alert SMS on issue creationPlanned

WhatsApp Media

TaskIDDescriptionStatus
Download mediaMEDIA-WA-001Download from provider temporary URLsPlanned
Store permanentlyMEDIA-WA-002Supabase Storage, permanent URL on messagePlanned
Auto-attach to issueMEDIA-WA-003Link media to issue if conversation has linked issuePlanned
Vision AIMEDIA-WA-004Claude vision for image context (optional)Planned

SendGrid (Email)

TaskIDDescriptionStatus
Account + senderINT-EMAIL-001SendGrid account, sender verificationPlanned
Issue notificationINT-EMAIL-002Email template for new issuesPlanned
Expiry remindersINT-EMAIL-003Document expiry reminder emailsPlanned

Voice (VAPI/Retell)

TaskIDDescriptionStatus
VAPI setupINT-VOICE-001Account, assistant with Envo system promptPlanned
Voice E2E testINT-VOICE-002Voice call → transcript → issue creationPlanned
Retell evaluationINT-VOICE-003Evaluate as alternative to VAPIPlanned

Channel Trust Model

ChannelIdentity SignalConfidence
WhatsAppPhone number (Twilio verified)High
SMSPhone number (Twilio verified)High
VoiceCallerID (spoofable)Medium
Web ChatOTP authenticatedHigh
EmailEmail address (unverified)Low

Dependencies