Skip to main content

19 docs tagged with "livekit"

View all tags

Debug a Voice Call Issue

Diagnose voice call problems — wrong responses, routing failures, tools not executing, audio quality issues — using Railway logs, LiveKit Cloud dashboard, and voice_call_logs DB records

Deploy the LiveKit Agents Voice Agent

Deploy updated voice agent code via Railway (git push auto-deploys); LiveKit Cloud connects automatically via the agent worker WebSocket — no manual reconnect step needed

Deploy Voice Agent Code Changes

Full deploy cycle for voice agent code — branch, implement, test locally, push to Railway via git; LiveKit Cloud connects automatically, no manual reconnect step needed

How the Voice Agent Works

End-to-end explanation of the ChurchWiseAI voice agent — body analogy, service map, call flow, and fallback chain

Inbound Call Flow

Complete lifecycle of an inbound church phone call — Twilio SIP trunk, LiveKit Cloud SIP gateway, Railway agent worker, church routing by phone number, agent selection, and post-call DB writes

Infrastructure Reference

Canonical reference for all hosting, domains, environment variables, cron jobs, DNS configuration, voice agent deployment, and monitoring across the ChurchWiseAI portfolio

LiveKit Integration

SIP gateway and room management for the ChurchWiseAI voice agent — LiveKit Cloud provides the telephony bridge between Twilio SIP trunks and the Python agent worker on Railway

LiveKit or Cartesia Outage Response

Respond to a LiveKit Cloud or Cartesia TTS outage that makes the voice agent unavailable — detection, distinguishing the failure point, customer notification, and recovery steps

Rollback a Bad Deployment

Revert a broken production deployment via Vercel instant rollback or git revert — covers all three web apps and the voice agent, with incident communication steps

Voice Agent Architecture

Multi-tenant LiveKit Agents SDK architecture — one deployed agent serves all churches via SIP trunk phone-number routing, with per-church config loaded from Supabase at call init

Voice Agent Fallback Strategy

Resilience and fallback design for the voice agent — LLM, TTS, STT provider fallbacks, routing fallbacks, cache stale recovery, and the planned Telnyx migration from Twilio

Voice Agent Overview

Product overview for the ChurchWiseAI Voice Agent — AI phone receptionist for churches, built on LiveKit Agents SDK, serving all plans from $39.95/mo with Gemini 2.5 Flash as primary LLM

Voice Agent Troubleshooting

Known voice agent issues, debugging procedures, and resolution steps — LiveKit/SIP routing errors, wrong church routing, tool failures, audio quality issues

Voice Agent Troubleshooting Reference

Known issues, root causes, and fixes for LiveKit SIP + Telnyx voice infrastructure. Includes GitHub issue references, auth strategy, and operational rules.

Voice Operations Runbooks

Index of voice ops runbooks — add churches, debug call issues, deploy code changes, handle missed calls, review prayer requests, audit call quality, and respond to platform outages

Voice Pipeline — Complete Call Lifecycle

Definitive step-by-step trace of every function, LLM call, STT/TTS step, database query, and third-party service call from SIP arrival to call termination. Required reading before touching any voice code.