Voice / Twilio — Oshun System Docs

What It Does

Patients call Oshun and talk to Karen. Twilio handles phone infrastructure (SIP trunk, routing). ElevenLabs provides real-time voice synthesis. Handles booking inquiries, procedure questions, and escalation to staff when a human is needed.

External Connections

Phone number: (876) 676-6297
Twilio SIP trunk — receives inbound PSTN calls, executes TwiML routing
ElevenLabs voice — real-time speech synthesis and transcription

Env Vars

TWILIO_ACCOUNT_SID
TWILIO_AUTH_TOKEN
ELEVENLABS_API_KEY
ELEVENLABS_AGENT_ID

Related Journeys

Journey 8: Voice Calls

Source Files

src/webhooks/voice.js — all voice routes; registers Twilio and ElevenLabs endpoints
src/webhooks/voice_helpers.js — handleScheduleCallback(), handleBookAppointment()
src/watchdog_voice.js — runVoiceBridgeMonitor(), runCallTranscriptSync()
Oshun/create_oshun_trunk.mjs — SIP trunk provisioning script
Oshun/oshun_twiml.xml — TwiML response connecting calls to ElevenLabs

Known Issues

Outbound calls cost approximately $0.30/call — cost optimization for outbound voice campaigns is pending.

SIP traffic monitoring scripts: oshun_stats_collector.mjs, oshun_traffic_deep_dive.mjs — run manually as needed.