Phone number types
HoopAI supports several types of phone numbers for Voice AI:Purchasing a new phone number
Open the phone numbers page
Search for available numbers
- Number type — Local or toll-free
- Area code — Specific region
- Contains — Search for numbers containing specific digits (e.g., numbers ending in 0000)
Select and purchase
Complete regulatory requirements
Assigning a number to a Voice AI agent
Once you have a phone number in your HoopAI account, you can assign it to a Voice AI agent.Open your Voice AI agent
Navigate to phone settings

Phone number settings in the Voice AI agent configuration
Select a number

Select an available phone number to assign to your Voice AI agent

Select your phone number from the available numbers list
Save the assignment
Forwarding an existing number
If you already have a business phone number with another provider and do not want to port it, you can forward calls to your HoopAI Voice AI number.How call forwarding works
- A customer calls your existing business number.
- Your external provider forwards the call to your HoopAI number.
- Your Voice AI agent answers the forwarded call.
Setting up forwarding
Contact your current phone provider and request unconditional call forwarding (also called “always forward”) to your HoopAI number. The exact steps depend on your provider, but the general process is:- Purchase or identify a HoopAI number to receive forwarded calls.
- Assign that HoopAI number to your Voice AI agent.
- Configure forwarding on your external provider to point to the HoopAI number.
-
Test by calling your original business number and verifying the Voice AI agent answers.

Configure call forwarding settings for your Voice AI number

Configure call forwarding to route calls to your Voice AI agent
Conditional forwarding options
Instead of forwarding all calls, you can set up conditional forwarding:- Forward on no answer — Calls ring your human team first. If no one picks up within a set time, the call forwards to your Voice AI agent as a backup.
- Forward on busy — When all lines are busy, overflow calls go to your Voice AI agent.
- Forward outside business hours — Calls only forward to the AI agent after hours.

Edit forwarding rules to control when calls route to your Voice AI agent
Porting a number to HoopAI
If you want to fully transfer an existing number to HoopAI (rather than forwarding), you can submit a port request.Gather porting information
- The phone number(s) to port
- Your current provider’s name
- Account number with the current provider
- A recent bill or letter of authorization (LOA)
- The authorized name on the account
Submit the port request
Wait for processing
Assign to your Voice AI agent
Configuring working hours
Working hours determine when your Voice AI agent actively answers calls on a given number. This is configured per agent, not per number.Setting working hours

Forward settings showing the destination number configuration
- Open your Voice AI agent settings.
- Navigate to the Working Hours section.
- Toggle working hours on to enable scheduling.
- For each day of the week, set the start and end times.
- Select the correct timezone for your business.

Configure working hours and timezone for your Voice AI agent

Phone number assignment in the Voice AI agent setup wizard
After-hours behavior
When a call comes in outside of working hours, you can configure one of these behaviors:Failover configuration
Failover defines what happens when the Voice AI agent cannot connect — for example, due to a technical issue or if the agent is disabled.Setting up failover
- In your agent settings, find the Failover section.
-
Choose a failover destination:
- Voicemail — Record a message from the caller.
- Forward to number — Route to a backup phone number (human team member, call center, or another line).
- Play message and disconnect — Inform the caller of the issue and ask them to call back.
- Set a failover timeout — how many seconds to wait before triggering failover (default: 10 seconds).
Managing multiple numbers
For businesses with multiple locations or departments, you can assign different numbers to different Voice AI agents:- Main line — General receptionist agent that handles common questions and routes to departments.
- Sales line — Agent focused on qualifying leads and booking sales calls.
- Support line — Agent that troubleshoots common issues and escalates complex cases.
- Location-specific lines — Each branch office has its own number and agent with location-specific information.
Phone number best practices
Use local numbers for outbound calls
Use local numbers for outbound calls
Register for STIR/SHAKEN compliance
Register for STIR/SHAKEN compliance
Keep a backup forwarding number
Keep a backup forwarding number
Test after every change
Test after every change