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

# Phone trees and closed hours

> Menus callers hear (press 1 for sales), what a number does when you're closed, and where a call goes when nobody answers.

## Overview

A **phone tree** is a menu callers hear before anyone rings: "press 1 for sales, 2 for
support". Trees are shared. You build one under **Settings → Phone & SMS → Phone trees**, and
any of your numbers can send calls to it.

A number reaches a tree in three ways:

| Where | Set on |
| - | - |
| **Every call**, as a routing rule | The number's routing rules (**Send to a Phone Tree**) |
| **When you're closed** | The number's closed-hours answer (**A phone tree**) |
| **If nobody answers** a routing rule | The rule's **If nobody answers** (**Send to a phone tree**) |

Phone trees answer calls only. A text to the same number skips a phone-tree rule and falls to
the next one.

![Phone & SMS → Phone trees: start from a ready-made menu or a blank one.](https://docs.custral.com/images/screens/comms/phone-trees-light.png)

Phone & SMS → Phone trees: start from a ready-made menu or a blank one.

## Build a phone tree

**1. Start one**

Open **Settings → Phone & SMS → Phone trees** and press **New phone tree**. Your first time, pick a starter:
**Sales or support**, **After hours** or **Departments**, describe it to Stella, or press **Start from blank**.
Nothing reaches callers until you use the tree on a number.

**2. 1. What callers hear**

Choose **Read aloud** and write the greeting (**Write it from my keys** drafts it from the keys below), or **Play a
recording**.

**3. 2. Keys**

Add a row per key: 1–9, 0, `*` or `#`. Name it under **For** and choose where it **Goes to** (see the table below).

**4. 3. If nobody presses a key**

Set how long to wait (3–15 seconds, default 5), how many times to repeat the menu (no times, once or twice), and
what happens after (default: take a voicemail). A wrong key plays "Sorry, that isn't an option." and repeats the
menu, so nobody is held in a menu forever.

**5. Check and save**

**What a caller gets** previews the call. Save the tree.

**6. Use it on a number**

Press **Use on a number**, pick the **Number**, and choose **When you're closed** (replaces the closed message on
that number) or **Every call** (adds a routing rule at the top). Press **Use on this number**.

| Goes to | What happens |
| - | - |
| **Ring a team** | Rings the team **All at once** or **One at a time** |
| **Ring a person** | Rings one teammate |
| **Open another menu** | Plays another phone tree, up to three menus deep |
| **Forward to a number** | Forwards the call to an outside number |
| **Take a voicemail** | Records a message |
| **End the call** | Hangs up |

The tree's **Used by** list names every number and situation that sends calls to it. A save
changes all of them. A call that can't go where a key says (a team with nobody available, a
person who left, a deleted menu) reaches a voicemail rather than a dead line.

## When you're closed

Each number can answer differently outside your workspace hours. Open the number's routing
(**Settings → Channels**, the number, the **Routing** tab) and find **When you're closed**.

* **Answer differently when you're closed** switches it on. It applies outside workspace hours
  and on closed dates. A routing rule that matches first still runs.
* **Callers hear**: **Read this message**, **Play a recording** or **A phone tree**.
* **Then**: **Take a voicemail** or **End the call** (not shown when a phone tree answers).
* **Texts while closed**: **Reply with the message** or **Don't reply**. A text reply goes once
  per person, until you open again.

### Workspace hours and closed dates

Workspace hours come from **Settings → Workspace → General**, under **Working Hours** (**Working Days**,
**Starts At**, **Ends At**). On the same page, **Closed dates** lists days the whole workspace
is closed: pick a **Date**, give it a **Name** (for example "Company offsite") and press **Add
date**, or **Add US holidays for the next 12 months**. On a closed date, every number answers as
closed all day, and rules on workspace hours skip it.

## If nobody answers

A routing rule that offers a call (**How it reaches them: Ask**) has its own ring settings:

* **Reach them**: **All at once** or **One at a time**.
* **Give each one**: 5–120 seconds (20 by default).
* **If nobody answers** (phone numbers only): **Try the next rule**, **Take a voicemail**, **End
  the call** or **Send to a phone tree**. Left empty, the number's own setting applies: forward,
  or voicemail.

For the rest of a routing rule (who it assigns, when it applies), see
[Routing](https://docs.custral.com/comms/inbox/routing.md).

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| Callers never hear the menu | The tree isn't used on that number | The tree's **Used by** list is empty ("Nothing sends calls here yet."). Use **Use on a number**. |
| A text got no menu | Phone trees answer calls only | Expected. Texts skip a phone-tree rule. |
| "That would make a loop" | A key opens a menu that leads back to this one | Point that option somewhere else. |
| "Too many menus deep" | More than three levels | Phone trees go three menus deep at most: a menu, a submenu, and one more. |
| "Two options use the same key." / "Finish every option's choice." | The keys aren't complete | Give each row its own key and a **Goes to**. |
| **Delete** is greyed out, or "This phone tree is in use" | A number, rule or another tree still sends calls here | Remove it from the places under **Used by** first. |
| "Pick a phone tree, or callers hear the message instead." | **A phone tree** is chosen for closed hours with no tree | Pick one in the closed-hours section. |
| Calls at night aren't answered as closed | Workspace hours, or the switch | Check **Working Hours** in Settings → Workspace → General and that **Answer differently when you're closed** is on. |
| You can see the settings but not change them | Phone settings are admin-only | "Only workspace admins can change phone settings." |

> [!NOTE]
>
> When reporting an issue, include the request id shown in the error toast. It links the in-app error to the server
> logs.

## Related

> [card] [Phone & SMS numbers](https://docs.custral.com/comms/voice/numbers.md)
>
> The numbers a tree answers for.

> [card] [Routing](https://docs.custral.com/comms/inbox/routing.md)
>
> Rules that decide who a call or text reaches.

> [card] [Voicemail](https://docs.custral.com/comms/voice/voicemail.md)
>
> Where "Take a voicemail" lands.

> [card] [Receiving SMS](https://docs.custral.com/comms/sms/receiving.md)
>
> The closed-hours text reply.


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