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

# Agent Phone

> Let your Agents call you when a task needs you, call people and Enconvo friends for you, and answer the calls you miss.

Agent Phone lets your Agents use the phone. An Agent can call you when a task waits for your input, call a person or a business you name in a chat, call your Enconvo friends and teammates for you, and answer calls to your iPhone that you don't pick up. Every call's transcript comes back to the chat.

## Before you start

Open **Settings → Agent Phone** and set up at least one way to call:

| Way | What it does | Cost |
| - | - | - |
| **Your iPhone** | This Mac places and answers calls on your iPhone, from your own number, while your iPhone is nearby. Needed for **Answer my calls**. | Free with your phone plan. |
| **Phone providers** | Agents call from a number on your own Twilio or Telnyx account. | The provider bills each call. |
| **EnConvo mobile app** | Agents ring the EnConvo app on your phone like a phone call. Answering starts [Live Talk](https://docs.enconvo.ai/features/live-voice.md). On Android, answering from the ring notification or the lock screen connects without unlocking or opening the app. Only for calls to you. | Free over Wi-Fi or mobile data. |

## Set up Your iPhone

1. Under **Your iPhone**, click **Set up**. A picture-led guide walks you through one step at a time and opens the right place for each.
2. Turn on Enconvo in **System Settings → Privacy & Security → Accessibility**, so Enconvo can press Call and End in macOS's call prompt.
3. Turn on **Calls from iPhone** in **FaceTime → Settings → General**.
4. Turn on **Allow notifications** and **Desktop** for Phone and for FaceTime in **System Settings → Notifications**. macOS shows each call as a notification.
5. Check that your iPhone and this Mac use the same Apple Account. On the iPhone, open **Settings → Apps → Phone → Calls on Other Devices** and allow this Mac.
6. Keep your iPhone near this Mac, on the same Wi-Fi.
7. Click **Add Enconvo Audio** and type your Mac login password when macOS asks. Enconvo Audio carries your Agent's voice into the call and the other person's voice back, without using your microphone or speakers.
8. Click **Check the audio**. It plays a short tone through Enconvo Audio and listens for it; nothing rings.

When it says **Ready**, Agents call from your iPhone's number, and the people they call see your number. While your iPhone isn't nearby, a phone provider calls instead if you set one up.

## Set up a phone provider

1. Under **Phone providers**, click **Set up** or **Connect** beside Twilio or Telnyx. Enconvo adds the plugin and asks for your sign-in or API key.
2. Choose the number calls come from in **Calls come from**.
3. Click **Test call** to try it.

Agents use the default provider, and another one only when you ask in a chat or the default can't place calls. Telnyx calls go through a TeXML application named Enconvo Agent Phone, which Enconvo adds to your account. A Twilio trial account calls only numbers you verified in Twilio.

Calls through Twilio and Telnyx can press keypad keys, so an Agent gets through automated phone menus and extensions. Calls through Your iPhone can too.

## Get calls when a task needs you

Under **Agent call settings → Tasks awaiting your input**, choose how an Agent reaches you while you're away from your Mac:

1. The EnConvo mobile app rings at once, when it's paired.
2. If that goes unanswered, your phone number is called. Set the number and choose **Calls from**: **Your iPhone**, Twilio, or Telnyx.

The call rings with the Agent's name. Pending requests in the same chat are grouped into one call, and a call you decline isn't tried again. **Notification delay** sets how long a task waits before you hear about it. **Include task details** reads the task aloud on phone-number calls; with it off, only the chat title is announced and approvals can't be given over the phone.

You can also ask an Agent in a chat to call you, through the app, Your iPhone, Twilio, or Telnyx. Calls you ask for ring every time.

## Have an Agent call someone

1. Turn on **Outbound calls on your behalf** under **Agent call settings**.
2. In a chat, ask the Agent to call a person or business, and say what the call is for.
3. A call card shows the number and what the call will say. Click **Place call**. In a chat that runs at Full access, the Agent dials without waiting.
4. Follow the call on the card, or click **End call**. When it ends, a result card shows what each side said.

If no phone line is set up, the call card lets you set up Your iPhone or Telnyx right in the chat, and the call goes through once it's ready.

## Have an Agent call a friend

Ask an Agent to call an Enconvo [friend](https://docs.enconvo.ai/features/friends.md) or teammate and tell it what to say. It rings their Enconvo apps first, talks with them for you, and brings their answer and the call's transcript back to your chat. It calls their phone number only when you ask for a phone call or the Enconvo call doesn't reach them.

Agents reach only your friends and teammates, never people you met only on a call. A scheduled task can message and call the friends you let it reach. For example, it can send someone a report at midnight and call them in the morning if they haven't replied.

## Record calls

Turn on **Record calls** to save every Agent call, to you or to other people, in the phone apps or to a phone number, to [Recordings](https://docs.enconvo.ai/features/meeting-recording.md) on this Mac with its transcript. Each recorded call in **Recent calls** has a recording button. A friend your Agent calls hears and sees that the call is recorded, and no recording is kept if they say they don't want one.

> [!WARNING]
>
> Some places require everyone on a call to agree before it is recorded. Make sure you may record the people your Agents call.

## Let an Agent answer your missed calls

**Answer my calls** needs Your iPhone. When you don't pick up a call to your iPhone, an Agent answers it on your Mac, takes a message, and sends the summary and transcript to Updates.

1. Under **Your iPhone**, turn on **Answer my calls**. Allow Contacts when asked, so Enconvo recognizes callers saved in Contacts.
2. Choose **When you don't pick up**: after a few rings, 5 seconds by default.
3. Choose which calls it answers: **Numbers not in Contacts** or **Everyone**. **During quiet hours, answer at once** skips the wait during the quiet hours set in Notifications.
4. In **What it may say**, write who it answers as and what it may tell callers. It takes a message and never agrees to anything for you.
5. With several Macs, choose the one that **Answers first**. Your other Macs answer only when it's offline.

After each call, your phone gets a notification with who called, what they want in one sentence, and whether it's urgent. Urgent calls break through Focus. The notification has **Call back** and **Open**. Calls that look like scams carry a **Likely scam** badge and a warning.

A caller can't make your Agent act. On the call it only talks and takes a message, with no tools, chats, memory, or files. The summary is written without tools. In the call's chat, nothing runs until you reply, and actions that send, pay, delete, or run commands ask you first, even with Full access. **What a caller can reach** in Settings shows these limits.

### Numbers that can give tasks

Add your own other numbers under **Numbers that can give tasks**. Calls from them talk to your Agent and can give it tasks; everyone else only leaves a message. Because a faked caller ID can pass for one of these numbers, turn on **Ask for a passphrase**: until the caller says it, the call only takes a message.

## Review calls

The **Calls** section in the Chat Window sidebar keeps the calls your Agent answered apart from your other chats. It marks calls that are urgent, want a call back, or are still unread, and shows when each call rang and the caller's number or contact name. Click **Call back**, or **Mark as done**. The same section is in the iPhone and Android apps.

**Recent calls** at the bottom of **Settings → Agent Phone** lists every call Agents placed or answered, with its result.

## Settings

| Setting | What it changes |
| - | - |
| **Your iPhone** | Calls from your own iPhone number through this Mac, and **Answer my calls**. |
| **Phone providers** | Twilio and Telnyx accounts, the default provider, and **Calls come from**. |
| **Ring the EnConvo app** | Lets Agents ring your paired phones. **Pair a phone** adds one. |
| **Tasks awaiting your input** | How Agents reach you when a task waits: the app, then your number, with **Calls from**, **Notification delay**, and **Include task details**. |
| **Outbound calls on your behalf** | Lets Agents call people you name in a chat. |
| **Record calls** | Saves Agent calls and their transcripts to Recordings. |
| **Answer my calls** | An Agent answers calls to your iPhone that you don't pick up. |

## Troubleshooting

| Problem | What to do |
| - | - |
| **Enconvo Audio is missing** | A macOS update can remove it. Click **Add again** and type your Mac login password in the window macOS shows; it may be behind other windows. |
| **Accessibility is off** | Turn on Enconvo in **System Settings → Privacy & Security → Accessibility**. |
| **Can't hear calls** | Allow Enconvo under **System Audio Recording Only** in **System Settings → Privacy & Security → Screen & System Audio Recording**, then click **Check the audio**. |
| **Notifications are off** | Turn on **Allow notifications** and **Desktop** for Phone and FaceTime. Until then, calls go through your phone provider. |
| **Your iPhone isn't nearby** | Bring it near this Mac on the same Wi-Fi. Until then, calls go through your phone provider. |
| A Twilio call doesn't go through | A trial account calls only verified numbers. Verify the number in Twilio, or upgrade the account. |
| **Answer my calls** doesn't recognize a contact | Allow Contacts for Enconvo, or let a Mac that can read Contacts answer first. |

## Related

> [card] [Live Talk](https://docs.enconvo.ai/features/live-voice.md)
>
> Talk with your Agent in a voice call.

> [card] [iPhone app](https://docs.enconvo.ai/integrations/iphone-app.md)
>
> Pair your phone so Agents can ring it.

> [card] [Video Conference](https://docs.enconvo.ai/features/video-conference.md)
>
> Call friends and teammates yourself.

> [card] [Meeting Recording](https://docs.enconvo.ai/features/meeting-recording.md)
>
> Find recorded calls and transcripts.


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