---
title: "Introduction"
description: "Documentation for running production voice agents over real phone calls and embeddable web widgets: quickstarts, guides, and the full ThunderPhone API reference."
---

ThunderPhone lets you build AI voice agents that place and answer
real phone calls and power mic-driven conversations on your website.
The documentation is split into four tabs:

<CardGroup cols={2}>
  <Card title="Guides" icon="book" href="/quickstart-dashboard">
    Quickstarts, concepts, and how-tos for the dashboard and the API.
    **Start here** if you're new.
  </Card>
  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Every endpoint, request field, and response shape.
  </Card>
  <Card title="Widget" icon="window-maximize" href="/widget/overview">
    The embeddable web widget — React component, headless hook, and
    CDN script tag.
  </Card>
  <Card title="Webhooks" icon="bolt" href="/webhooks/overview">
    Real-time events, signing, and delivery semantics.
  </Card>
</CardGroup>

## What you can build

<CardGroup cols={2}>
  <Card title="Inbound phone support" icon="phone">
    Answer calls to a number you own with an AI agent that follows your
    prompt, uses your tools, and hands off to humans when needed.
  </Card>
  <Card title="Outbound campaigns" icon="arrow-up-right">
    Place programmatic calls from your code — survey, follow-up, or
    confirmation flows.
  </Card>
  <Card title="In-browser voice" icon="microphone">
    Drop our embeddable [web widget](/guides/embed-web-widget) onto your
    site for customers to click-to-talk. No phone number required.
  </Card>
  <Card title="Test-driven agents" icon="flask">
    Run canned scenarios through your agent in [batches](/api-reference/test-calls)
    so regressions get caught before customers hear them.
  </Card>
</CardGroup>

## Two ways to start

**In the dashboard** (recommended for your first agent) — sign up and
the dashboard walks you through a five-step setup wizard: create an
agent, set up billing, add a phone number, run a simulation, and review
the call. The [dashboard quickstart](/quickstart-dashboard) mirrors
that wizard step by step.

**From your terminal** — the [API quickstart](/quickstart) takes the
same first call in four REST calls.

<Steps>
  <Step title="Skim the concepts">
    [Concepts](/guides/concepts) — a map of every object you'll touch,
    and where each one lives in the dashboard.
  </Step>
  <Step title="Run a quickstart">
    [Dashboard quickstart](/quickstart-dashboard) or
    [API quickstart](/quickstart) — take your first call with an AI
    agent.
  </Step>
  <Step title="Pick a guide">
    Follow a [how-to guide](/guides/build-an-agent) for
    your scenario, or dive into the
    [API reference](/api-reference/introduction).
  </Step>
</Steps>

## Browse the guides

<CardGroup cols={2}>
  <Card title="Using the dashboard" icon="table-columns" href="/guides/build-an-agent">
    Build an agent, fund it, get a number, simulate, and review calls.
  </Card>
  <Card title="Connect tools & data" icon="plug" href="/guides/connect-apps">
    OAuth apps, custom APIs, MCP servers, and VoIP providers.
  </Card>
  <Card title="Analyze & improve" icon="chart-line" href="/guides/reports">
    Reports, observability, experiments, issues, and alerts.
  </Card>
  <Card title="Team & account" icon="users" href="/guides/invite-your-team">
    Invites and roles, API keys, security, and SSO.
  </Card>
</CardGroup>

## Base URL

```
https://api.thunderphone.com/v1
```

Authentication uses the standard OAuth 2.0 Bearer scheme with an
`sk_live_` organization API key. Your key identifies the target
organization automatically — there is no org id in URL paths. See
[Authentication](/api-reference/introduction) for details.

<Note>
  Need help? Email [support@thunderphone.com](mailto:support@thunderphone.com).
</Note>