> For the complete documentation index, see [llms.txt](https://distance.gitbook.io/distance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://distance.gitbook.io/distance/getting-started/call-forwarding/forwarding-calls-from-grasshopper-to-distance.md).

# Forwarding calls from Grasshopper to Distance

Set up call forwarding from Grasshopper to Distance for overflow backup, after-hours coverage, or as your virtual receptionist.

### **Introduction**

Forwarding calls from Grasshopper routes incoming calls to your Distance number, allowing your **AI Voice** agent to answer calls on your behalf. Calls are logged in Distance with conversation transcripts and automatically create tickets.

Choose the forwarding option that best fits your business, whether you want your **AI Voice** agent to answer all calls, after-hours calls, or serve as a backup during business hours.

***

### **Forward overflow and missed calls**

Use this configuration to forward calls to your **AI Voice** agent only when your team does not answer within the configured ring time, serving as a backup for missed calls.

From the home page, select **Call management**, then click **Extensions**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Fvb8wLMTTGhBaf6FtNUzU%2Fimage.png?alt=media&amp;token=f00f62df-120f-476c-baa7-bd2e5f730f58" alt=""><figcaption></figcaption></figure></div>

Click the **pencil** icon next to the extension you want to configure. If this is your first time configuring call forwarding, only **Default Extension (#0)** is available.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FRASBUA3KVM0wb49rPtS8%2FScreenshot_1.jpg?alt=media&amp;token=6fb82b59-caec-4ec0-80ef-4d8010b13876" alt=""><figcaption></figcaption></figure></div>

Under the **Call forwarding numbers** section, click **Add call forwarding**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FPKISvMiZxfUXFJrB3y8a%2Fimage.png?alt=media&amp;token=b3d8f60e-dfbb-4c10-8aff-6a7d4a77e75a" alt=""><figcaption></figcaption></figure></div>

In the **Add new call forwarding destination** window:

* Enter your Distance phone number, and leave **Status** set to **Active**. Optionally, enter a label in the **Description** field to help identify the number.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FdAKRSeqg8AkTTCH3pN0J%2Fimage.png?alt=media&amp;token=ad10cc72-70e0-4baf-aa5d-60e154f5f241" alt=""><figcaption></figcaption></figure></div>

* Under **Working hours**, select **24/7**, **Mon - Fri: 9AM - 5PM**, **Sat - Sun: 9AM - 5PM**, or **Custom schedule**. The selected hours must fall within both the account **Business hours** and the extension's **Office hours** to receive calls.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FfMgyAOymqI0IwXWEdQQa%2Fimage.png?alt=media&amp;token=dfada346-adbe-41cd-9f94-be922d2e875c" alt=""><figcaption></figcaption></figure></div>

* If you select **Custom schedule**, select the days and click **Add hours** to configure your preferred schedule.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Fdzy64tcAwHDXxvgYalmB%2Fimage.png?alt=media&amp;token=1ac898a9-de32-4bf2-93d6-008a7ae27db5" alt=""><figcaption></figcaption></figure></div>

* Under **Call handling**, select **Calls will connect as soon as you pick up**, which immediately connects forwarded calls without prompts or announcements. Click **Save** once done.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Ft2vyvNCMjQNti6PRJema%2Fimage.png?alt=media&amp;token=588099d3-8c33-4cb3-917e-f1964b0afb60" alt=""><figcaption></figcaption></figure></div>

The number is added to the **Call forwarding numbers** section.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FmX32tgt60imB2uFlVCoB%2FScreenshot_2.jpg?alt=media&amp;token=b124478e-d9c4-45d5-bdbc-ec646c9fa0ad" alt=""><figcaption></figcaption></figure></div>

To configure the number of rings before forwarding, click the **pencil** icon next to the call forwarding number, then select a value from the **Ring duration** dropdown.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FW97qetu7gKU3hfYpAl6V%2FScreenshot_3.jpg?alt=media&amp;token=d9bdc55f-a998-4c14-9ad5-2542dc1e48b0" alt=""><figcaption></figcaption></figure></div>

**Ring duration** is only available after the call forwarding number has been saved and can be set from **20 seconds** to **25 seconds**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FOEG3cHIW1OYGRf5PflIv%2Fimage.png?alt=media&amp;token=c6374149-4e69-44f6-a526-0d07c45afec9" alt=""><figcaption></figcaption></figure></div>

If your workflow requires calls to ring multiple team members before reaching AI Voice, click **Add call forwarding** again to add additional numbers. After adding them, drag the numbers using the **three horizontal lines** to arrange the desired ringing order.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FFGdRwqCJDAivnxT2dPyN%2FScreenshot_4.jpg?alt=media&amp;token=04b873b8-d1d9-4875-81c0-7fd88ef2ca66" alt=""><figcaption></figcaption></figure></div>

Above the **Call forwarding numbers** section, select **Ring in specific order**. Calls will ring each number according to the displayed order before routing to your AI Voice agent.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Fw57Pe31oLchkcWuaXG8U%2Fimage.png?alt=media&amp;token=81cff592-5bfa-416f-ac2c-c4037638feb2" alt=""><figcaption></figcaption></figure></div>

The default settings under the **Preferences** and **Extension office hours sections** do not need to be changed for this setup.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FSFuAgAs0RuUoyRZ1DadT%2Fimage.png?alt=media&amp;token=939c3d13-fa4f-4764-9b31-7916c66cdb56" alt=""><figcaption></figcaption></figure></div>

The **Working hours** configured for the call forwarding destination determines when calls are forwarded to your Distance number.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FpKq2xi2mQNp0sJZGO5Cg%2Fimage.png?alt=media&amp;token=d39597e9-03f0-4736-8b6d-0416e9a7ee21" alt=""><figcaption></figcaption></figure></div>

Click **Save** to apply the changes to the extension.

***

### **Forward after-hours calls**

Use this configuration to forward calls to your **AI Voice** agent only during your after-hours while continuing to handle calls normally during business hours.

From the home page, select **Call management**, then click **Extensions**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Fvb8wLMTTGhBaf6FtNUzU%2Fimage.png?alt=media&amp;token=f00f62df-120f-476c-baa7-bd2e5f730f58" alt=""><figcaption></figcaption></figure></div>

Click the **pencil** icon next to the extension you want to configure. If this is your first time configuring call forwarding, only **Default Extension (#0)** is available.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FRASBUA3KVM0wb49rPtS8%2FScreenshot_1.jpg?alt=media&amp;token=6fb82b59-caec-4ec0-80ef-4d8010b13876" alt=""><figcaption></figcaption></figure></div>

Under the **Call forwarding numbers** section, click **Add call forwarding**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FPKISvMiZxfUXFJrB3y8a%2Fimage.png?alt=media&amp;token=b3d8f60e-dfbb-4c10-8aff-6a7d4a77e75a" alt=""><figcaption></figcaption></figure></div>

In the **Add new call forwarding destination** window:

* Enter your Distance phone number, and leave **Status** set to **Active**. Optionally, enter a label in the **Description** field to help identify the number.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FdAKRSeqg8AkTTCH3pN0J%2Fimage.png?alt=media&amp;token=ad10cc72-70e0-4baf-aa5d-60e154f5f241" alt=""><figcaption></figcaption></figure></div>

* Under **Working hours**, select **Custom schedule**, select the days and click **Add hours** to configure your after-hours schedule.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FVHKqx5TNnyoE5sbzm2dZ%2Fimage.png?alt=media&amp;token=286b8696-5810-43a0-a160-c2b08a7e97f6" alt=""><figcaption></figcaption></figure></div>

* Under **Call handling**, select **Calls will connect as soon as you pick up**, which immediately connects forwarded calls without prompts or announcements. Click **Save** once done.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Ft2vyvNCMjQNti6PRJema%2Fimage.png?alt=media&amp;token=588099d3-8c33-4cb3-917e-f1964b0afb60" alt=""><figcaption></figcaption></figure></div>

The number is then added to the **Call forwarding numbers** section.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FLfCKKHQt7uvWGs3A0l5M%2Fimage.png?alt=media&amp;token=f1616d6a-f670-48be-ae8a-1870f8e69ebe" alt=""><figcaption></figcaption></figure></div>

To configure the number of rings before forwarding, click the **pencil** icon next to the call forwarding number, then select a value from the **Ring duration** dropdown.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FDleCB98VC2Z50TD8w8Tk%2Fimage.png?alt=media&amp;token=001dc894-cc85-4705-b789-0a70f894d8d3" alt=""><figcaption></figcaption></figure></div>

**Ring duration** is only available after the call forwarding number has been saved and can be set from **20 seconds** to **25 seconds**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2F5ZWeuZCfNRk7k8W4MwX1%2Fimage.png?alt=media&amp;token=82d552fa-0a1b-4cb1-b0e5-813e2b812d02" alt=""><figcaption></figcaption></figure></div>

Now that your Distance phone number is configured with an after-hours schedule, configure your main phone number with a business hours schedule so calls are routed to your team only during business hours.

Under the **Call forwarding numbers** section, click the **pencil** icon next to your primary number.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FjUkdVSCKsF66fytsKfGx%2FScreenshot_5.jpg?alt=media&amp;token=dd8e5aee-06e9-4b1c-b475-084f50823229" alt=""><figcaption></figcaption></figure></div>

Under **Working hours**, select **Mon - Fri: 9AM - 5PM** or **Custom schedule** if your business hours differ.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Fy7Zw664daIWAkqyaQ0Af%2Fimage.png?alt=media&amp;token=33bb8c28-00c9-4e47-ba80-e4a9314cc271" alt=""><figcaption></figcaption></figure></div>

Configure the remaining settings as described above, then click **Save**.

***

### **Forward all calls**

Use this configuration to make your **AI Voice** agent your virtual receptionist by routing all incoming calls directly to it.

From the home page, select **Call management**, then click **Extensions**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Fvb8wLMTTGhBaf6FtNUzU%2Fimage.png?alt=media&amp;token=f00f62df-120f-476c-baa7-bd2e5f730f58" alt=""><figcaption></figcaption></figure></div>

Click the **pencil** icon next to the extension you want to configure. If this is your first time configuring call forwarding, only **Default Extension (#0)** is available.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FRASBUA3KVM0wb49rPtS8%2FScreenshot_1.jpg?alt=media&amp;token=6fb82b59-caec-4ec0-80ef-4d8010b13876" alt=""><figcaption></figcaption></figure></div>

Under the **Call forwarding numbers** section, click **Add call forwarding**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FPKISvMiZxfUXFJrB3y8a%2Fimage.png?alt=media&amp;token=b3d8f60e-dfbb-4c10-8aff-6a7d4a77e75a" alt=""><figcaption></figcaption></figure></div>

In the **Add new call forwarding destination** window:

* Enter your Distance phone number, and leave **Status** set to **Active**. Optionally, enter a label in the **Description** field to help identify the number.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FdAKRSeqg8AkTTCH3pN0J%2Fimage.png?alt=media&amp;token=ad10cc72-70e0-4baf-aa5d-60e154f5f241" alt=""><figcaption></figcaption></figure></div>

* Under **Working hours**, select **24/7**.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2F5RKGPXGdqMHcCxfgcy4t%2Fimage.png?alt=media&amp;token=79462f37-ce48-48ce-bd6c-78ffe04b212e" alt=""><figcaption></figcaption></figure></div>

* Under **Call handling**, select **Calls will connect as soon as you pick up**, which immediately connects forwarded calls without prompts or announcements. Click **Save** once done.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2Ft2vyvNCMjQNti6PRJema%2Fimage.png?alt=media&amp;token=588099d3-8c33-4cb3-917e-f1964b0afb60" alt=""><figcaption></figcaption></figure></div>

The number is added to the **Call forwarding numbers** section.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2FmX32tgt60imB2uFlVCoB%2FScreenshot_2.jpg?alt=media&amp;token=b124478e-d9c4-45d5-bdbc-ec646c9fa0ad" alt=""><figcaption></figcaption></figure></div>

Click the **Delete** icon next to your main phone number to remove it, leaving your **AI Voice** agent as the only call forwarding destination.

<div data-with-frame="true"><figure><img src="https://4165927833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWHGGlctFzoGEVhyOAO17%2Fuploads%2F5ikhoeAyxyXGcd0PlccN%2FScreenshot_7.jpg?alt=media&amp;token=82a42e6f-df39-4ebb-9c19-558dcc46e030" alt=""><figcaption></figcaption></figure></div>

Click **Save** to apply the changes to the extension.

***

### **Combine overflow and after-hours call forwarding**

Use this configuration to combine overflow backup during business hours with dedicated after-hours answering.

During business hours, calls ring your team first and are forwarded to your AI Voice agent if unanswered. Outside business hours, calls bypass your team and are routed directly to your AI Voice agent.

First, complete [**Forward overflow and missed calls**](#forward-overflow-and-missed-calls).

Then, complete [**Forward after-hours calls**](#forward-after-hours-calls).

Ensure the **Call forwarding numbers** list is ordered as follows:

1. **Main phone number** — Configure **Working hours** to your **business hours**. This number receives calls first during business hours.
2. **Distance phone number (Overflow)** — Configure **Working hours** to the same **business hours**. Place this immediately after your main phone number so unanswered business-hour calls are forwarded to your AI Voice agent.
3. **Distance phone number (After-hours)** — Configure **Working hours** to your **after-hours** schedule. Place this after the business-hours Distance number so all calls received outside business hours are routed directly to your **AI Voice** agent.
