Skip to main content
Chert connects a provisioned FaceTime line to your agent. With Bring Your Own Room (BYOR), your backend creates a LiveKit room and grants Chert’s bridge call-scoped access. You own the agent, room, and conversation.

Bring Your Own Room

Connect your LiveKit agent to a FaceTime line.

Quickstart

Prepare your line and room for inbound or outbound calls.

Outbound

Start a FaceTime Audio call from your backend.

Authentication

Create a project key and authenticate server requests.

Audio and video

Understand current media support and acceptance requirements.

​
Receive a call

  1. A caller rings your provisioned FaceTime handle.
  2. Chert asks your backend to accept or decline.
  3. You return a short-lived token for your LiveKit room.
  4. Chert joins the room and bridges the call to your agent.
  5. When the call ends, both services clean up their resources.
BYOR supports two-way audio and video. Your agent receives the caller’s microphone and camera as LiveKit tracks, while the caller sees and hears your agent in FaceTime.

​
Designed to fail closed

Readiness checks gate call acceptance. A missing, late, or invalid acceptance response declines the call. Monitor call state, media tracks, and terminal reasons throughout the call.

​
Place a call

Prepare your LiveKit room and silent agent, then send a project-authenticated request with the line ID and recipient to POST /api/v1/calls. Chert dials from that line and bridges audio after answer. Start the greeting only on bridge_ready or the corresponding outbound call.started notification. See Outbound. Outbound currently supports audio only on enabled lines.

​
Other integration models

Managed Assistants run Chert-managed agent behavior. Hosted Sessions describes a proposed model and is not the current customer-controlled integration.
The FaceTime API uses https://facetime.trychert.com/api and FaceTime project credentials. The Messaging API elsewhere on this documentation site has a separate API contract.