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

# Phone Numbers

> Purchase and manage phone numbers for your voicebot agents

## How Phone Numbers Work

Phone numbers are managed at the **workspace level** — not per agent. You purchase numbers once and assign them to any voicebot agent in the workspace.

This means you can:

* Buy multiple numbers (e.g., one per country or department)
* Reassign a number from one agent to another without re-purchasing
* Keep unused numbers provisioned for future use

## Purchasing a Phone Number

<Steps>
  <Step title="Go to Phone Numbers">
    Navigate to **Workspace Settings → Phone Numbers**.
  </Step>

  <Step title="Search for a Number">
    Select a country and optionally enter an area code or prefix to filter available numbers.
  </Step>

  <Step title="Buy with One Click">
    Click **Purchase** next to any available number. The number is provisioned and added to your workspace immediately.
  </Step>
</Steps>

<Note>
  Numbers are auto-registered to your workspace as soon as the purchase completes. No manual activation or porting is required.
</Note>

## Assigning a Number to an Agent

Once a number is in your workspace, assign it from the agent's voicebot settings:

1. Open the agent and go to **Agent Settings → Voicebot**
2. In the **Phone number** field, select the number from the dropdown
3. Save your settings

Each phone number can only be assigned to one agent at a time. If you need to reassign a number, remove it from the current agent first.

## Pricing

Voicebot usage is billed **per minute of call time**. Charges apply to connected calls — you are not charged for calls that ring but are not answered.

<Tip>
  Check your current usage and remaining balance in **Workspace Settings → Billing**. You can set up alerts to be notified before your balance runs low.
</Tip>

<Warning>
  If your balance reaches zero during a call, the call ends gracefully. New calls will not connect if there is insufficient balance to cover at least one minute.
</Warning>