pamela-call

Pamela Calls

Make AI phone calls instantly. No lag, no setup, unlimited scale. ThisIsPamela is a voice AI platform for outbound calls, phone tree navigation, and integration via SDKs, webhooks, and MCP.

Jump to: Installation · Quick Start · Examples · SDK Reference

ClawHub skill release: v1.1.12

Prerequisites

• API subscription (required for API access)
• API key from your API account
• Node.js 18+, Bun, or Python 3.8+ (for Python)

Installation

JavaScript/TypeScript: (npm, yarn, or bun)

npm install @thisispamela/sdk
# or: yarn add @thisispamela/sdk
# or: bun add @thisispamela/sdk

Python:

pip install thisispamela

React: (npm, yarn, or bun)

npm install @thisispamela/react @thisispamela/sdk
# or: bun add @thisispamela/react @thisispamela/sdk

CLI:

npm install -g @thisispamela/cli

MCP (for MCP-based agents):

npm install @thisispamela/mcp

Widget (embeddable, no framework):

npm install @thisispamela/widget

Latest versions: SDK / CLI / Widget / MCP / Python / React 1.2.0.

Getting Your API Key

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

Trust & security

• Official packages: npm @thisispamela, PyPI thisispamela — verify these exact names to avoid typosquatting.
• Before going live: Use a restricted or test API key when trying the skill; enable billing alerts in your account; do not put production keys (pk_live_...) in public configs or logs.
• Webhooks: Always validate the X-Pamela-Signature header and secure your endpoint; see SDK docs for verification.
• Data: Call audio and transcripts are sent to Pamela and may be stored or forwarded to your webhooks; review privacy and data practices (or contact [email protected]).
• Costs: Monitor usage and billing after enabling; only connected minutes are charged at $0.10/min.

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"

Examples

Scenario	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 (v1.1.5)
• Widget - Embeddable widget for any website
• 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

Only credential required is your API key. For webhooks, always verify the X-Pamela-Signature header; see SDK docs for verification.

Billing

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

Troubleshooting

"Invalid API key"

• Verify key starts with pk_live_
• Check key is active in the API settings panel

"403 Forbidden"

• API subscription required
• Check subscription status at developer.thisispamela.com

"Invalid phone number"

• Use E.164 format with country code: +1234567890

Resources

• Website: https://thisispamela.com
• Docs: https://docs.thisispamela.com
• Demo: https://demo.thisispamela.com
• API: https://api.thisispamela.com
• Discord (live support): https://discord.gg/cJj5CK8V
• Email: [email protected]