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

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

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

## Що можна створити

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

## Два способи почати

**У панелі керування** (рекомендовано для вашого першого агента) — зареєструйтеся, і
панель керування проведе вас через майстер налаштування з п’яти кроків: створіть
агента, налаштуйте оплату, додайте номер телефону, запустіть симуляцію та перегляньте
дзвінок. [Швидкий старт панелі керування](/uk/quickstart-dashboard) повторює
цей майстер крок за кроком.

**У терміналі** — [швидкий старт API](/uk/quickstart) проводить через
той самий перший дзвінок за чотири REST-виклики.

<Steps>
  <Step title="Ознайомтеся з концепціями">
    [Концепції](/uk/guides/concepts) — карта кожного об’єкта, з яким ви працюватимете,
    і місце кожного з них у панелі керування.
  </Step>
  <Step title="Запустіть швидкий старт">
    [Швидкий старт панелі керування](/uk/quickstart-dashboard) або
    [швидкий старт API](/uk/quickstart) — здійсніть свій перший дзвінок за допомогою AI-агента.
  </Step>
  <Step title="Виберіть посібник">
    Дотримуйтесь [практичного посібника](/uk/guides/build-an-agent) для
    свого сценарію або перейдіть до
    [довідника API](/api-reference/introduction).
  </Step>
</Steps>

## Перегляд посібників

<CardGroup cols={2}>
  <Card title="Використання панелі керування" icon="table-columns" href="/uk/guides/build-an-agent">
    Створіть агента, поповніть баланс, отримайте номер, змоделюйте та перегляньте дзвінки.
  </Card>
  <Card title="Підключення інструментів і даних" icon="plug" href="/uk/guides/connect-apps">
    Застосунки OAuth, власні API, сервери MCP і постачальники VoIP.
  </Card>
  <Card title="Аналіз і вдосконалення" icon="chart-line" href="/uk/guides/reports">
    Звіти, спостережуваність, експерименти, проблеми та сповіщення.
  </Card>
  <Card title="Команда й обліковий запис" icon="users" href="/uk/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>
  Потрібна допомога? Напишіть на [support@thunderphone.com](mailto:support@thunderphone.com).
</Note>
