---
title: "Tvarkykite įeinančius skambučius (API)"
description: "Nuo pradžios iki pabaigos: sukonfigūruokite agentą, priskirkite jį telefono numeriui, priimkite skambutį ir peržiūrėkite transkriptą."
---

<Note>
  Kuriate pirmąjį agentą rankiniu būdu? Valdymo skydelyje pateikiama ši tiksli
  eiga — sukurkite agentą, pridėkite numerį, imituokite, peržiūrėkite — naudojant
  vedlį. Pradėkite nuo
  [greitosios pradžios valdymo skydelyje](/lt/quickstart-dashboard).
</Note>

Kanoninis „atsiliepti į telefoną naudojant DI“ procesas iš jūsų terminalo.
Jūs:

1. Sukursite agentą su raginimu ir balsu.
2. Užsakysite (arba atsinešite) telefono numerį ir priskirsite agentą jo
   įeinančių skambučių tvarkytuvu.
3. Paskambinsite numeriu. Peržiūrėsite skambučių žurnalą, transkripciją ir įrašą.

Iš viso API užklausų: keturios. Bendra trukmė: mažiau nei penkios minutės.

## 1. Sukurkite agentą

Agentas apima raginimą, balsą ir produkto pakopą, kurie valdys
skambutį. Visus konfigūracijos laukus žr. [Agentai](/api-reference/agents);
mažiausiai reikia:

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

Išsaugokite grąžintą `id` — jo reikės 2 veiksme.

<Tip>
  Rinkitės `spark`, jei reikia paprastų klausimų ir atsakymų už mažiausią kainą,
  o `bolt` — kai svarbiausia greitis. Atnaujinkite į `storm-base-with-ack`, kai
  jūsų raginimui reikia gilesnio samprotavimo ir galite toleruoti pusės sekundės
  užpildą, kol modelis mąsto. Žr.
  [produkto pakopas](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Gaukite telefono numerį

Jei jums tiesiog reikia numerio, kuriuo galėtumėte skambinti, gaukite ThunderPhone
numerį iš ThunderPhone numerių fondo:

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

Atsakyme pateikiami `id` ir `number` E.164 formatu. ThunderPhone
numeriai iš pradžių turi `status="provisioning"` būseną ir per kelias
sekundes tampa `active` — jei reikia, stebėkite pokytį apklausdami
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number).

<Note>
  ThunderPhone numeriai skirti tik įeinantiems skambučiams. Norėdami skambinti išeinančiais
  skambučiais, [atsineškite savo numerius per VoIP](/lt/guides/bring-your-own-numbers).
</Note>

## 3. Priskirkite agentą

Susiekite 1 veiksme sukurtą agentą su numerio įeinančių skambučių kryptimi:

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

Viskas — numeris aktyvus. Tame pačiame PATCH taip pat galite nustatyti
`outbound_agent_id`, kad numeris būtų paruoštas ir išeinantiems skambučiams.

## 4. Priimkite skambutį

Paskambinkite numeriu iš savo telefono. Agentas atsilieps, prisistatys pagal
jūsų raginimą ir prasidės pokalbis.

Kol vyksta skambutis, jis rodomas
[`GET /v1/calls`](/api-reference/calls#list-calls) su
`status="in_progress"`. Jam pasibaigus, įrašas atnaujinamas nurodant
`end_reason`, `duration_seconds`, `billable_minutes` ir (vėliau)
įrašo URL bei DI įvertinimą.

## 5. Peržiūrėkite rezultatus

Gaukite naujausių skambučių sąrašą:

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

Gaukite transkripciją:

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

Ir įrašo URL (trumpalaikį, pasirašytą):

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

Jei užsiprenumeravote
[`telephony.complete` žiniatinklio kablį](/lt/webhooks/events),
tuos pačius duomenis gausite kaip POST užklausą į savo serverį — žr.
[call.complete](/lt/webhooks/call-complete).

---

## Tolesni veiksmai

<CardGroup cols={2}>
  <Card title="Dinaminė kiekvieno skambučio konfigūracija" icon="bolt" href="/lt/guides/dynamic-call-config">
    Parinkite skirtingą agentą kiekvienam skambinančiajam pagal telefono numerį arba
    tinkintą žiniatinklio kablio logiką.
  </Card>
  <Card title="Pridėkite įrankių integracijas" icon="screwdriver-wrench" href="/lt/guides/build-tool-integration">
    Leiskite agentui pokalbio metu iškviesti jūsų API.
  </Card>
  <Card title="Perkelkite skambučius" icon="phone-arrow-right" href="/lt/guides/call-transfers">
    Nukreipkite skambinančiuosius tiesiogiai arba prieš sujungdami patikrinkite gavėją.
  </Card>
  <Card title="Gaukite call.complete žiniatinklio kablius" icon="bolt" href="/lt/webhooks/call-complete">
    Perduokite kiekvieną užbaigtą skambutį į savo CRM / analizės srautą.
  </Card>
  <Card title="DI vertinimas ir problemų ataskaitos" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Automatiškai įvertinkite kiekvieną skambutį ir pažymėtus nukreipkite peržiūrai.
  </Card>
</CardGroup>