---
title: "Apstrādājiet ienākošos zvanus (API)"
description: "Pilns process: konfigurējiet balss aģentu, piesaistiet to tālruņa numuram, pieņemiet zvanu un pārskatiet transkriptu."
---
Vai pirmo balss aģentu veidojat manuāli? Informācijas panelis ved cauri tieši
šai plūsmai — izveidojiet aģentu, pievienojiet numuru, simulējiet, pārskatiet — ar
vadītu vedni. Sāciet ar
[informācijas paneļa ātro sākumceļvedi](/lv/quickstart-dashboard).
Standarta plūsma „atbildēt uz tālruni ar MI” no jūsu termināļa.
Jūs:
1. Izveidosiet aģentu ar uzvedni un balsi.
2. Nodrošināsiet (vai pievienosiet) tālruņa numuru un piešķirsiet aģentu kā tā
ienākošo zvanu apstrādātāju.
3. Piezvanīsiet uz numuru. Apskatīsiet zvanu žurnālu, transkripciju un ierakstu.
Kopējais API izsaukumu skaits: četri. Kopējais laiks: mazāk nekā piecas minūtes.
## 1. Izveidojiet aģentu
Balss aģents apvieno uzvedni, balsi un produkta līmeni, kas nodrošinās
zvanu. Balss aģentam varat arī iestatīt zvanu ierobežojumus, piemēram, `max_call_duration_seconds`
un `ring_duration_seconds`. Balss aģenti atbalsta arī `intro_clip`
un `intro_ring_count`, lai pirms balss aģenta uzrunas atskaņotu iepriekš ierakstītu ievadu un līdz diviem
zvana signāliem. Jaunajiem balss aģentiem ir nepieciešama arī laika josla. Ja jūsu balss aģents ir
daudzvalodu, varat iestatīt `language_switching`, lai noteiktu, vai tas pirms valodas maiņas jautā
vai pielāgojas zvanītāja valodai.
Visus konfigurācijas laukus skatiet sadaļā [Aģenti](/api-reference/agents); minimālā
konfigurācija ir:
```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"
}'
```
Saglabājiet atgriezto `id` — tas būs nepieciešams 2. darbībā.
Vienkāršiem jautājumiem un atbildēm par zemāko cenu izvēlieties `spark`, bet `bolt` —
kad vissvarīgākais ir ātrums. Pārejiet uz `storm-base-with-ack`, ja jūsu uzvednei
nepieciešama dziļāka spriešana un tā var pieļaut pussekundes aizpildījuma frāzi,
kamēr modelis domā. Skatiet
[produktu līmeņus](/api-reference/agents#product-tiers-at-a-glance).
## 2. Iegūstiet tālruņa numuru
Ja jums nepieciešams tikai numurs, uz kuru zvanīt, iegūstiet ThunderPhone numuru
no ThunderPhone numuru kopas:
```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"}'
```
Atbildē ir `id` un `number` E.164 formātā. ThunderPhone
numuru sākotnējais `status="provisioning"` kļūst par `active` dažu
sekunžu laikā — ja tas jums ir svarīgi, aptaujājiet
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number),
lai sekotu pārejai.
ThunderPhone numuri sākotnēji ir paredzēti tikai ienākošajiem zvaniem. Organizācijas administrators var pieprasīt
izejošo zvanu iespēju tālruņa numuru lapā. ThunderPhone manuāli izskata katru
pieprasījumu; pēc apstiprināšanas numuri var veikt zvanus un palaist
kampaņas. Klientu VoIP numuri netiek mainīti.
## 3. Piešķiriet aģentu
Saistiet 1. darbībā izveidoto aģentu ar numura ienākošo zvanu virzienu:
```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}'
```
Tas arī viss — numurs ir aktīvs. Kad jūsu organizācijai ir apstiprināti
izejošie zvani, tajā pašā PATCH varat iestatīt arī `outbound_agent_id`. Līdz
tam API noraida šo piešķiršanu ar `400`.
Ja ienākošos zvanus novirzāt, izmantojot konfigurācijas tīmekļa aizķeri, nevis fiksētu
`inbound_agent_id`, šis tīmekļa aizķeris tagad katram zvanam var atgriezt `timezone`
kopā ar `agent_id` un `variables`.
## 4. Pieņemiet zvanu
Zvaniet uz numuru no sava tālruņa. Aģents atbild, iepazīstina ar sevi
atbilstoši jūsu uzvednei, un sākas saruna.
Kamēr zvans notiek, tas ir redzams sadaļā
[`GET /v1/calls`](/api-reference/calls#list-calls) ar
`status="in_progress"`. Kad tas beidzas, ieraksts tiek atjaunināts ar
`end_reason`, `duration_seconds`, `billable_minutes` un (vēlāk)
ieraksta URL un MI novērtējumu.
Ienākošie zvani tiek ieskaitīti jūsu organizācijas
[vienlaicīgo zvanu limitā](/api-reference/introduction#call-limits) (pēc noklusējuma 20
aktīvi zvani, kas tiek koplietoti ar izejošajiem, tīmekļa un testa
zvaniem). Zvans, kas tiek saņemts, kad limits ir sasniegts, tiek noraidīts, pirms balss aģents
atbild, un pārtraukts; par to netiek iekasēta maksa, un tas tiek reģistrēts kā neveiksmīgs zvans
ar beigu iemeslu `concurrent_call_limit_reached`. Rakstiet uz support@thunderphone.com, ja jums
nepieciešams lielāks limits.
## 5. Pārbaudiet rezultātus
Iegūstiet pēdējo zvanu sarakstu:
```bash
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Iegūstiet transkriptu:
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Un ieraksta URL (īslaicīgs, parakstīts):
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Ja esat abonējis
[`telephony.complete` tīmekļa aizķeri](/lv/webhooks/events),
jūs saņemsiet tos pašus datus kā POST pieprasījumu savā serverī — skatiet
[call.complete](/lv/webhooks/call-complete).
Ja jūsu balss aģentam ir konfigurēti datu iegūšanas lauki, pabeigtā zvana datos
var būt iekļauti arī strukturēti iegūtie dati.
---
## Nākamās darbības
Izvēlieties atšķirīgu balss aģentu katram zvanītājam, pamatojoties uz tālruņa numuru vai
pielāgotu loģiku tīmekļa aizķerē.
Ļaujiet balss aģentam sarunas laikā izsaukt jūsu API.
Novirziet zvanītājus tieši vai pārbaudiet galamērķi pirms savienošanas.
Straumējiet katru pabeigto zvanu uz savu CRM / analītikas konveijeru.
Automātiski novērtējiet katru zvanu un novirziet atzīmētos zvanus pārskatīšanai.