Imported from jeremylongshore/tons-of-skills-marketplace (plugins/saas-packs/retellai-pack/skills/retellai-reference-architecture/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-reference-architecture. Copyright stays with the author (MIT).

Retell AI Reference Architecture

Overview

Implementation patterns for Retell AI reference architecture — voice agent and telephony platform.

Prerequisites

• Completed retellai-install-auth setup

Instructions

Step 1: SDK Pattern

import Retell from 'retell-sdk';
const retell = new Retell({ apiKey: process.env.RETELL_API_KEY! });

const agents = await retell.agent.list();
console.log(`Agents: ${agents.length}`);

Output

• Retell AI integration for reference architecture

Error Handling

Examples

Separate the call path from slow business-system enrichment

Route the voice agent through a stable API boundary that validates inputs and returns a bounded response, while sending slow CRM or analytics enrichment to an asynchronous worker. The agent receives a clear timeout and human-transfer fallback if the business system is unavailable. Exercise this topology with a synthetic outage before launch, then document which component owns retries, audit events, and the rollback to the prior routing configuration.

Resources

• Retell AI Documentation
• retell-sdk npm

Next Steps

See related Retell AI skills for more workflows.