---
title: "Sissetulevate kõnede haldamine (API)"
description: "Täislahendus: seadista häälagent, määra see telefoninumbrile, võta kõne vastu ja vaata transkripti."
---

<Note>
  Kas ehitad oma esimest agenti käsitsi? Töölaud juhendab sind selles täpses
  voos — ehita agent, lisa number, simuleeri, vaata üle — juhendatud
  viisardi abil. Alusta
  [töölaua kiirstardiga](/et/quickstart-dashboard).
</Note>

Kanoniline „vasta telefonile AI abil“ voog sinu terminalist.
Sa:

1. lood agendi viiba ja häälega;
2. hangid (või tood kaasa) telefoninumbri ning määrad agendi selle
   sissetulevate kõnede töötlejaks;
3. helistad numbrile. Vaata kõnelogi, transkriptsiooni ja salvestist.

API-kõnesid kokku: neli. Aega kokku: alla viie minuti.

## 1. Loo agent

Agent koondab viiba, hääle ja tootetaseme, mis kõnet juhivad.
Kõigi seadistusväljade kohta vaata [agente](/api-reference/agents); miinimum on:

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

Salvesta tagastatud `id` — vajad seda 2. etapis.

<Tip>
  Vali lihtsate küsimuste ja vastuste jaoks väikseima kuluga `spark`, kui kiirus
  on kõige olulisem, vali `bolt`. Kasuta taset `storm-base-with-ack`, kui sinu viip
  vajab põhjalikumat arutlust ja talub mudeli mõtlemise ajal poole sekundi pikkust
  täitefraasi. Vaata
  [tootetasemeid](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Hangi telefoninumber

Kui vajad lihtsalt numbrit, millele helistada, hangi ThunderPhone'i number
ThunderPhone'i numbripargist:

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

Vastus sisaldab E.164 vormingus `id`-d ja `number`-it. ThunderPhone'i
numbrite algne `status="provisioning"` muutub mõne sekundi jooksul väärtuseks
`active` — kui see on oluline, jälgi muutust päringuga
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number).

<Note>
  ThunderPhone'i numbrid on ainult sissetulevate kõnede jaoks. Väljuvate kõnede
  tegemiseks [too oma numbrid VoIP-i kaudu](/et/guides/bring-your-own-numbers).
</Note>

## 3. Määra agent

Seo 1. etapis loodud agent numbri sissetuleva kõnesuunaga:

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

See ongi kõik — number on aktiivne. Samas PATCH-päringus saad määrata ka
`outbound_agent_id`, et number oleks valmis ka väljuvateks kõnedeks.

## 4. Võta kõne vastu

Helista numbrile oma telefonist. Agent vastab, tutvustab end vastavalt sinu
viibale ja vestlus algab.

Kõne ajal kuvatakse see päringus
[`GET /v1/calls`](/api-reference/calls#list-calls) olekuga
`status="in_progress"`. Kui kõne lõpeb, uuendatakse kirjet väljadega
`end_reason`, `duration_seconds`, `billable_minutes` ning (hiljem)
salvestise URL-i ja AI-hindega.

## 5. Kontrolli tulemusi

Too hiljutiste kõnede loend:

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

Too transkriptsioon:

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

Ja salvestise URL (lühiajaline, allkirjastatud):

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

Kui tellisid
[`telephony.complete` veebikonksu](/et/webhooks/events),
saad samad andmed POST-päringuna oma serverisse — vaata
[call.complete](/et/webhooks/call-complete).

---

## Järgmised sammud

<CardGroup cols={2}>
  <Card title="Dünaamiline kõnepõhine konfiguratsioon" icon="bolt" href="/et/guides/dynamic-call-config">
    Vali telefoninumbri või veebikonksu kohandatud loogika põhjal igale helistajale erinev agent.
  </Card>
  <Card title="Lisa tööriistade integratsioone" icon="screwdriver-wrench" href="/et/guides/build-tool-integration">
    Luba agendil vestluse ajal sinu API-sid kutsuda.
  </Card>
  <Card title="Kõnede suunamine" icon="phone-arrow-right" href="/et/guides/call-transfers">
    Suuna helistajad otse edasi või kontrolli sihtkohta enne ühendamist.
  </Card>
  <Card title="Võta vastu call.complete'i veebikonksud" icon="bolt" href="/et/webhooks/call-complete">
    Edasta iga lõpetatud kõne oma CRM-i või analüüsitöötlusse.
  </Card>
  <Card title="Tehisintellekti hindamine ja probleemiaruanded" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Hinda iga kõnet automaatselt ja suuna märgistatud kõned ülevaatamisele.
  </Card>
</CardGroup>