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

# Manage phone numbers

> How to add, configure, and manage your phone numbers (DIDs) in Astradial.

A **DID** (Direct Inward Dialing) number is a phone number that people can call to reach your organization. When someone dials your DID, Astradial routes the call to the right place — an extension, a queue, or an AI bot.

## View your phone numbers

Go to **Phone Numbers** in the sidebar under **Deploy**. You will see two tabs:

* **My Numbers** — Phone numbers assigned to your organization
* **Buy a Number** — Available numbers you can request from the admin

## Add a phone number (self-hosted)

If you are running Astradial on your own server:

<Steps>
  <Step title="Click Add Number">
    Click the **Add Number** button (plus icon) in the top-right corner.
  </Step>

  <Step title="Enter the phone number">
    Type the full phone number including country code. Example: `+918065978015`
  </Step>

  <Step title="Add a description">
    Give it a name so you can recognize it later. Example: "Main reception line"
  </Step>

  <Step title="Select a trunk">
    Choose which SIP trunk this number belongs to. The trunk is the connection to your phone carrier.
  </Step>

  <Step title="Set up routing">
    Choose where calls to this number should go:

    | Routing type  | What happens                          |
    | ------------- | ------------------------------------- |
    | **Extension** | Rings a specific user's SIP phone     |
    | **Queue**     | Puts the caller in a call queue       |
    | **IVR**       | Connects to an interactive voice menu |
    | **AI Agent**  | Connects to an AI voice bot           |
    | **External**  | Forwards to an external phone number  |
  </Step>

  <Step title="Click Add Number">
    The number is added and routing is configured immediately.
  </Step>
</Steps>

## Request a number (cloud/managed)

If your admin has set up a DID pool with available numbers:

1. Go to the **Buy a Number** tab
2. Browse the available numbers — each shows the price per month, region, and provider
3. Click **Request** next to the number you want
4. Your request goes to the admin for approval
5. Once approved, the number appears in your **My Numbers** tab

You can cancel a pending request from the **Pending Approval** section on the My Numbers tab.

## Configure routing

To change how calls to a number are handled:

1. In the **My Numbers** tab, find the number you want to configure
2. Click the three-dot menu and select **Configure Routing**
3. Update the routing type and destination
4. Optionally change the status to **Active** or **Inactive**
5. Click **Save**

## Phone number statuses

| Status       | Meaning                                                        |
| ------------ | -------------------------------------------------------------- |
| **Active**   | The number is live and receiving calls                         |
| **Inactive** | The number exists but calls are not being routed               |
| **Pending**  | You requested this number and it is waiting for admin approval |

## Statistics

At the top of the Phone Numbers page, three cards show:

* **Active Numbers** — How many numbers are currently routing calls
* **Pending Requests** — How many numbers are awaiting approval
* **Available to Buy** — How many numbers are in the pool for purchase