> ## Documentation Index
> Fetch the complete documentation index at: https://helloluciallc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Twilio (SMS WhatsApp Voice)

<Note>
  Twilio provides real-world SMS, MMS, and WhatsApp intake for Lucia’s maintenance workflow.
</Note>

***

## Current Role

Twilio currently supports:

```text theme={"dark"}
SMS intake
MMS photo intake
WhatsApp intake
WhatsApp media intake
```

All route into:

```text theme={"dark"}
/webhooks/maintenance
```

***

## Current Development Webhooks

SMS/MMS:

```text theme={"dark"}
https://api-dev.hellolucia.ai/webhooks/maintenance?provider=twilio&source_channel=sms&webhook_kind=sms
```

WhatsApp:

```text theme={"dark"}
https://api-dev.hellolucia.ai/webhooks/maintenance?provider=twilio&source_channel=whatsapp&webhook_kind=whatsapp
```

***

## Required Engine Environment Variables

```text theme={"dark"}
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

```text theme={"dark"}
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:

```text theme={"dark"}
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

* [01 - Maintenance Workflow](/lucia/operations/maintenance-workflow)
* [05 - Bunny CDN and Storage](/lucia/infrastructure/bunny-cdn-and-storage)
* [Webhook Routing Strategy](/lucia/infrastructure/webhook-routing-strategy)