Skip to main content

Common Retell errors

Prospecting agent

What you'll achieve​

Fix the most common voice problems.

Step by step​

SymptomWhat to do
Retell rejected the selected voice credential.The key is invalid or was revoked. Create a new credential in Credentials and choose it under Voice.
Voice agents shows LockedThe voice credential or the verified line is missing.
Provisioning didn't finishRetry or wait a few minutes.
The campaign is Paused · no creditRetell ran out of credit. Top up and click Resume. See Balance alerts.
Calls with reason No voice integrationThe workspace's voice configuration is missing.
Calls with reason Provider errorRetry with Retry failed; if it happens again, ask for support.
No Retell agents configured when launching a prospectionActivate the agents in AI connections → Voice agents.

Why a call ended​

The lead shows the disconnection reason: Voicemail, Reached an IVR, Busy, Declined the call, Marked as spam, Could not dial, Invalid number, The prospect hung up, The agent ended the call, Answering machine, Max duration reached or Inactivity.

How to verify it worked​

Provider status shows Retell Funded and new calls go out without failures.