---
title: "Обработвайте входящи обаждания (API)"
description: "От край до край: конфигурирайте агент, задайте му телефонен номер, приемете обаждане и прегледайте транскрипта."
---

<Note>
  Изграждате първия си агент ръчно? Таблото за управление ви превежда през
  точно този процес — изграждане на агента, добавяне на номер, симулация, преглед — с
  воден съветник. Започнете от
  [бързото начало в таблото за управление](/bg/quickstart-dashboard).
</Note>

Стандартният процес „отговорете на обаждане с AI“ от вашия терминал.
Ще:

1. Създадете агент с подкана и глас.
2. Осигурите (или добавите свой) телефонен номер и ще зададете агента като негов
   обработващ входящите обаждания.
3. Ще се обадите на номера. Ще прегледате дневника на обажданията, транскрипцията и записа.

Общо API извиквания: четири. Общо време: под пет минути.

## 1. Създайте агент

Агентът обединява подканата, гласа и продуктовото ниво, които ще обработват
обаждането. Вижте [Агенти](/api-reference/agents) за всички полета за конфигуриране;
минималното необходимо е:

```bash
curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "spark"
  }'
```

Запазете върнатото `id` — ще ви трябва в стъпка 2.

<Tip>
  Изберете `spark` за прости въпроси и отговори на най-ниска цена, `bolt`, когато
  скоростта е най-важна. Надстройте до `storm-base-with-ack`, когато подканата ви
  изисква по-задълбочено разсъждение и може да търпи половинсекундна запълваща реплика,
  докато моделът мисли. Вижте
  [продуктови нива](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Вземете телефонен номер

Ако просто ви е нужен номер, на който да се обаждате, вземете номер на ThunderPhone
от пула на ThunderPhone:

```bash
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'
```

Отговорът включва `id` и `number` във формат E.164. Номерата на ThunderPhone
започват със `status="provisioning"` и стават `active` в рамките на няколко
секунди — извършвайте периодични заявки към
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number),
за да следите промяната, ако е необходимо.

<Note>
  Номерата на ThunderPhone са само за входящи обаждания. За изходящи обаждания
  [добавете свои номера чрез VoIP](/bg/guides/bring-your-own-numbers).
</Note>

## 3. Задайте агента

Свържете агента от стъпка 1 с входящата посока на номера:

```bash
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'
```

Това е всичко — номерът е активен. Можете също да зададете `outbound_agent_id`
в същата PATCH заявка, така че номерът да е готов и за изходящи обаждания.

## 4. Приемете обаждане

Наберете номера от телефона си. Агентът отговаря, представя се според
вашата подкана и разговорът започва.

Докато обаждането е активно, то се показва в
[`GET /v1/calls`](/api-reference/calls#list-calls) със
`status="in_progress"`. Когато приключи, записът се актуализира с
`end_reason`, `duration_seconds`, `billable_minutes` и (впоследствие)
URL адрес за запис и AI оценка.

## 5. Прегледайте резултатите

Извлечете списъка със скорошни обаждания:

```bash
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Вземете транскрипцията:

```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

И URL адреса на записа (краткотраен, подписан):

```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Ако сте се абонирали за
[`telephony.complete` webhook](/bg/webhooks/events),
ще получите същите данни като POST заявка към вашия сървър — вижте
[call.complete](/bg/webhooks/call-complete).

---

## Следващи стъпки

<CardGroup cols={2}>
  <Card title="Динамична конфигурация за всяко обаждане" icon="bolt" href="/bg/guides/dynamic-call-config">
    Изберете различен агент за всеки обаждащ се въз основа на телефонния номер или
    персонализирана логика в уебхук.
  </Card>
  <Card title="Добавяне на интеграции с инструменти" icon="screwdriver-wrench" href="/bg/guides/build-tool-integration">
    Позволете на агента да извиква вашите API по време на разговора.
  </Card>
  <Card title="Прехвърляне на обаждания" icon="phone-arrow-right" href="/bg/guides/call-transfers">
    Насочвайте обаждащите се директно или проверявайте получателя, преди да ги свържете.
  </Card>
  <Card title="Получаване на уебхукове call.complete" icon="bolt" href="/bg/webhooks/call-complete">
    Предавайте всяко приключило обаждане към вашия CRM / аналитичен процес.
  </Card>
  <Card title="AI оценяване и отчети за проблеми" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Оценявайте автоматично всяко обаждане и насочвайте маркираните за преглед.
  </Card>
</CardGroup>