home / skills / jeremylongshore / claude-code-plugins-plus-skills / retellai-hello-world
/plugins/saas-packs/retellai-pack/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-worldReview the files below or copy the command above to add this skill to your agents.
---
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.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.
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.
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.