> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trychert.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FaceTime

> Connect your agent to real FaceTime calls.

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.

<CardGroup cols={2}>
  <Card title="Bring Your Own Room" icon="video" href="/facetime/bring-your-own-room">
    Connect your LiveKit agent to a FaceTime line.
  </Card>

  <Card title="Quickstart" icon="bolt" href="/facetime/quickstart">
    Prepare your line and room for inbound or outbound calls.
  </Card>

  <Card title="Outbound" icon="phone" href="/facetime/outbound">
    Start a FaceTime Audio call from your backend.
  </Card>

  <Card title="Authentication" icon="key" href="/facetime/authentication">
    Create a project key and authenticate server requests.
  </Card>

  <Card title="Audio and video" icon="camera" href="/facetime/audio-video">
    Understand current media support and acceptance requirements.
  </Card>
</CardGroup>

## 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.

<Note>
  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.
</Note>

<a id="fail-closed" />

## 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](/facetime/outbound).

Outbound currently supports audio only on enabled lines.

## Other integration models

[Managed Assistants](/facetime/assistants) run Chert-managed agent behavior. [Hosted Sessions](/facetime/hosted-sessions) describes a proposed model and is not the current customer-controlled integration.

<Note>
  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.
</Note>