Pamela Voice API Skill

Make AI-powered phone calls with native phone tree navigation.

Jump to: Installation · Quick Start · Use Cases · SDK Reference

Prerequisites

Enterprise subscription (required for API access)
API key from your Enterprise account
Node.js 18+ (for JS/React) or Python 3.8+ (for Python)

Installation

JavaScript/TypeScript:

npm install @thisispamela/sdk

Python:

pip install thisispamela

React:

npm install @thisispamela/react @thisispamela/sdk

CLI:

npm install -g @thisispamela/cli

MCP (for MCP-based agents):

npm install @thisispamela/mcp

Latest versions: SDK / CLI / Python 1.1.2, React 1.1.3, MCP 1.1.2.

Getting Your API Key

Sign up for an Enterprise subscription at app.thisispamela.com
Navigate to Settings → Enterprise Access
Set up billing through Stripe
Click "Create API Key"
Save immediately - the full key (starts with pk_live_) is only shown once

Quick Start

Note: Phone numbers must be in E.164 format (e.g., +1234567890).

JavaScript

import { PamelaClient } from '@thisispamela/sdk';

const client = new PamelaClient({ apiKey: 'pk_live_...' });

const call = await client.createCall({
  to: '+1234567890',
  task: 'Call the pharmacy and check if my prescription is ready',
  voice: 'female',
  agent_name: 'Pamela',
});

const status = await client.getCall(call.id);
console.log(status.transcript);

Python

from pamela import PamelaClient

client = PamelaClient(api_key="pk_live_...")

call = client.create_call(
    to="+1234567890",
    task="Call the pharmacy and check if my prescription is ready",
    voice="female",
    agent_name="Pamela",
)

status = client.get_call(call["id"])
print(status["transcript"])

CLI

export PAMELA_API_KEY="pk_live_..."

thisispamela create-call \
  --to "+1234567890" \
  --task "Call the pharmacy and check if my prescription is ready"

Use Cases

Use Case	Example Task
Appointment Scheduling	"Call the dentist and schedule a cleaning for next week"
Order Status	"Call the pharmacy and check if my prescription is ready"
Customer Support	"Navigate the IVR menu to reach billing department"
Information Gathering	"Call the restaurant and ask about vegetarian options"
Follow-ups	"Call to confirm the appointment for tomorrow at 2pm"
IVR Navigation	"Navigate the phone menu to reach a human representative"

Key Features

Phone tree navigation - Automatically navigates IVR menus, handles holds and transfers
Custom tools - Register tools the AI can call mid-conversation
Real-time transcripts - Webhook updates as the call progresses
React components - Pre-built UI for call status and transcripts

SDK Reference

For detailed SDK documentation:

JavaScript SDK - Full JS/TS reference
Python SDK - Full Python reference
React Components - Component library guide (v1.1.3)
MCP Server - MCP tools for AI assistants
CLI - Command-line reference

Webhooks

Pamela sends webhooks for call lifecycle events:

call.queued - Call created and queued
call.started - Call connected
call.completed - Call finished successfully
call.failed - Call failed
call.transcript_update - New transcript entries

Verify webhook signatures with the X-Pamela-Signature header.

Billing

$0.10/minute for API usage
Minimum 1 minute per call
Only connected calls are billed
Enterprise subscription required

Troubleshooting

"Invalid API key"

Verify key starts with pk_live_
Check key is active in Enterprise panel

"403 Forbidden"

Enterprise subscription required
Check subscription status at app.thisispamela.com

"Invalid phone number"

Use E.164 format with country code: +1234567890

pamela-calls