Setup
LiveKit Cloud
LiveKit Cloud supplies the media (SIP bridge + WebRTC) in v1. A self-hosted SFU is a later milestone.
1. Project + keys
- Sign up at cloud.livekit.io.
- Create a project.
- From Settings → Keys, copy these values into
.env:LIVEKIT_URL—wss://<project>-<region>.livekit.cloudLIVEKIT_API_KEYLIVEKIT_API_SECRET
2. SIP inbound trunk
- SIP → Inbound Trunks → Create.
- Allow calls from your Twilio SIP trunk. Use the IP/user auth that matches your Twilio configuration.
- Add a Dispatch Rule that routes incoming calls to a per-call
individualroom.
3. Voicebot worker
Run docker compose up voicebot. At startup, the worker registers with LiveKit as a dispatchable agent. The Hail API dispatches it into a room for each call.
For the full flow, refer to Architecture.
Twilio
You need a Twilio account, a phone number, and a SIP trunk that bridges to LiveKit Cloud.
AWS SES (email)
Outbound and inbound email go through Amazon SES (SESv2 API). You need an AWS account and the SES service enabled in one region. You also need IAM-role credentials (recommended for EC2/ECS/EKS deployments) or a long-lived access key.