UCCA Knowledge Base | External Services | Voice & SMS
Version 1.0 | 2026-03-05 | Confidential
1. Account Structure
UCCA operates a single Twilio master account owned by UCCA Inc (Delaware). A RTOpacks sub-account will be created for AU customer-facing SMS when RTOpacks goes live.
| Field |
Value |
| Account Owner |
UCCA Inc (United Community Colleges of America Inc) |
| Account SID |
ACa958efb6dca686283cb... (stored in wrangler — not documented here) |
| Auth Token |
Stored in wrangler as TWILIO_AUTH_TOKEN — never document in plaintext |
| Account Type |
Full paid account |
| Primary Number |
+13023003336 (US Delaware) |
| Country |
United States |
2. Phone Numbers
| Number |
Country |
Capabilities |
Purpose |
Status |
| +13023003336 |
US |
Voice + SMS + MMS |
Platform — inbound calls/IVR, Meta business verification |
Active |
| TBD AU number |
AU |
Voice + SMS |
RTOpacks customer SMS, AU Meta verification |
Pending provisioning |
3. Studio Flow
| Field |
Value |
| Flow Name |
UCCA Inbound Calls |
| Flow SID |
Stored in external-services.md |
| States |
14 |
| Revision |
311 |
| Purpose |
Voice IVR — handles all inbound calls to +13023003336 |
| Voicemail |
Gmail OAuth2 integration — voicemails emailed to admin@ucca.online |
4. Functions Service
| Field |
Value |
| Service Name |
voice-ivr |
| Functions |
4 (including forward-sms) |
| forward-sms |
Routes inbound SMS to Tim's mobile — added 2026-03-05 |
| Purpose |
Support functions for Studio Flow IVR |
Note
Twilio credentials are NOT stored in the codebase. Account SID and Auth Token are wrangler secrets only, available to workers at runtime.
5. Messaging Service
| Field |
Value |
| Status |
Pending creation |
| Purpose |
RTOpacks A2P 10DLC compliant SMS OTP delivery |
| Sender |
+13023003336 (interim until AU number provisioned) |
| Wrangler Secret |
TWILIO_MESSAGING_SERVICE_SID — to be set on ucca-ops |
6. Wrangler Secrets (ucca-ops)
| Secret Name |
Value |
Status |
| TWILIO_ACCOUNT_SID |
ACa958... (master account) |
Set 2026-03-05 |
| TWILIO_AUTH_TOKEN |
Redacted |
Set 2026-03-05 |
| TWILIO_PHONE_NUMBER |
+13023003336 |
Pending |
| TWILIO_STUDIO_FLOW_SID |
See external-services.md |
Pending |
| TWILIO_MESSAGING_SERVICE_SID |
TBD |
Pending — create Messaging Service first |
| RTOPACKS_TWILIO_SID |
TBD — sub-account |
Pending sub-account creation |
| RTOPACKS_TWILIO_TOKEN |
TBD — sub-account |
Pending sub-account creation |
| RTOPACKS_TWILIO_PHONE_NUMBER |
TBD — AU number |
Pending AU number purchase |
Twilio is declared in ucca-infra/twilio.tf as declarative reference locals. The official Twilio Terraform provider is pilot/stale — resources are documented as locals rather than managed resources to avoid provider instability risk.
twilio.tf committed to ucca-infra on feature/ucca-com-au-pages (2026-03-05)- Phone number config, Studio Flow SID, Functions service all declared
- SMS webhook URL configured —
forward-sms function live
8. Outstanding Tasks
| Task |
Priority |
Owner |
| Provision AU phone number (+61 Brisbane) |
P1 |
Alex |
| Create Messaging Service — add +13023003336 as sender |
P1 |
Alex |
| Set TWILIO_PHONE_NUMBER wrangler secret |
P1 |
Alex |
| Set TWILIO_STUDIO_FLOW_SID wrangler secret |
P1 |
Alex |
| Create RTOpacks Twilio sub-account |
P2 |
Tim |
| Set RTOPACKS_TWILIO_* wrangler secrets |
P2 |
Tim/Alex |
| Import Messaging Service into Terraform |
P2 |
Alex |
Version History
| Version |
Date |
Change |
Author |
| 1.0 |
2026-03-11 |
Converted from twilio-reference-v1.0.docx |
Claude Code |