Skip to main content
When your phone system is not working as expected — dropped calls, poor audio quality, or missed inbound calls — the issue usually involves configuration, network conditions, or Twilio account settings. This guide walks you through the most common phone system problems in the HoopAI platform and how to fix them.

Call quality issues

1

Check your internet connection

VoIP calls require a stable internet connection with at least 100 Kbps upload and download per concurrent call. Test your connection speed and switch to a wired connection if you are on Wi-Fi.
2

Close bandwidth-heavy applications

Video streaming, large file downloads, and other VoIP calls on the same network can degrade call quality. Close unnecessary applications during calls.
3

Use a headset

Built-in laptop microphones and speakers often cause echo and feedback. Use a dedicated headset with a microphone for the best audio quality.
4

Check browser permissions

Ensure your browser has permission to access your microphone. In Chrome, click the lock icon in the address bar and confirm Microphone is set to Allow.
If call quality issues affect all users in your sub-account, the problem may be network-wide. Contact your internet service provider or network administrator to check for bandwidth throttling or packet loss.

Missed calls and inbound call failures

IssueCauseFix
Calls go straight to voicemailNo users available or ring timeout too shortIncrease the ring timeout in Settings > Phone Numbers > Call Settings
Inbound calls not ringingCall routing not configuredAssign the phone number to a user or ring group in phone number settings
Calls ring but no audioBrowser microphone blockedGrant microphone access in your browser settings
Caller hears a busy signalAll users in the ring group are on callsAdd more users to the ring group or enable call queuing
If you recently ported a phone number to Hoop, inbound calls may not work for 24–48 hours while the port completes. Check the porting status in Settings > Phone Numbers.

Voicemail issues

1

Verify voicemail is enabled

Navigate to Settings > Phone Numbers, select the number, and confirm that Voicemail is toggled on.
2

Check the voicemail greeting

If your voicemail greeting is not playing, re-upload or re-record it in the voicemail settings. Ensure the audio file is in MP3 or WAV format and under 5 MB.
3

Confirm notification settings

Go to Settings > Notifications and ensure voicemail notifications are enabled. You can receive notifications via email, in-app, or both.
4

Check voicemail transcription

If voicemail transcription is not working, verify it is enabled in your phone settings. Transcription requires an active Twilio account with the transcription add-on enabled.

Caller ID issues

1

Set the outbound caller ID

Navigate to Settings > Phone Numbers and select the number used for outbound calls. Set the Caller ID to display either your business number or business name.
2

Register your caller ID

Unregistered caller IDs may show as “Unknown” or “Spam Likely” on recipients’ phones. Register your number with free caller registry services and with major carriers.
3

Verify the number is not flagged

If your number is being flagged as spam, contact your carrier and Hoop support. High call volumes or recipient reports can trigger spam flags on carrier networks.
Register your business phone number with STIR/SHAKEN attestation through your Twilio account settings. This verifies your caller identity and reduces the likelihood of being flagged as spam.

Call forwarding failures

IssueCauseFix
Forwarded calls not reaching the destinationForwarding number is incorrectVerify the destination number in Settings > Phone Numbers > Call Forwarding
Forwarded calls drop immediatelyDestination number rejects forwarded callsTest the destination number directly and check if it blocks unknown callers
Forwarding delay is too longRing timeout set too high before forwardingReduce the ring timeout so calls forward faster
Caller hears ringing but no one answersDestination phone is off or out of rangeSet up a fallback number or voicemail for when forwarding fails

Twilio integration and phone number registration

1

Verify your Twilio account balance

Log into your Twilio console and check your account balance. If the balance is zero or negative, all calls and SMS will fail until you add funds.
2

Check Twilio service status

Visit the Twilio status page to confirm there are no active incidents affecting voice services in your region.
3

Register for A2P 10DLC (US numbers)

US phone numbers require A2P 10DLC registration for business messaging and calling. Navigate to Settings > Phone Numbers > Compliance and complete the registration form.
4

Confirm number capabilities

Not all Twilio numbers support voice. In your Twilio console, verify that the number assigned to Hoop has Voice capability enabled.
A2P 10DLC registration is required by US carriers for all business phone numbers. Without registration, your calls and texts may be blocked or filtered. Registration typically takes 1–5 business days.

FAQs

Check the outbound caller ID setting for the user or phone number in Settings > Phone Numbers. Each user can have a different outbound caller ID assigned. Ensure the correct number is selected.
Yes, you can port your existing number to Hoop. Go to Settings > Phone Numbers > Port Number and follow the steps. Porting typically takes 1–3 weeks depending on the carrier.
International calling must be enabled in your Twilio account settings. Additionally, some countries require geographic permissions to be explicitly enabled. Check Twilio’s geographic permissions in your console.
Last modified on March 5, 2026