retellai-common-errors

Featured

Diagnose and fix Retell AI voice agent errors: call failures, webhook issues, voice quality. Use when encountering Retell AI errors, debugging call issues, or troubleshooting agents. Trigger with phrases like "retell error", "call failed", "voice agent not working", "retell debug".

AI & Automation 2,266 stars 315 forks Updated today MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Retell AI Common Errors ## Overview Quick reference for the top Retell AI errors and their solutions. ## Prerequisites - `retell-sdk` installed - API key configured ## Instructions ### Error 1: 401 Unauthorized ``` RetellError: 401 — Invalid API key ``` **Fix:** Verify API key in Retell Dashboard. Ensure `RETELL_API_KEY` starts with `key_`. ### Error 2: Call Fails Immediately ``` RetellError: 400 — Invalid phone number format ``` **Fix:** Use E.164 format: `+14155551234`. Both `from_number` and `to_number` must be valid. ### Error 3: Agent Not Responding ``` Call connected but agent says nothing ``` **Fix:** Check LLM configuration: ```typescript const llm = await retell.llm.retrieve(agent.response_engine.llm_id); console.log(`Model: ${llm.model}`); console.log(`Prompt length: ${llm.general_prompt.length} chars`); // Ensure general_prompt is not empty and gives clear instructions ``` ### Error 4: Function Call Timeout ``` Function call to https://your-api.com/endpoint timed out ``` **Fix:** Your function endpoint must respond within 5 seconds. Offload heavy work: ```typescript app.post('/functions/lookup', async (req, res) => { // Respond immediately with acknowledgment const result = await quickLookup(req.body.args); res.json({ result: `Found: ${result.name}` }); // Do NOT run async work before responding }); ``` ### Error 5: Webhook Not Receiving Events ``` No webhook events received after call ``` **Fix:** Set `webhook_url` on the agent, not just in Dashb...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
7 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

retellai-advanced-troubleshooting

Retell AI advanced troubleshooting — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like "retell advanced troubleshooting", "retellai-advanced-troubleshooting", "voice agent".

2,266 Updated today
jeremylongshore
AI & Automation Solid

retellai-known-pitfalls

Retell AI known pitfalls — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like "retell known pitfalls", "retellai-known-pitfalls", "voice agent".

2,266 Updated today
jeremylongshore
AI & Automation Solid

retellai-security-basics

Retell AI security basics — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like "retell security basics", "retellai-security-basics", "voice agent".

2,266 Updated today
jeremylongshore
AI & Automation Solid

retellai-data-handling

Retell AI data handling — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like "retell data handling", "retellai-data-handling", "voice agent".

2,266 Updated today
jeremylongshore
AI & Automation Featured

retellai-webhooks-events

Retell AI webhooks events — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like "retell webhooks events", "retellai-webhooks-events", "voice agent".

2,266 Updated today
jeremylongshore