Skip to main content
Twilio provides real-world SMS, MMS, and WhatsApp intake for Lucia’s maintenance workflow.

Current Role

Twilio currently supports:
SMS intake
MMS photo intake
WhatsApp intake
WhatsApp media intake
All route into:
/webhooks/maintenance

Current Development Webhooks

SMS/MMS:
https://api-dev.hellolucia.ai/webhooks/maintenance?provider=twilio&source_channel=sms&webhook_kind=sms
WhatsApp:
https://api-dev.hellolucia.ai/webhooks/maintenance?provider=twilio&source_channel=whatsapp&webhook_kind=whatsapp

Required Engine Environment Variables

TWILIO_ACCOUNT_SID
TWILIO_AUTH_TOKEN
These are required for authenticated media fetch. Without them, images remain provider URLs and break in the browser.

Current Status

SMS text → working
MMS media → working
WhatsApp text → working
WhatsApp media → working

Voice

Voice is separate. Current SMS/WhatsApp webhook routes should not be used for voice calls. Future voice options include:
call forwarding
voicemail
transcription
voice intake
after-hours maintenance flow

ngrok Status

ngrok is no longer required for dev/staging webhook testing because public endpoints exist. ngrok is only needed if intentionally routing Twilio to local Mac localhost.

See Also