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

# Phone number and forwarding

> Get your AI number, choose how patients reach it, and avoid the two phone-system settings that drop calls.

## Two ways to go live

<CardGroup cols={2}>
  <Card title="Keep your number, forward calls" icon="phone-arrow-right">
    Recommended. Patients keep calling the number they know. Your carrier forwards to the HealOS number.
  </Card>

  <Card title="Use the HealOS number directly" icon="phone">
    Put the new number on your website and Google Business Profile. No forwarding needed.
  </Card>
</CardGroup>

## Get the number

On "Your AI Frontdesk is ready" (or Settings → **AI Phone Number** → **Change**): search by area code, pick a number, **Activate & assign number**.

<Info>
  The number works as soon as it is assigned. Call it from a cell phone to test booking and transfers before you change any forwarding.
</Info>

## Forward your existing line

Under "Connect to your existing line", pick your **Phone system type** (cell, VoIP, landline) and your **provider**. HealOS shows the exact steps or dial codes for that carrier, with a copy button on each.

<Tabs>
  <Tab title="Cell carriers">
    AT\&T and T-Mobile use `**21*<number>#` to enable and `##21#` to disable. Verizon uses `*72<number>` and `*73`. The screen shows the codes for your carrier.
  </Tab>

  <Tab title="VoIP systems">
    RingCentral, Google Voice, Vonage, Dialpad, 8x8, and Zoom Phone all have a "forward all calls" setting in their admin console. The screen shows the menu path for each.
  </Tab>

  <Tab title="Landlines">
    Most support `*72` and `*73`. Otherwise contact your provider. Some charge a monthly forwarding fee.
  </Tab>
</Tabs>

## Before you forward

<Warning>
  **Turn off "confirm connection", "press 1 to accept", and call screening on the forwarding rule.** The AI cannot press keys. With these on, a large share of calls drop before the AI speaks.
</Warning>

* Turn off voicemail on the forwarded line so it does not race the AI.
* Save the HealOS outbound number in staff phones. On iPhones, unsaved numbers can be caught by Call Screening, which makes warm transfers fail.

## Turning it off temporarily

Remove the forwarding rule (the disable code is shown on screen). Calls ring your front desk again immediately.


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