How gsarankumar29/gcp-sre-voice-dispatcher works
GCP SRE Voice Dispatcher receives Cloud Run incident alerts through Pub/Sub or a direct webhook, validates and filters them, then simulates or requests a Vapi voice call. During calls, Vapi can invoke tools to acknowledge an incident or retry an allowed Cloud Run job. Configuration and token verification support these flows. The README documents the cloud delivery and voice integrations; source excerpts show the application-side handlers. Acknowledgement is currently temporary and non-persistent.
Main entry points: main.py FastAPI Dispatcher · vapi_service.py Voice Dispatch Service · vapi_tools.py Tool Dispatch · cloud_run_service.py Cloud Run Job Service
Components 20
Alert Ingestion
- FastAPI Dispatcher
app/main.py - Alert Payload Model
app/models/alerts.py - Severity Filter
app/main.py
Incident Dispatch
- Voice Dispatch Service
app/services/vapi_service.py - Simulation Mode
app/services/vapi_service.py
Voice Tools
- Vapi Tools Endpoint
app/api/vapi_tools.py - Tool Dispatch
app/api/vapi_tools.py - Incident Acknowledgement
app/api/vapi_tools.py - Cloud Run Job Service
app/services/cloud_run_service.py
Security And Config
- Token Verification
app/security/auth.py - Application Settings
app/config.py
Other components
- Cloud Run Failure
- Google Cloud Alert
- Pub/Sub Topic
- Push Subscription
- Direct Alert Sender
- Vapi API
- On-Call Engineer
- Vapi Assistant
- Cloud Run Jobs
Connections 20
- Cloud Run Failure → Google Cloud Alert: raises alert
README.md - Google Cloud Alert → Pub/Sub Topic: publishes alert
README.md - Pub/Sub Topic → Push Subscription: delivers messages
README.md - Push Subscription → FastAPI Dispatcher: posts alerts
README.md - Direct Alert Sender → FastAPI Dispatcher: posts alert
README.md - FastAPI Dispatcher → Alert Payload Model: validates payload
app/main.py - FastAPI Dispatcher → Token Verification: requires token check
app/main.py - Token Verification → Application Settings: checks configured token
app/security/auth.py - FastAPI Dispatcher → Severity Filter: checks severity
app/main.py - FastAPI Dispatcher → Voice Dispatch Service: requests dispatch
app/main.py - Voice Dispatch Service → Application Settings: reads dispatch settings
app/services/vapi_service.py - Voice Dispatch Service → Simulation Mode: selects simulation
app/services/vapi_service.py - Voice Dispatch Service → Vapi API: requests outbound call
app/services/vapi_service.py - Vapi API → On-Call Engineer: places voice call
README.md - Vapi Assistant → Vapi Tools Endpoint: calls tool webhook
README.md - Vapi Tools Endpoint → Tool Dispatch: dispatches tool calls
app/api/vapi_tools.py - Tool Dispatch → Incident Acknowledgement: handles acknowledge
app/api/vapi_tools.py - Tool Dispatch → Cloud Run Job Service: requests job retry
app/api/vapi_tools.py - Cloud Run Job Service → Application Settings: reads job configuration
app/services/cloud_run_service.py - Cloud Run Job Service → Cloud Run Jobs: starts job execution
app/services/cloud_run_service.py