---
title: "Обрађујте долазне позиве (API)"
description: "Од почетка до краја: конфигуришите агента, доделите га броју телефона, примите позив и прегледајте транскрипт."
---

<Note>
  Правите свог првог агента ручно? Контролна табла Вас води кроз исти
  ток — направите агента, додајте број, симулирајте, прегледајте — уз
  вођени чаробњак. Почните од
  [брзог почетка на контролној табли](/sr/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-а](/sr/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](/sr/webhooks/events),
примићете исте податке као POST на Ваш сервер — погледајте
[call.complete](/sr/webhooks/call-complete).

---

## Следећи кораци

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