Debug phone call issues
Debug outbound connection issues
Understand outbound call disconnection reasons.
When an outbound call is made and a dial_failed
, dial_busy
, dial_no_answer
reason is returned, it means that the outbound call is not successful.
There can be a few reasons for this:
-
dial_failed
:- The number dialed is not existent
- The number you use to dial is marked as spam and got blocked (see below for more details)
- Error met in telephony provider (for example, max call per second limit reached)
- The number dialed did not answer
- if using custom telephony, it might be your outbound termination url & credential configuration issue.
-
dial_busy
:- The number dialed is busy
-
dial_no_answer
:- The number dialed did not answer
- if using custom telephony, it might be your outbound termination url & credential configuration issue.
It’s however beyond our scope and control to have more information about why it did not connect.
Steps to troubleshoot
-
If using custom telephony
- Double check your configuration and make sure you imported the right information. Refer to FAQ for more info.
- If the configuration is not correct, delete the imported number and re-import.
- If that does not solve it, please check with your telephony provider to see what’s the error on their side.
-
If using numbers purchased from Retell
- Check if the number is marked as spam.
- Make sure the destination number can accept the call. Currently numbers purchase from Retell can only make calls to US numbers.
Number marked as spam
When a number experience high outbound call volume spike without any warmup, and / or has a low pickup rate, it might be marked as spam by carriers. When this happens, the number will get blocked frequently. To remedy this, you can try to:
- Purchase a new number, and warm it up before pouring all traffic to it (slowly add outbound traffic to it)
- Increase the pickup rate, read more at Increase Pickup Rate
- register the number with our spam remediation feature, read more at verified phone number
Was this page helpful?