.env.example.
Required for live calls
Convex - backend, database, auth, and HTTP endpoints
Convex - backend, database, auth, and HTTP endpoints
Convex stores business data, call records, contacts, appointments, knowledge, billing state, and app settings. It also runs backend functions and HTTP endpoints used by Twilio, the voice gateway, calendar callbacks, and downloads.Configure
CONVEX_URL, CONVEX_SITE_URL, and matching VITE_ variables for the web dashboard.Twilio - phone numbers, voice, SMS, and verification
Twilio - phone numbers, voice, SMS, and verification
Twilio provides phone numbers, inbound voice webhooks, Media Streams, SMS delivery, and phone verification.Live voice requires a Twilio number with its voice webhook pointing at the voice gateway. Onboarding phone verification requires
TWILIO_VERIFY_SERVICE_SID.OpenAI - Realtime voice
OpenAI - Realtime voice
OpenAI powers live voice conversations through the Realtime API. Configure
OPENAI_API_KEY on the voice gateway.You pay OpenAI directly for self-hosted usage.Voice gateway hosting
Voice gateway hosting
The voice gateway is a Node.js service with a public HTTPS URL. Twilio must be able to reach it for inbound calls and media streams.The existing deployment docs use Fly.io as one supported hosting option.
Optional providers
Google Calendar
Google Calendar
Google Calendar enables calendar availability and booking sync. Configure Google OAuth variables and
SESSION_ENCRYPTION_KEY.Firecrawl
Firecrawl
Firecrawl powers website knowledge import. Without it, operators can still add text entries and upload documents.
Google Gemini
Google Gemini
Gemini is used for embeddings and non-realtime text generation in knowledge and SMS flows.
Resend
Resend
Resend sends password reset and email-change emails. Without email delivery, those auth flows will not work correctly in production.
Polar
Polar
Polar powers hosted subscription billing, checkout, customer portal access, product mapping, transactions, and usage sync. Single-business self-host deployments usually do not need Polar.
PostHog
PostHog
PostHog is used for analytics and telemetry when configured.