Skip to main content

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.

​
Getting Phone Numbers

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

​
Available Countries

CountryNumber Types Available
United StatesLocal, mobile, toll-free
CanadaLocal, mobile, toll-free
United KingdomToll-free
AustraliaLocal, toll-free
New ZealandToll-free
NetherlandsMobile, toll-free
DenmarkMobile, toll-free
FinlandLocal, mobile, toll-free
South AfricaLocal
Regulatory requirements (e.g. local address proof) vary by country and are displayed during the purchase flow.

​
Pricing

Phone numbers are billed at $1/month flat, regardless of country. Per-minute usage on calls is separate — see the Pricing page for details. Your Professional plan includes 1 phone number at no extra cost. Additional numbers are $1/month each.

​
Purchasing a Number

1

Navigate to Phone Numbers

Go to Phone Numbers in your dashboard.
2

Click Buy New

Click the Buy New button to open the purchase dialog.
3

Select Country

Choose your country. The available number types (local, mobile, or toll-free) for that country are displayed.
4

Pick a number

Browse available numbers and click Get Number to purchase. The number is provisioned immediately.
5

Assign to Agent

Select which AI agent should answer calls to this number.

​
Managing Numbers

​
Number List

Your phone numbers page shows:
  • Phone number
  • Assigned agent (if any)
  • Country and number type
  • Date acquired

​
Actions

ActionDescription
Assign AgentConnect the number to an AI agent
Change AgentSwitch to a different agent
UnassignRemove the agent (the number won’t answer)
ReleaseGive up the number (cannot be undone)
Releasing a number is permanent. The number is returned to the carrier pool and may be assigned to another customer.

​
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
When you change which agent is assigned to a number, the change takes effect immediately. No downtime or reconfiguration needed.

​
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 for full integration guides for 3CX, Yeastar, FreePBX, Asterisk, Avaya, Mitel, Microsoft Teams, RingCentral, and more.

​
Best Practices

  • 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
  • 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