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

# FaceTime Audio Calling

> FaceTime Audio calls from your iMessage lines: call placing, recordings, AI transcripts, the 40-numbers-a-day limit, and the upcoming FaceTime API.

FaceTime Audio calls go out from the **same Apple identity that texts the lead**. There is no carrier in the path, so no STIR/SHAKEN attestation and no "Potential spam" label. FaceTime Audio is a **\$100/mo per line** add-on ([Calling & Add-ons](https://docs.tuco.ai/features/calling-add-ons.md)).

## Call placing

Calls start from a conversation in the **Unibox** (call button → **FaceTime Audio Call**). The rep talks and listens in the browser; the lead's phone rings as a normal FaceTime Audio call.

| | |
| - | - |
| **Who you can call** | Any phone number or Apple ID email that has FaceTime. Numbers are matched in E.164, emails case-insensitively. |
| **Line** | The conversation's line if it has FaceTime Audio. Otherwise the rep picks a line in **Call from**. |
| **Concurrency** | One call per line. A second rep on the same line gets `This line is in use by a teammate.` A line held by a crashed call frees itself after 30 minutes. |
| **States** | `ringing` → `connected` → `ended`. Unanswered and failed calls end without connecting. |
| **Daily limit** | Checked before every dial. See [Daily limit](#daily-limit). |
| **Conversation entry** | `FaceTime call · 2m 14s` (answered) or `FaceTime call · no answer`. |
| **CRM** | Logged as a call on the HubSpot contact when HubSpot is connected, including unanswered and failed attempts. |

## Recording

* **Answered calls only.** Both sides are recorded on our side and uploaded when the call ends, even if the rep closed the browser tab.
* **Format:** MP3, mono, both sides mixed into one channel.
* **Storage:** private storage, linked from the call entry in the conversation and from the HubSpot call record.
* The call's duration comes from the recording.

## Transcript and summary

Every answered call with a recording is transcribed by AI and summarized in 1–2 sentences.

| | |
| - | - |
| **When** | Answered calls of **10 seconds or longer** with a recording. Shorter or unanswered calls are skipped and charged nothing. |
| **Where it shows** | Saved on the call. Added to the HubSpot call record, and as a note on the GoHighLevel contact when GHL is connected. |
| **Cost** | AI credits from the same balance as the copywriter, about 1 credit per 1,000 tokens (minimum 1 per call). With no credits left, the transcript is skipped and the call is not affected. |
| **On by default** | Email [support@tuco.ai](mailto:support@tuco.ai) to turn transcripts off for your workspace. |

## Daily limit

Each FaceTime line can connect with **40 different numbers per day**.

| Rule | Detail |
| - | - |
| **What counts** | A number counts once its call is **answered**. Unanswered and failed calls never use a slot. |
| **Repeats** | A number the line already reached today is free, even at 40/40. Each number counts once a day, however many times it's called. |
| **Reset** | Midnight in the workspace's timezone (the same reset as message limits). Then every number counts fresh. |
| **Scope** | Per line. More FaceTime lines = more slots. |
| **Timezone change** | Changing the workspace timezone mid-day doesn't give a line a fresh 40. |
| **Regular calls** | Not limited. |

**Where the count shows:** a `12/40 FaceTime` chip on the **Lines** page (amber at 80%, red when full), `12/40 new numbers today` in the **Call from** picker, and `facetimeUsage` on FaceTime lines in [Get All Lines](https://docs.tuco.ai/api-reference/endpoint/get-lines.md):

```json theme={null}
"facetimeUsage": {
  "used": 12,
  "limit": 40,
  "remaining": 28,
  "resetsAt": "2026-11-21T05:00:00.000Z"
}
```

**When a line is full**, a dial to a new number is refused before anything rings, and the line is freed straight away. The call window shows:

> This line has connected with 40 different numbers on FaceTime today. You can still call numbers it already reached today.

The server response for that dial is HTTP `429`:

```json theme={null}
{
  "error": "facetime_daily_limit",
  "message": "This line has connected with 40 different numbers on FaceTime today. You can still call numbers it already reached today.",
  "used": 40,
  "limit": 40,
  "resetsAt": "2026-11-21T05:00:00.000Z"
}
```

## FaceTime API (upcoming)

> [!NOTE]
>
> **Coming soon.** FaceTime calls are placed from the Tuco app today. This API is in development; endpoints and fields may change before release. Email [support@tuco.ai](mailto:support@tuco.ai) for early access.

Use your FaceTime lines from your own product, with your workspace API key (`Authorization: Bearer tuco_...`):

| Capability | What you'll be able to do |
| - | - |
| **Place a call** | Dial a phone number or Apple ID email from any FaceTime line in your workspace. Same rules as the app: one call per line, 40-numbers-a-day limit, `429 facetime_daily_limit` when full. |
| **End a call** | Hang up a live call by its call ID. |
| **Audio streaming** | Stream call audio both ways to your own frontend: your web app, dialer, or softphone. Build your own call UI instead of the Tuco call window. |
| **Call events** | `ringing`, `answered`, `ended` as webhooks, so your CRM or workflow can react live. |
| **Recordings** | Fetch the MP3 recording of any answered call. |
| **Transcripts** | Fetch the transcript and summary of a call. |
| **Call history** | List FaceTime calls by line, lead, or date. |
| **Usage** | Today's per-line count, already live as `facetimeUsage` in [Get All Lines](https://docs.tuco.ai/api-reference/endpoint/get-lines.md). |

> [!NOTE]
>
> Until then, FaceTime calls don't appear in [Place a Call](https://docs.tuco.ai/api-reference/endpoint/place-call.md) or [Recordings](https://docs.tuco.ai/api-reference/endpoint/list-recordings.md). Those endpoints cover regular calls only.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.