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

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

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

## Какво можете да създадете

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

## Два начина да започнете

**В таблото** (препоръчително за вашия първи агент) — регистрирайте се и
таблото ще ви преведе през петстъпков съветник за настройка: създайте
агент, настройте плащането, добавете телефонен номер, изпълнете симулация и прегледайте
разговора. [Краткото ръководство за таблото](/bg/quickstart-dashboard) следва
този съветник стъпка по стъпка.

**От вашия терминал** — [краткото ръководство за API](/bg/quickstart) извършва
същото първо обаждане с четири REST заявки.

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

## Разгледайте ръководствата

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

## Базов URL

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

Удостоверяването използва стандартната OAuth 2.0 Bearer схема с
`sk_live_` API ключ на организацията. Вашият ключ автоматично идентифицира целевата
организация — в URL пътищата няма org id. Вижте
[Удостоверяване](/api-reference/introduction) за подробности.

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