---
title: "Obravnava dohodnih klicev (API)"
description: "Od začetka do konca: konfigurirajte agenta, ga dodelite telefonski številki, sprejmite klic in preglejte prepis."
---

<Note>
  Prvega agenta ustvarjate ročno? Nadzorna plošča vas vodi skozi natanko
  ta potek — ustvarite agenta, dodate številko, simulirate, pregledate —
  z vodenim čarovnikom. Začnite pri
  [hitrem začetku na nadzorni plošči](/sl/quickstart-dashboard).
</Note>

Standardni potek »odgovorite na telefon z AI« iz terminala.
Izvedli boste:

1. Ustvarili agenta s pozivom in glasom.
2. Zagotovili (ali dodali lastno) telefonsko številko ter agenta dodelili kot
   obravnavalca dohodnih klicev.
3. Poklicali številko. Pregledali dnevnik klicev, prepis in posnetek.

Skupno število klicev API: štirje. Skupni čas: manj kot pet minut.

## 1. Ustvarite agenta

Agent združuje poziv, glas in raven izdelka, ki bodo vodili
klic. Za vsa konfiguracijska polja glejte [Agenti](/api-reference/agents);
najmanj potrebujete:

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

Shranite vrnjeni `id` — potrebovali ga boste v 2. koraku.

<Tip>
  Za preprosta vprašanja in odgovore z najnižjimi stroški izberite `spark`,
  kadar je najpomembnejša hitrost, pa `bolt`. Nadgradite na
  `storm-base-with-ack`, kadar vaš poziv potrebuje poglobljenejše sklepanje in
  lahko prenese polsekundni zapolnitveni govor, medtem ko model razmišlja. Glejte
  [ravni izdelkov](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Pridobite telefonsko številko

Če potrebujete le številko za klicanje, pridobite številko ThunderPhone
iz nabora 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"}'
```

Odgovor vključuje `id` in `number` v obliki E.164. Številke ThunderPhone
se začnejo s `status="provisioning"` in v nekaj sekundah postanejo `active` —
če želite spremljati prehod, preverjajte
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number).

<Note>
  Številke ThunderPhone so samo za dohodne klice. Za odhodne klice
  [dodajte lastne številke prek VoIP](/sl/guides/bring-your-own-numbers).
</Note>

## 3. Dodelite agenta

Agenta iz 1. koraka povežite z dohodno smerjo številke:

```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 vse — številka je aktivna. V istem zahtevku PATCH lahko nastavite tudi
`outbound_agent_id`, da bo številka pripravljena tudi za odhodne klice.

## 4. Sprejmite klic

S telefona pokličite številko. Agent se oglasi, se predstavi skladno z
vašim pozivom in pogovor se začne.

Med potekom klica je prikazan v
[`GET /v1/calls`](/api-reference/calls#list-calls) s
`status="in_progress"`. Ko se konča, se zapis posodobi z
`end_reason`, `duration_seconds`, `billable_minutes` in (sčasoma)
URL-jem posnetka ter oceno AI.

## 5. Preglejte rezultate

Pridobite seznam nedavnih klicev:

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

Pridobite prepis:

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

In URL posnetka (kratkotrajno veljaven, podpisan):

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

Če ste naročeni na
[spletni kavelj `telephony.complete`](/sl/webhooks/events),
boste iste podatke prejeli kot POST na svoj strežnik — glejte
[call.complete](/sl/webhooks/call-complete).

---

## Naslednji koraki

<CardGroup cols={2}>
  <Card title="Dinamična konfiguracija za posamezen klic" icon="bolt" href="/sl/guides/dynamic-call-config">
    Glede na telefonsko številko ali logiko po meri v spletnem kavlju izberite drugega agenta za vsakega klicatelja.
  </Card>
  <Card title="Dodajte integracije orodij" icon="screwdriver-wrench" href="/sl/guides/build-tool-integration">
    Agentu omogočite, da med pogovorom kliče vaše API-je.
  </Card>
  <Card title="Preusmerite klice" icon="phone-arrow-right" href="/sl/guides/call-transfers">
    Klicatelje usmerite neposredno ali preverite cilj, preden jih povežete.
  </Card>
  <Card title="Prejemajte spletne kavlje call.complete" icon="bolt" href="/sl/webhooks/call-complete">
    Vsak zaključen klic pretakajte v svoj CRM ali analitični cevovod.
  </Card>
  <Card title="Ocenjevanje z UI in poročila o težavah" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Samodejno ocenite vsak klic in označene usmerite v pregled.
  </Card>
</CardGroup>