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

# Phone Number Setup

> Buy, import, and assign phone numbers

## Buy a number

<Steps>
  <Step title="Go to Phone Numbers">
    In the dashboard sidebar, click **Phone Numbers**.
  </Step>

  <Step title="Search for a number">
    Select a country and optionally an area code. Click **Search** to see available numbers.
  </Step>

  <Step title="Buy">
    Click **Buy** on the number you want. It's added to your account immediately.
  </Step>

  <Step title="Assign to an agent">
    Select the number, choose an agent, and set the assignment type (inbound or outbound).
  </Step>
</Steps>

## Import your Twilio number (BYOT)

If you already have Twilio numbers, you can bring them into Orova:

<Steps>
  <Step title="Enter your Twilio credentials">
    Go to **Phone Numbers → Import** and enter your Twilio Account SID and Auth Token.
  </Step>

  <Step title="Select numbers to import">
    Orova lists your existing Twilio numbers. Select the ones you want to use.
  </Step>

  <Step title="Assign to agents">
    Assign imported numbers to agents. Orova automatically configures the Twilio webhooks for you.
  </Step>
</Steps>

### BYOT rules

<Info>
  Understanding these rules will help you plan your phone number setup across workspaces and agents.
</Info>

**Twilio account scope:**

* One Twilio account can be used across multiple workspaces within the same organization
* A Twilio account cannot be shared across different organizations

**Outbound assignment:**

* The same phone number can be assigned to multiple agents for outbound calls within the same organization and workspace
* This lets different agents share a caller ID

**Inbound assignment:**

* A phone number can only be assigned to one agent for inbound calls across the entire organization
* This is because incoming calls need to route to a single agent — Orova needs to know exactly which agent should answer
* If you need multiple agents handling inbound calls, use a separate phone number for each

### Quick reference

| Rule                                          | Outbound    | Inbound                     |
| --------------------------------------------- | ----------- | --------------------------- |
| Same number, multiple agents (same workspace) | Allowed     | Not allowed                 |
| Same number, multiple workspaces (same org)   | Allowed     | Not allowed                 |
| Same Twilio account, multiple workspaces      | Allowed     | Allowed (different numbers) |
| Same Twilio account, multiple organizations   | Not allowed | Not allowed                 |

<Warning>
  Importing a number will update its Twilio webhook configuration. Make sure the number isn't actively used by another service before importing.
</Warning>

## Assignment types

### Inbound

The agent answers calls to this number. When someone dials the number, Orova routes the call to the assigned agent. Each inbound number maps to exactly one agent.

### Outbound

The number is used as the caller ID when the agent makes outbound calls. Multiple agents can share the same outbound number within a workspace.