---
title: "Obrada dolaznih poziva (API)"
description: "Od početka do kraja: konfigurirajte agenta, dodijelite ga telefonskom broju, primite poziv i pregledajte transkript."
---

<Note>
  Izrađujete svoj prvi agent ručno? Nadzorna ploča vodi Vas kroz isti
  postupak — izradite agenta, dodajte broj, simulirajte, pregledajte — uz
  vođeni čarobnjak. Počnite s
  [brzim početkom na nadzornoj ploči](/hr/quickstart-dashboard).
</Note>

Standardni tijek „odgovaranja na poziv uz AI” iz Vašeg terminala.
Vi ćete:

1. Izraditi agenta s uputom i glasom.
2. Nabaviti (ili prenijeti) telefonski broj i dodijeliti agenta kao
   obrađivača dolaznih poziva.
3. Nazvati broj. Pregledati zapis poziva, prijepis i snimku.

Ukupno API poziva: četiri. Ukupno vrijeme: manje od pet minuta.

## 1. Izradite agenta

Agent objedinjuje uputu, glas i razinu proizvoda koji će upravljati
pozivom. Pogledajte [Agenti](/api-reference/agents) za svako konfiguracijsko
polje; minimum je:

```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"
  }'
```

Spremite vraćeni `id` — trebat će Vam u koraku 2.

<Tip>
  Odaberite `spark` za jednostavna pitanja i odgovore uz najniži trošak,
  a `bolt` kada je brzina najvažnija. Nadogradite na `storm-base-with-ack`
  kada Vaša uputa zahtijeva dublje zaključivanje i može podnijeti
  pola sekunde ispune dok model razmišlja. Pogledajte
  [razine proizvoda](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Nabavite telefonski broj

Ako Vam je potreban samo broj za testno pozivanje, nabavite ThunderPhone broj
iz ThunderPhone fonda:

```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"}'
```

Odgovor uključuje `id` i `number` u formatu E.164. ThunderPhone
brojevi započinju u stanju `status="provisioning"` i postaju `active` unutar nekoliko
sekundi — periodično pozivajte
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number)
kako biste pratili prijelaz ako Vam je to potrebno.

<Note>
  ThunderPhone brojevi služe samo za dolazne pozive. Za odlazne pozive
  [prenesite vlastite brojeve putem VoIP-a](/hr/guides/bring-your-own-numbers).
</Note>

## 3. Dodijelite agenta

Povežite agenta iz koraka 1 s dolaznim smjerom broja:

```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}'
```

To je sve — broj je aktivan. Možete postaviti i `outbound_agent_id`
u istom PATCH zahtjevu kako bi broj bio spreman i za odlazne pozive.

## 4. Primite poziv

Nazovite broj sa svog telefona. Agent se javlja, predstavlja se
prema Vašoj uputi i razgovor počinje.

Dok je poziv u tijeku, prikazuje se u
[`GET /v1/calls`](/api-reference/calls#list-calls) sa
`status="in_progress"`. Kada završi, zapis se ažurira s
`end_reason`, `duration_seconds`, `billable_minutes` i (naknadno)
URL-om snimke i AI ocjenom.

## 5. Pregledajte rezultate

Dohvatite popis nedavnih poziva:

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

Dohvatite prijepis:

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

I URL snimke (kratkotrajan, potpisan):

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

Ako ste se pretplatili na
[`telephony.complete` webhook](/hr/webhooks/events),
primit ćete iste podatke kao POST zahtjev na svoj poslužitelj — pogledajte
[call.complete](/hr/webhooks/call-complete).

---

## Sljedeći koraci

<CardGroup cols={2}>
  <Card title="Dinamička konfiguracija po pozivu" icon="bolt" href="/hr/guides/dynamic-call-config">
    Odaberite drugog agenta za svakog pozivatelja na temelju telefonskog broja ili
    prilagođene logike u webhooku.
  </Card>
  <Card title="Dodajte integracije alata" icon="screwdriver-wrench" href="/hr/guides/build-tool-integration">
    Omogućite agentu da poziva vaše API-je usred razgovora.
  </Card>
  <Card title="Preusmjeravanje poziva" icon="phone-arrow-right" href="/hr/guides/call-transfers">
    Izravno usmjerite pozivatelje ili provjerite odredište prije njihova povezivanja.
  </Card>
  <Card title="Primajte webhookove call.complete" icon="bolt" href="/hr/webhooks/call-complete">
    Prenesite svaki završeni poziv u svoj CRM / analitički proces.
  </Card>
  <Card title="AI ocjenjivanje i izvješća o problemima" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Automatski ocijenite svaki poziv i usmjerite označene na pregled.
  </Card>
</CardGroup>