📱 Overview
Purchase Number is where you find an available phone number, choose one, and buy it so it can be used with your AI setup. After a successful purchase, you are taken back to My Numbers, where your numbers are listed.
📝 Fields and controls (top row)
🏷️ Nickname (Optional)- This is a short label you can give the number so you recognize it later (for example a team or campaign name).
- Important: The label says “Optional,” but when you press Purchase Number, the system requires a nickname. If you leave it blank, you may see a message asking you to enter a nickname before the purchase can finish.
- Chooses which AI agent should handle calls coming in to this number.
- The list shows agent names from your company. You can search inside the list by typing (the box behaves like a searchable list, not only a plain scroll).
- You can also clear your choice using the clear option on the control, if your setup allows it.
- Chooses which AI agent should be used for outgoing use associated with this number, according to how your account is set up.
- Same kind of searchable list as Inbound Agent, with the same agents available.
🔍 Fields and controls (search row)
These fields control where and how the system looks for available numbers before you buy. They do not complete the purchase by themselves—you still use Search, then Purchase Number.
- Picks which phone service connection to use when searching and buying:
- Twilio — one option.
- The second option uses your product’s branded name (it is the AI Sync option in the system).
- Limits the search to numbers in:
- USA, or
- Canada
- Pick the country where you want the number to be located.
- Tells the system how to interpret what you type in the next box:
- AreaCode — search by dialing area (for example a three-digit area code where that applies).
- Region — search by region.
- City — search by city name or label, depending on what the service supports.
- This is the actual search text (code, region, or city) matching the option you chose under Search By.
- It works together with Countries and Provider to narrow the list.
- You must type something in the AreaCode/Region/City box before Search does anything useful.
- If that box is empty, the page shows a short message asking you to fill the fields (meaning: enter a search value).
- If you did enter a value, the page first shows a “please wait” style message while the lookup runs.
- When the lookup succeeds, a table fills with rows of numbers.
- When it fails, a message appears explaining the problem (for example, nothing found, or your account is not set up for that provider).
📋 The results table
After a successful search, you see a table with a header row and a scrollable area (the list does not grow endlessly in view—it scrolls inside a fixed height). Columns:| Column | Meaning |
|---|---|
| # | Row number (1, 2, 3, …). |
| Friendly Name | A readable label for the number provided by the service. |
| Phone # | The actual phone number format you are choosing. |
| Locality | Where the number is associated (city, region, postal details, country—whatever the service returns). |
| Capabilities | What the number can do (for example text-related features and voice), listed in short form. |
| (last column, no title) | A choice control so you pick one number. Only one row should be selected at a time. |
🛒 Finishing the purchase
💳 Purchase Number (button) When you click Purchase Number, the system:- Reads your nickname, Inbound Agent, Outbound Agent, Provider, and the one number you selected in the table.
- If no number is selected, you see a message asking you to select a number.
- If a number is selected, a please wait style message appears while the system:
- Acquires the number through the provider you chose (Twilio or the AI sync path), and then
- Links that number to your nickname and agents in the way your product is designed (including voice routing setup behind the scenes).
- Takes you back to My Numbers without buying a number.
- No purchase happens when you use Cancel.