---
title: "Введение"
description: "Документация по запуску голосовых агентов в продакшене для реальных телефонных звонков и встраиваемых веб-виджетов: быстрые старты, руководства и полное справочное руководство по API ThunderPhone."
---

ThunderPhone позволяет создавать голосовых AI-агентов, которые совершают и принимают
реальные телефонные звонки и обеспечивают разговоры через микрофон на вашем сайте.
Документация разделена на четыре вкладки:

<CardGroup cols={2}>
  <Card title="Руководства" icon="book" href="/ru/quickstart-dashboard">
    Быстрый старт, основные понятия и инструкции для панели управления и API.
    **Начните здесь**, если вы новичок.
  </Card>
  <Card title="Справочник API" icon="code" href="/api-reference/introduction">
    Все эндпоинты, поля запросов и структуры ответов.
  </Card>
  <Card title="Виджет" icon="window-maximize" href="/ru/widget/overview">
    Встраиваемый веб-виджет — компонент React, headless-хук и
    тег CDN-скрипта.
  </Card>
  <Card title="Вебхуки" icon="bolt" href="/ru/webhooks/overview">
    События в реальном времени, подпись и семантика доставки.
  </Card>
</CardGroup>

## Что можно создать

<CardGroup cols={2}>
  <Card title="Поддержка входящих звонков" icon="phone">
    Отвечайте на звонки на принадлежащий вам номер с помощью AI-агента, который следует вашему
    промпту, использует ваши инструменты и при необходимости передаёт звонок человеку.
  </Card>
  <Card title="Исходящие кампании" icon="arrow-up-right">
    Совершайте программные звонки из своего кода — для опросов, повторных контактов или
    подтверждений.
  </Card>
  <Card title="Голосовое общение в браузере" icon="microphone">
    Добавьте наш встраиваемый [веб-виджет](/ru/guides/embed-web-widget) на свой
    сайт, чтобы клиенты могли нажать и начать разговор. Номер телефона не требуется.
  </Card>
  <Card title="Агенты с тестированием" icon="flask">
    Запускайте подготовленные сценарии через своего агента [пакетами](/api-reference/test-calls),
    чтобы выявлять регрессии до того, как их услышат клиенты.
  </Card>
</CardGroup>

## Два способа начать

**В панели управления** (рекомендуется для первого агента) — зарегистрируйтесь, и
панель управления проведёт вас через мастер настройки из пяти этапов: создайте
агента, настройте оплату, добавьте номер телефона, запустите симуляцию и проверьте
звонок. [Быстрый старт в панели управления](/ru/quickstart-dashboard) повторяет
этот мастер шаг за шагом.

**Из терминала** — [быстрый старт API](/ru/quickstart) выполняет тот же
первый звонок за четыре REST-вызова.

<Steps>
  <Step title="Просмотрите основные понятия">
    [Основные понятия](/ru/guides/concepts) — карта всех объектов, с которыми вы будете работать,
    и их расположение в панели управления.
  </Step>
  <Step title="Запустите быстрый старт">
    [Быстрый старт в панели управления](/ru/quickstart-dashboard) или
    [быстрый старт API](/ru/quickstart) — выполните первый звонок с AI-агентом.
  </Step>
  <Step title="Выберите руководство">
    Следуйте [практическому руководству](/ru/guides/build-an-agent) для
    своего сценария или изучите
    [справочник API](/api-reference/introduction).
  </Step>
</Steps>

## Обзор руководств

<CardGroup cols={2}>
  <Card title="Работа с панелью управления" icon="table-columns" href="/ru/guides/build-an-agent">
    Создайте агента, пополните баланс, получите номер, выполните симуляцию и проверьте звонки.
  </Card>
  <Card title="Подключение инструментов и данных" icon="plug" href="/ru/guides/connect-apps">
    OAuth-приложения, пользовательские API, MCP-серверы и VoIP-провайдеры.
  </Card>
  <Card title="Анализ и улучшение" icon="chart-line" href="/ru/guides/reports">
    Отчёты, наблюдаемость, эксперименты, проблемы и оповещения.
  </Card>
  <Card title="Команда и аккаунт" icon="users" href="/ru/guides/invite-your-team">
    Приглашения и роли, API-ключи, безопасность и SSO.
  </Card>
</CardGroup>

## Базовый URL

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

Для аутентификации используется стандартная схема OAuth 2.0 Bearer с
API-ключом организации `sk_live_`. Ваш ключ автоматически определяет целевую
организацию — идентификатор организации не используется в URL-путях. Подробнее см. в разделе
[Аутентификация](/api-reference/introduction).

<Note>
  Нужна помощь? Напишите по email: [support@thunderphone.com](mailto:support@thunderphone.com).
</Note>