home / skills / jeremylongshore / claude-code-plugins-plus-skills / retellai-hello-world

This skill helps you quickly set up a minimal Retell AI hello world example, validating API access and basic integration.

npx playbooks add skill jeremylongshore/claude-code-plugins-plus-skills --skill retellai-hello-world

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.3 KB
---
name: retellai-hello-world
description: |
  Create a minimal working Retell AI example.
  Use when starting a new Retell AI integration, testing your setup,
  or learning basic Retell AI API patterns.
  Trigger with phrases like "retellai hello world", "retellai example",
  "retellai quick start", "simple retellai code".
allowed-tools: Read, Write, Edit
version: 1.0.0
license: MIT
author: Jeremy Longshore <[email protected]>
---

# Retell AI Hello World

## Overview
Minimal working example demonstrating core Retell AI functionality.

## Prerequisites
- Completed `retellai-install-auth` setup
- Valid API credentials configured
- Development environment ready

## Instructions

### Step 1: Create Entry File
Create a new file for your hello world example.

### Step 2: Import and Initialize Client
```typescript
import { RetellAIClient } from '@retellai/sdk';

const client = new RetellAIClient({
  apiKey: process.env.RETELLAI_API_KEY,
});
```

### Step 3: Make Your First API Call
```typescript
async function main() {
  // Your first API call here
}

main().catch(console.error);
```

## Output
- Working code file with Retell AI client initialization
- Successful API response confirming connection
- Console output showing:
```
Success! Your Retell AI connection is working.
```

## Error Handling
| Error | Cause | Solution |
|-------|-------|----------|
| Import Error | SDK not installed | Verify with `npm list` or `pip show` |
| Auth Error | Invalid credentials | Check environment variable is set |
| Timeout | Network issues | Increase timeout or check connectivity |
| Rate Limit | Too many requests | Wait and retry with exponential backoff |

## Examples

### TypeScript Example
```typescript
import { RetellAIClient } from '@retellai/sdk';

const client = new RetellAIClient({
  apiKey: process.env.RETELLAI_API_KEY,
});

async function main() {
  // Your first API call here
}

main().catch(console.error);
```

### Python Example
```python
from retellai import RetellAIClient

client = RetellAIClient()

# Your first API call here
```

## Resources
- [Retell AI Getting Started](https://docs.retellai.com/getting-started)
- [Retell AI API Reference](https://docs.retellai.com/api)
- [Retell AI Examples](https://docs.retellai.com/examples)

## Next Steps
Proceed to `retellai-local-dev-loop` for development workflow setup.

Overview

This skill provides a minimal, working Retell AI example to verify configuration and demonstrate basic API usage. It shows how to initialize the client, make a first call, and confirm a successful connection. Use it to validate credentials and learn the simplest Retell AI integration pattern.

How this skill works

The example initializes the Retell AI client with environment-based credentials and performs a lightweight API call to confirm connectivity. It prints a success message on a valid response and includes basic error handling hints for import, auth, timeout, and rate-limit issues. The code is intentionally minimal so you can drop it into a new project and confirm your setup quickly.

When to use it

  • Starting a new Retell AI integration to verify credentials and environment
  • Testing your development environment after installing the SDK
  • Learning the simplest client initialization and request pattern
  • Troubleshooting connectivity or auth problems with a reproducible example
  • As a template before building out more complex API interactions

Best practices

  • Store API keys in environment variables, not in source code
  • Keep the first request small and idempotent to avoid side effects
  • Implement retries with exponential backoff for rate limits
  • Add timeouts and clear logging around network calls
  • Validate SDK installation using package tooling before running the script

Example use cases

  • Run a quick script to confirm RETELLAI_API_KEY is set and valid
  • Use the minimal file in CI to check service availability before tests
  • Start a tutorial or workshop with a guaranteed working baseline
  • Compare TypeScript and Python initialization patterns in a demo
  • Use as a template when onboarding new team members to the API

FAQ

What if I get an import error?

Verify the SDK is installed for your language (npm list or pip show) and that you are using the correct import syntax.

How do I fix an auth error?

Confirm your API key is set in the environment variable expected by the SDK and that there are no typos or expired credentials.