VerticalAI docs
Guides

Phone numbers

Buying inbound numbers at the workspace level and routing them to your agent.

A phone number is the address callers reach your agent at. Numbers are a workspace-level resource — you buy and manage them in workspace settings, then assign one to route to your agent. The agent's own Phone section shows which numbers route to it.

Numbers belong to the workspace

This is the part people miss: you do not buy a number on the agent. You buy it in workspace settings → Phone numbers, where the workspace is charged for it. From there you assign a number to your agent. The agent's Phone page is the read-only view of which numbers currently route to it.

This split exists because a number is a billable, workspace-owned asset — buying, releasing, and reassigning it is a workspace decision, not an agent edit.

Buying a number

In workspace settings → Phone numbers you can:

  • Buy a new inbound number (provisioned through the platform's telephony provider; the workspace is charged).
  • Assign a number so its calls route to your agent.
  • Release a number you no longer need.

Routing to your agent

Once a number is assigned to your agent, calls to it are answered by your published agent. Make sure you have published the configuration you want live before pointing real callers at it — a number routes to the live version, not your draft.

Inbound only

The agent answers calls; it never places them. Phone numbers here are inbound addresses for callers to reach you, not a way to dial out.

On this page