# Retellai Deploy Integration

> Deploys Retell AI voice agents and phone call integrations using the retell-sdk TypeScript package,

Deploys Retell AI voice agents and phone call integrations using the retell-sdk TypeScript package, covering agent listing via the SDK, API key configuration through RETELL_API_KEY, handling 401, 429, and 400 errors, and promoting a tested agent configuration from a preview number to production with rollback. Use when wiring Retell AI voice agents, telephony routing, or phone call automation into a TypeScript application, or when the user mentions retellai-deploy-integration or voice agent deployment.

- Page: https://ss33.ai/skills/jeremylongshore/retellai-deploy-integration-22566090803
- Publisher: jeremylongshore
- Category: [AI & Agents](https://ss33.ai/skills/category/ai-and-agents-y6jz7i) › [Tool & MCP integration](https://ss33.ai/skills/category/ai-and-agents-y6jz7i/tool-and-mcp-integration-fgfs8e)
- License: MIT
- Source: https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/6cc8e76343714d8807b4a5f1aa604b7ede5e497f/plugins/saas-packs/retellai-pack/skills/retellai-deploy-integration/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/jeremylongshore/retellai-deploy-integration-22566090803

# Retell AI Deploy Integration

## Overview

Implementation patterns for Retell AI deploy integration — voice agent and telephony platform.

## Prerequisites

- Completed `retellai-install-auth` setup

## Instructions

### Step 1: SDK Pattern

```typescript
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 deploy integration

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| 401 Unauthorized | Invalid API key | Check RETELL_API_KEY |
| 429 Rate Limited | Too many requests | Implement backoff |
| 400 Bad Request | Invalid parameters | Check API documentation |

## Examples

### Promote a tested agent configuration through a preview route

Create a versioned agent configuration and attach it to an internal preview
number first. Exercise a synthetic call that verifies the expected webhook,
tool permissions, and fallback transfer, then record the configuration version
and test result. Promote only that reviewed version to the production routing
rule, while retaining the previous version and its routing target for a fast,
auditable rollback if call quality or completion rate regresses.

## Resources

- [Retell AI Documentation](https://docs.retellai.com)
- [retell-sdk npm](https://www.npmjs.com/package/retell-sdk)

## Next Steps

See related Retell AI skills for more workflows.