> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 简介

> ThunderPhone 可通过真实电话通话和可嵌入的网页组件运行生产级语音智能体。从这里开始。

ThunderPhone 让您构建能够拨打和接听真实电话，并支持网站麦克风驱动对话的 AI 语音智能体。
文档分为四个选项卡：

<CardGroup cols={2}>
  <Card title="指南" icon="book" href="/zh/quickstart-dashboard">
    面向控制台和 API 的快速入门、概念说明及操作指南。
    如果您刚开始使用，请从**这里开始**。
  </Card>

  <Card title="API 参考" icon="code" href="/api-reference/introduction">
    每个端点、请求字段和响应结构。
  </Card>

  <Card title="小组件" icon="window-maximize" href="/zh/widget/overview">
    可嵌入的网页小组件——React 组件、无头 Hook 和
    CDN 脚本标签。
  </Card>

  <Card title="Webhook" icon="bolt" href="/zh/webhooks/overview">
    实时事件、签名和投递语义。
  </Card>
</CardGroup>

## 您可以构建的内容

<CardGroup cols={2}>
  <Card title="呼入电话支持" icon="phone">
    使用遵循您的提示词、调用您的工具，并在需要时转接人工的 AI 智能体，
    接听您拥有的号码来电。
  </Card>

  <Card title="外呼活动" icon="arrow-up-right">
    通过您的代码以编程方式拨打电话——用于问卷调查、跟进或
    确认流程。
  </Card>

  <Card title="浏览器内语音" icon="microphone">
    将我们的可嵌入[网页小组件](/zh/guides/embed-web-widget)添加到您的
    网站，让客户点击通话。无需电话号码。
  </Card>

  <Card title="测试驱动型智能体" icon="flask">
    通过[批量测试](/api-reference/test-calls)让预设场景运行于您的智能体，
    从而在客户听到问题之前发现回归问题。
  </Card>
</CardGroup>

## 两种开始方式

**在控制台中**（建议用于您的第一个智能体）——注册后，
控制台会引导您完成五步设置向导：创建智能体、设置账单、添加电话号码、
运行模拟，以及查看通话。 [控制台快速入门](/zh/quickstart-dashboard)
会逐步对应这一向导。

**通过终端**——[API 快速入门](/zh/quickstart)通过四个 REST 调用完成
同样的首次通话。

<Steps>
  <Step title="浏览概念">
    [概念](/zh/guides/concepts)——您将接触的每个对象的概览，
    以及它们在控制台中的位置。
  </Step>

  <Step title="运行快速入门">
    [控制台快速入门](/zh/quickstart-dashboard)或
    [API 快速入门](/zh/quickstart)——使用 AI
    智能体完成您的首次通话。
  </Step>

  <Step title="选择指南">
    根据您的场景遵循一份[操作指南](/zh/guides/build-an-agent)，
    或深入了解
    [API 参考](/api-reference/introduction)。
  </Step>
</Steps>

## 浏览指南

<CardGroup cols={2}>
  <Card title="使用控制台" icon="table-columns" href="/zh/guides/build-an-agent">
    构建智能体、充值、获取号码、模拟和查看通话。
  </Card>

  <Card title="连接工具和数据" icon="plug" href="/zh/guides/connect-apps">
    OAuth 应用、自定义 API、MCP 服务器和 VoIP 服务提供商。
  </Card>

  <Card title="分析和改进" icon="chart-line" href="/zh/guides/reports">
    报告、可观测性、实验、问题和告警。
  </Card>

  <Card title="团队和账户" icon="users" href="/zh/guides/invite-your-team">
    邀请和角色、API 密钥、安全性和 SSO。
  </Card>
</CardGroup>

## 基础 URL

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

身份验证使用标准 OAuth 2.0 Bearer 方案，并搭配
`sk_live_` 组织 API 密钥。您的密钥会自动识别目标
组织——URL 路径中无需包含组织 ID。详情请参阅
[身份验证](/api-reference/introduction)。

<Note>
  需要帮助？请发送邮件至 [support@thunderphone.com](mailto:support@thunderphone.com)。
</Note>
