> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.rydhm.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rydhm.ai/_mcp/server.

# Phone

An expert with a phone number answers every call to it, day and night. It can also call people for you, hand a caller to a person on your team, and leave a voicemail when nobody picks up.

Everyone can see your numbers and calls. Only admins and the owner can get numbers, assign them and place calls. See [Members and roles](/workspace/members).

> **Note**
>
> If **Settings → Phone numbers** says **Phone calls aren't on here yet**, calling isn't available for your workspace yet.

## Get a number

#### Open Phone numbers

Go to **Settings → Phone numbers** and select **Get a number**. If you can also import from Twilio or Telnyx, select **Add a number → Buy a new number**.

#### Search

Enter an **Area code** (for example 415) and, if you like, digits the number should **Contain**. Then select **Search**. Leave the area code empty to search anywhere in the US.

#### Choose who answers

Pick a number. Under **Who answers**, pick an expert or **Decide later**.

#### Get it

Select **Get** (the button shows the number). Setup takes a few seconds. The number shows as **Active** when it's ready.

You can also start from the expert's **Phone** tab. Numbers are **US local numbers**; toll-free numbers can't be bought. A workspace can buy up to **5 numbers** through Rydhm and import up to 50 from your own [Twilio](/channels/byo-twilio) or [Telnyx](/channels/byo-telnyx) account. Numbers beyond your plan's included ones cost \$3 a month in credits, and the Free plan has none. See [Billing](/workspace/billing).

![The expert's Phone tab with a workspace number to give it and Get a number](/_fern-files/_img/88dafc961b87019915ddd921bfeda06938a2fd4d706f152d7440ae778de340a4.webp)![The expert's Phone tab with a workspace number to give it and Get a number](/_fern-files/_img/6937191251057706aa045b83a7d8cd224590cbe151eff677172161379ee7001d.webp)

### Assign or release a number

Each row on **Settings → Phone numbers** has a picker for the expert that answers it. A number with **No expert** isn't answered. An expert can have several numbers, and its oldest active number is its default caller ID.

**Release** gives a bought number up. Calls to it stop right away, and you may not get the same number back. Imported numbers show **Remove from Rydhm** instead and go back to your Twilio or Telnyx account.

## Inbound calls

The assigned expert answers with its usual first message.

* **Callers are anonymous.** The expert uses its knowledge and web search, but not your workspace's other tools. It says it's an AI if asked.
* **Calls last up to 20 minutes**, then the expert says goodbye.
* **Silence:** after 25 seconds it asks "Are you still there?" and hangs up 15 seconds later.
* **Missed calls:** if no expert picks up within a few seconds, the call ends and the **Missed phone calls** [alert](/workspace/alerts) tells your admins.

Calls appear in [Conversations](/quality/conversations), for example "Call from (415) 555-0199", and in **Recent calls** on the expert's **Phone** tab.

## Outbound calls

#### Open the call form

Select **Call** in the expert's header, or go to **Make a call** on its **Phone** tab.

#### Enter the number

Under **Call someone**, type the **Number to call**. If the expert has more than one number, pick which one it **Calls from**.

#### Confirm consent

Tick **This person agreed to get a call from an AI**. The law requires their agreement before an AI calls them.

#### Call

Select **Call**. The live card shows **Ringing…**, then the time **In call**, and **Read the transcript** afterwards.

Use **Call me** to test on your own phone, or **Call back** on a call in Conversations. The phone rings for up to 30 seconds, and the expert opens with: "Hi, this is (expert), an AI assistant calling from (workspace). Is now a good time to talk?" One-off calls are limited to 5 a minute and 20 an hour. To call a list, use [Campaigns](/channels/campaigns).

## Transfer to a person

#### Turn it on

On the expert's **Phone** tab, under **On the phone**, switch on **Transfer to a person**.

#### Set the number and the line

Enter **Their number**: a US phone on your team, not one of your Rydhm numbers. Optionally set **What it says first** (up to 200 characters). The default is "Sure — connecting you to the team now." Then save the expert.

The expert transfers when a caller asks for a person or "someone real", or when it can't help. It's a direct (cold) transfer: the expert says its line and hands the call over, with no introduction to your colleague. If nobody answers within 30 seconds, the caller stays with the expert. It tries at most twice per call.

## Voicemail

Voicemail applies to calls the expert **makes**. On the **Phone** tab, **When voicemail answers** is **Leave a message** (the default) or **Hang up**.

Before speaking, the expert listens for a voicemail greeting or a beep; when unsure, it assumes a person. To leave a message, it waits for the beep and says **The message** (up to 500 characters). The default says who called and asks them to call back on your number. A custom message that doesn't say it's an AI gets "Hi, this is (expert), an AI assistant" added in front.

## Hang up from the app

Admins can end any live call with **Hang up**: on the expert's call card, on the call in **Conversations**, or under **On the phone now** on a campaign. The line drops within seconds.

## US-only dialling

Experts call **US numbers only**. Rydhm refuses:

| Number                                                                                       | Message                                                         | Why                                                                              |
| -------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| 911 and 211–811                                                                              | "Emergency and service numbers (911, 211–811) can't be dialed." | Emergency lines must never get automated calls                                   |
| Area code 900, exchange 976                                                                  | "Premium-rate numbers can't be dialed."                         | They charge the caller                                                           |
| Canada, the Caribbean, Guam, the Northern Marianas, American Samoa, and non-geographic codes | "Only US numbers can be called. That one is outside the US."    | They share +1 but are billed as international, and are common toll-fraud targets |
| 555-0100 to 555-0199                                                                         | "That number is reserved for fiction and can't be dialed."      | They don't exist                                                                 |

Puerto Rico and the US Virgin Islands can be called. Numbers can be typed in any common format, like `(415) 555-0123` or `+1 415 555 0123`. Numbers on your **Do not call** list are refused with "This number asked not to be called."

Phone calls cost \$0.13 a minute, inbound or outbound. See [Billing](/workspace/billing).

## Related

* [Bring your own Twilio](/channels/byo-twilio)
* [Bring your own Telnyx](/channels/byo-telnyx)
* [Campaigns](/channels/campaigns)
* [Conversations](/quality/conversations)