Buy and assign phone numbers
Search for and buy Twilio numbers, then assign each as a personal, SAMI, or group line for calls and SMS.
Phone numbers power calls and texts in SAMI OS. On the Phone numbers page you can buy a Twilio number, release one you no longer need, and decide exactly how each number is used.
Managing phone numbers is owner-only. If you don't see the page, ask an organization owner to set up numbers, or check your role in Members.
Buy a phone number
Head to Phone numbers to search for and purchase a Twilio number for your organization.
Open the search dialog
On Phone numbers, click Add phone number.
Search available numbers
Search by area code or region to find a Twilio number that fits your market.
Buy the number
Pick a number and confirm the purchase. It's added to your account and appears under Your numbers, ready to assign.
Assign how each number is used
Every number lives under Your numbers with its current usage and routing shown on the card. Click Configure to open the usage dialog and choose one of three types:
- Personal line — routes calls and texts to a specific teammate. Pick the owner from your active members.
- SAMI line — ties the number to a specific SAMI Bot so inbound calls are answered by that agent. Choose the bot under SAMI Bots.
- Group line — shares the number across several teammates with shared ring rules.
For a group line, you also set the ring order, the ring duration in seconds, the inbound and SMS routing mode (ring group members or route to the assigned contact owner), an optional press-one confirmation, and the members who receive calls and texts.
Use a SAMI line when you want a SAMI Bot to pick up and qualify inbound callers, and a group line when you want a shared team number with a defined ring order and fallback recipient.
How saving and provisioning work
When you save a usage assignment, it's written to the database as the source of truth — your list updates right away. SAMI OS then provisions the voice routing in the background on a best-effort basis.
If that background step doesn't finish, the number is still saved, but you'll see a warning that voice provisioning didn't complete and that calls may not route to SAMI until it's resolved. Re-saving the assignment retries provisioning.
Releasing a number removes it from your account and can't be undone. Reassign any active personal, SAMI, or group line first so calls and texts keep flowing.
Release a number
To give up a number, click Release on its card and confirm. Before sending SMS from any number, make sure your organization is registered for compliance under A2P registration.
Related articles
Last updated 2026-06-21