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

# Phone Numbers

> Get and manage phone numbers for your AI agents

## Getting Phone Numbers

SmartAlex provisions phone numbers in 9 countries. When someone calls your number, they're connected to your AI agent.

### Available Countries

| Country        | Number Types Available   |
| -------------- | ------------------------ |
| United States  | Local, mobile, toll-free |
| Canada         | Local, mobile, toll-free |
| United Kingdom | Toll-free                |
| Australia      | Local, toll-free         |
| New Zealand    | Toll-free                |
| Netherlands    | Mobile, toll-free        |
| Denmark        | Mobile, toll-free        |
| Finland        | Local, mobile, toll-free |
| South Africa   | Local                    |

Regulatory requirements (e.g. local address proof) vary by country and are displayed during the purchase flow.

### Pricing

Phone numbers are billed from **\$2/month** each (premium and toll-free numbers can cost more). Per-minute usage on calls is separate, see the [Pricing page](/pricing) for details.

Your Professional plan includes **1 phone number** at no extra cost. Additional numbers are from \$2/month each.

## Purchasing a Number

<Steps>
  <Step title="Navigate to Phone Numbers">
    Go to **Phone Numbers** in your dashboard.
  </Step>

  <Step title="Click Buy New">
    Click the **Buy New** button to open the purchase dialog.
  </Step>

  <Step title="Select Country">
    Choose your country. The available number types (local, mobile, or toll-free) for that country are displayed.
  </Step>

  <Step title="Pick a number">
    Browse available numbers and click **Get Number** to purchase. The number is provisioned immediately.
  </Step>

  <Step title="Assign to Agent">
    Select which AI agent should answer calls to this number.
  </Step>
</Steps>

## Managing Numbers

### Number List

Your phone numbers page shows:

* Phone number
* Assigned agent (if any)
* Country and number type
* Date acquired

### Actions

| Action           | Description                                |
| ---------------- | ------------------------------------------ |
| **Assign Agent** | Connect the number to an AI agent          |
| **Change Agent** | Switch to a different agent                |
| **Unassign**     | Remove the agent (the number won't answer) |
| **Release**      | Give up the number (cannot be undone)      |

<Warning>
  Releasing a number is permanent. The number is returned to the carrier pool and may be assigned to another customer.
</Warning>

## Number Assignment

Each phone number can be assigned to one AI agent at a time. The agent handles all inbound calls to that number.

You can:

* Use the same number across multiple campaigns by reusing the same agent
* Assign multiple numbers to the same agent (e.g., one per region)
* Change assignments at any time without losing the number

<Note>
  When you change which agent is assigned to a number, the change takes effect immediately. No downtime or reconfiguration needed.
</Note>

## Bring your own carrier

If you already have phone numbers with another carrier or PBX, you can route them to SmartAlex over SIP instead of buying new numbers. See the [Telephony documentation](/telephony/overview) for full integration guides for 3CX, Yeastar, FreePBX, Asterisk, Avaya, Mitel, Microsoft Teams, RingCentral, and more.

## Best Practices

<AccordionGroup>
  <Accordion title="Choosing the right number type">
    * **Local**, best for businesses serving a specific region; callers see a familiar area code
    * **Toll-free**, good for national or multi-region businesses
    * **Mobile**, useful in markets where customers prefer dialling mobile numbers
  </Accordion>

  <Accordion title="Number organisation">
    * Name the agents clearly (e.g. "Main Line", "Sales", "Support") so each number's purpose is obvious
    * Document which number is for which campaign or location
    * Review unused numbers monthly so you're not paying for ones you don't need
  </Accordion>
</AccordionGroup>