---
title: "Keskeiset käsitteet"
description: "Kartta kaikesta alustalla — mitä kukin objekti tekee, missä se sijaitsee hallintapaneelissa ja mitä APIa se koskee."
---
ThunderPhone on kattava alusta AI-puheagenttien rakentamiseen, käyttämiseen ja parantamiseen. Tämä sivu on kartta: jokainen kohtaamasi käsite omassa lyhyessä osiossaan sekä hallintanäkymä ja sitä tukeva API. Selaa sivu kerran läpi ja palaa siihen aina, kun jokin termi kaipaa selitystä.
Hallintanäkymän sivupalkki noudattaa tätä rakennetta:
[Agentit](#agents), [äänet](#voices), [puhelinnumerot](#phone-numbers),
[verkkosivuwidgetit](#web-widgets), [puhelut](#calls),
[asiakasportaalit](#client-portals), [tietopankit](#knowledge-bases).
[Reaaliaikainen seuranta](#live-monitoring) ja lähtevät
[kampanjat](#campaigns).
[Sovellukset, API:t, MCP-palvelimet ja VoIP-palveluntarjoajat](#connections), joita
agenttisi voivat käyttää.
[Simulaatiot](#simulations), [validointijoukot](#validation-sets),
[kokeilut](#experiments),
[ongelmat](#issues), [raportit](#reports),
[havainnoitavuus](#observability).
[Tiimi ja roolit](#team-and-roles), [API-avaimet](#organizations),
[hälytykset](#alerts), [laskutus](#billing).
[Webhookit](#webhooks) ja [funktiotyökalut](#function-tools)
omaa koodiasi varten.
---
## Organisaatiot
**Organisaatio** on eriytetyn käyttöympäristön yksikkö. Jokainen muu resurssi —
agentit, puhelinnumerot, puhelut ja avaimet — kuuluu täsmälleen yhteen organisaatioon. Tilisi
voi kuulua useisiin organisaatioihin; jokaisella on oma saldonsa, omat
avaimensa ja oma jäsenluettelonsa.
**Organisaatio → Avaimet** -kohdassa luomasi `sk_live_`-API-avain on
sidottu yhteen organisaatioon. Tämä sidonta tekee REST API:sta niin
yksinkertaisen: organisaation tunnusta ei koskaan lisätä URL-polkuun, koska
avaimesi tunnistaa sen jo.
**Hallintanäkymässä:** organisaatiovalitsin (sivupalkin alareunassa) ja
**Organisaatio**-asetukset — välilehdet Oma tili, Yleiset, Avaimet, Hälytykset,
Laskutusasetukset ja Laskutushistoria. Katso
[organisaatioasetusten viite](/fi/guides/organization-settings).
**API:ssa:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
---
## Agentit
**Agentti** on puhelua suorittava AI-määritys. Se sisältää:
- **Kehotteen**, joka määrittää, mitä agentti sanoo ja miten se toimii —
mukaan lukien puhelutoiminnot, kuten puhelunsiirrot, näppäinpainallukset ja puhelun lopetukset,
jotka ovat tavallisia kehotteen rivejä erillisen määrityksen sijaan.
- **Moottoritason** (`spark`, `bolt`, `storm-*`): Spark on optimoitu
kustannuksia varten, Bolt nopeutta varten ja Storm älykkyyttä varten monimutkaisissa kehotteissa.
- **Äänen** sekä **ensisijaisen kielen** ja valinnaiset **lisäkielet** —
agentti vaihtaa automaattisesti, kun soittaja vaihtaa kieltä. Katso [tuetut kielet](/fi/guides/supported-languages).
- Liitetyt ominaisuudet: [yhdistetyt sovellukset](#connections),
[API-yhteydet](#connections), [tietopankit](#knowledge-bases),
[MCP-palvelimet](#connections) ja upotetut
[funktiotyökalut](#function-tools).
- Toiminta-asetukset: puhejärjestys, kuittaustila, taustaraita,
pidon aikaraja.
Editorissa tehdyt muutokset **tallentuvat automaattisesti luonnokseen**; mikään ei siirry tuotantoon, ennen kuin
valitset **Ota käyttöön**. Jokainen käyttöönotto tallennetaan editorin
**Historia**-välilehdelle, joten voit tarkastella ja palauttaa minkä tahansa aiemman version.
**Hallintanäkymässä:** **Puheagentit** → agenttieditori
(`/dashboard/agents`). Katso
[rakenna ensimmäinen puheagenttisi](/fi/guides/build-an-agent).
**API:ssa:** [`/v1/agents`](/api-reference/agents) — CRUD,
kloonaus, siirto, versiohistoria ja kehotetyökalut.
---
## Äänet
**Äänikirjasto** sisältää äänet, joita agentti voi käyttää, niiden toistettavat
näytteet, yhteensopivat kielet, sukupuoli- ja aksenttiryhmittelyt sekä
mahdolliset premium-äänen tai -kielen lisämaksut. Maksullisella näytteenluonnilla voit syntetisoida oman 1–500
merkin mittaisen lauseen ennen valintaa.
Kelpoiset organisaatiot voivat myös luoda **mukautettuja ääniä** lyhyestä WAV- tai
MP3-näytteestä. Mukautetuilla äänillä on kiintiö ja asynkroninen luontitila; kun ne ovat
valmiita, ne näkyvät samassa agenttivalitsimessa kuin kirjaston äänet.
**Hallintapaneelissa:** **Äänet** (`/dashboard/voices`). Katso
[Äänikirjasto ja mukautetut äänet](/fi/guides/voice-library).
**API:ssa:** [`/v1/voices`](/api-reference/voices),
[ääninäytteet](/api-reference/voice-samples) ja
[mukautetut äänet](/api-reference/custom-voices).
---
## Puhelinnumerot
**Puhelinnumero** kuuluu organisaatiolle ja reitittää saapuvat puhelut
agentille (ja voi välittää lähteviä puheluita). Kaksi lähdettä:
- **ThunderPhone-numerot** — ThunderPhonen numerovarannosta käyttöönotetut aidot yhdysvaltalaiset numerot, jotka aktivoituvat sekunneissa. {/* rate:phone */}$1/kuukausi sekä 1 ¢/minuutti{/* /rate */} lisämaksu. Aluksi ne tukevat vain saapuvia puheluja. Organisaation ylläpitäjä voi pyytää lähteviä puheluja Phone Numbers -sivulta; ThunderPhone tarkistaa jokaisen pyynnön manuaalisesti, ja hyväksytyillä numeroilla voi soittaa puheluja ja toteuttaa kampanjoita. Organisaatiolla voi oletusarvoisesti olla 25 numeroa.
- **VoIP-numerot** — tuodaan omalta palveluntarjoajaltasi [VoIP-yhteyden](#connections) kautta. Twilio ja Telnyx yhdistetään suoraan API-avaimella (Telnyxillä on myös ohjattu uuden tilin käyttöönotto); SignalWire, Vonage, Plivo ja muut SIP-rungot yhdistetään SIP-asetuksella, joka on manuaalinen SIP-määritys. Kun VoIP-numerot on tuotu ja vahvistettu, ne tukevat saapuvia ja lähteviä puheluja.
Jokaisella numerorivillä voit määrittää reititystilan, valita saapuvan puhelun agentin
ja nimetä numeron.
**Hallintapaneelissa:** **Puhelinnumerot** (`/dashboard/phone-numbers`).
Katso [Hanki puhelinnumero](/fi/guides/get-a-phone-number).
**API:ssa:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/phone-number-labels).
---
## Puhelut
Jokaisesta saapuvasta puhelusta, lähtevästä puhelusta, simulaatiosta ja widget-istunnosta
tulee **puheluloki**. Puheluloki sisältää täydellisen roolein merkityn litteroinnin,
jäsennellyn vuorohistorian (mukaan lukien työkalukutsut), tallenteen,
laskutuksen kokonaissumman sekä valinnaisen tekoälyarvioinnin ja ongelmaraportit.
Kun puhelu on **käynnissä**, voit avata sen ja **kuunnella puhelua** — liityt
hiljaa, eikä kukaan puhelussa kuule sinua. Kun kuuntelet puhelua, voit
**kuiskata**: kirjoita ohje, joka menee suoraan agentillesi
kesken puhelun; soittaja ei koskaan kuule sitä, ja agentti noudattaa sitä reaaliajassa.
**Hallintapaneelissa:** **Puheluhistoria** (`/dashboard/call-history`) sisältää
arkiston ja puhelukohtaiset tiedot; **Käynnissä** näyttää käynnissä olevat puhelut. Katso
[Tarkista, kuuntele ja ohjaa puheluitasi](/fi/guides/review-calls).
**API:ssa:** [`/v1/calls`](/api-reference/calls) — luettelo, litterointi,
historia, ääni, arviointi, vienti;
[`/v1/issue-reports`](/api-reference/issue-reports).
---
## Asiakasportaalit
**Asiakasportaali** on brändätty, vain luku -näkymä ulkoisen asiakkaan
puheluhistoriaan. Organisaation ylläpitäjät valitsevat agentit, joiden puhelut näkyvät, lisäävät hyväksyttyjen
katselijoiden sähköpostiosoitteet, lataavat logon ja tehostevärin sekä voivat halutessaan vahvistaa mukautetun
verkkotunnuksen. Portaalin katselijat voivat tarkastella puheluiden tietoja, litterointeja ja saatavilla olevia
tallenteita saamatta käyttöoikeutta hallintapaneeliin.
**Hallintapaneelissa:** **Asiakasportaalit** (`/dashboard/client-portals`). Katso
[Asiakasportaalit](/fi/guides/client-portals).
**API:ssa:** [`/v1/client-portals`](/api-reference/client-portals) on
ylläpidon hallintapinta.
## Verkko-widgetit
**Verkkowidget** tarjoaa sivustosi kävijöille mikrofonipohjaisen keskustelun
agentin kanssa — puhelinnumeroa ei tarvita. Se tunnistautuu
**julkaistavalla avaimella** (`pk_live_...`), jota selaimet voivat käyttää vain
sallituista verkkotunnuksistasi, joten sitä on turvallista käyttää asiakaspuolen koodissa. Verkkotunnusluettelo
ei ole tunnistautumista, ja sivun mahdollisesti lähettämät istuntoasetukset
ovat pois käytöstä, kunnes sallit ne avaimessa.
Avaimet toimivat kahdessa tilassa: `agent` (sidottu staattisesti yhteen agenttiin)
tai `webhook` (palvelimesi valitsee määrityksen kävijäkohtaisesti — katso
[Dynaaminen puhelukohtainen määritys](/fi/guides/dynamic-call-config)). Widget-istunnot
kulkevat saman puheluinfrastruktuurin kautta kuin puhelut.
**Hallintapaneelissa:** **Verkko-widgetit** (`/dashboard/web-widgets`) —
luo widgetejä, määritä tila ja agentti, hallitse sallittuja verkkotunnuksia ja
kopioi upotuskoodi. Katso
[Luo verkko-widget](/fi/guides/embed-a-web-widget-dashboard).
**API:ssa:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) ja
[Widget SDK -dokumentaatio](/fi/widget/overview).
---
## Tietopankit
**Tietopankki** on joukko asiakirjoja, joista agenttisi voi hakea tietoa
puhelun aikana vastauksiensa tueksi — lataa tiedostoja, liitä tekstiä tai tuo
verkkosivuja URL-osoitteella ja liitä sitten tietopankki agenttiin builderissa. Agentti
hakee siitä tietoa sisäänrakennetulla hakutyökalulla aina, kun
keskustelu sitä edellyttää.
**Hallintapaneelissa:** **Tieto** (`/dashboard/knowledge`) asiakirjakirjastoa varten;
builderin **Tieto**-osio tietopankin liittämiseen agenttiin. Katso
[Anna agentillesi tietopankki](/fi/guides/knowledge-base).
---
## Yhteydet
Yhteyksien avulla agentit tavoittavat ulkomaailman. Neljä tyyppiä, yksi
sivupalkkiryhmä:
- **Sovellukset** (`/dashboard/app-connections`) — OAuth-yhteydet
Slackiin, HubSpotiin, Salesforceen, Google Kalenteriin, Google Sheetiin ja
Cal.comiin. Yhdistä kerran ja ota sitten käyttöön toimintokohtaiset työkalut
(lähetä Slack-viesti, lisää tai päivitä HubSpot-yhteyshenkilö, varaa Cal.com-aika…)
mille tahansa agentille. Katso [Yhdistä sovelluksia](/fi/guides/connect-apps).
- **API-rajapinnat** (`/dashboard/api-connections`) — muuta mikä tahansa HTTP API
agenttitoiminnoksi. Liitä cURL-komento, niin AI-avustaja luonnostelee työkalun
määritelmän, tai rakenna se manuaalisesti; **Testaa pyyntö** -painike tekee
eristetyn testikutsun ennen käyttöönottoa. Katso
[API-yhteydet](/fi/guides/api-connections) — hallintapaneelin vastine
rajapinnalle [`/v1/integrations`](/api-reference/integrations).
- **MCP** (`/dashboard/mcp-connections`) — lisää Model Context
Protocol -palvelin URL-osoitteella ja anna agentin käyttää sen tarjoamia työkaluja.
Katso [Lisää MCP-palvelin](/fi/guides/mcp-servers).
- **VoIP** (`/dashboard/voip-connections`) — palveluntarjoajan tunnistetiedot
[omien puhelinnumeroiden käyttöön](#phone-numbers). Katso
[Yhdistä VoIP-palveluntarjoaja](/fi/guides/voip-providers).
ThunderPhone tarjoaa myös oman MCP-päätepisteensä, jotta ulkoinen MCP-asiakas voi
luetteloida agentteja, tarkastella puheluita ja litterointeja sekä soittaa puheluita. Katso
[Käytä ThunderPhonea MCP-palvelimena](/fi/guides/thunderphone-mcp-server).
**API:ssa:** [`/v1/integrations`](/api-reference/integrations),
[`/v1/mcp-servers`](/api-reference/mcp-servers) ja
[`/v1/voip-connections`](/api-reference/voip-connections); katso myös
[Rakenna työkalun integraatio](/fi/guides/build-tool-integration).
---
## Kampanjat
**Kampanja** soittaa lähteviä puheluita laajassa mittakaavassa: lataa CSV-tiedosto
yhteyshenkilöistä, valitse agentti ja soittajan numero sekä määritä soittoikkuna
(päivät ja tunnit aikavyöhykkeet huomioiden), samanaikaisuus ja uudelleenyrityskäytäntö
(enimmäisyritykset ja uudelleen yritettävät tulokset — ei vastausta, vastaaja, epäonnistui).
Kampanja käy listan läpi ja tallentaa jokaisen puhelun Puheluhistoriaan.
**Hallintapaneelissa:** **Kampanjat** (`/dashboard/campaigns`). Katso
[Suorita lähtevien puheluiden kampanja](/fi/guides/outbound-campaigns).
**Yksittäisiä ohjelmallisia puheluita varten:**
[lähtevien puheluiden API](/fi/guides/place-outbound-calls).
## Reaaliaikainen seuranta
**Reaaliaikainen** näyttää kaikki organisaation käynnissä olevat puhelut ja
antaa sinun avata minkä tahansa niistä, jotta voit [kuunnella ja kuiskata](#calls)
reaaliajassa. Se on valvontanäkymä: seuraa, kun uusi kehote saa ensimmäisen
oikean liikenteensä, tai pidä silmällä käynnissä olevaa kampanjaa.
**Hallintapaneelissa:** **Reaaliaikainen** (`/dashboard/live`). Katso
[Katso ja valvo reaaliaikaisia puheluita](/fi/guides/monitor-live-calls).
---
## Simulaatiot
**Simulaatio** on tekoälysoittaja, joka käy oikean keskustelun agenttisi kanssa
— sama puhelinliikenteen reitti, oikea transkriptio, oikea arviointi — joten
voit testata ennen julkaisua ja sen jälkeen. Kohdista se agenttiin tai
puhelinnumeroon, kirjoita soittajan skenaario itse tai **luo skenaarioita
tekoälyn avulla** agentin kehotteen perusteella (myös reunatapaukset, jos
pyydät niitä) ja seuraa puhelua reaaliajassa.
Skenaariot ryhmitellään **testisviiteiksi**, jotka määrittävät
vähimmäishyväksyntäasteen ja voivat estää julkaisuja CI:ssä; regressiot
hyväksyttyyn vertailutasoon nähden raportoidaan skenaariokohtaisesti.
**Hallintapaneelissa:** **Simulaatiot** (`/dashboard/simulations`) sekä
agenttityökalun **Simulaatio**-painike. Katso
[Simuloi puhelu](/fi/guides/simulate-a-call).
**API:ssa:** [`/v1/test-calls`](/api-reference/test-calls) ja
testisviitin ajaja — katso [Testaa agentti päästä päähän](/fi/guides/test-agents).
---
## Validointijoukot
**Validointijoukko** muuntaa oikeiden puhelujen hetket toistettaviksi yhden
vuoron regressiotarkistuksiksi. Jokainen esimerkki lukitsee keskustelukontekstin,
olennaisen soittajan äänen, alkuperäisen vastauksen ja odotetun toiminnan.
Toistot suoritetaan nykyistä agenttiluonnosta vasten ilman uuden puhelun
soittamista, ja julkaisun valintaikkuna voi näyttää, vastaako viimeisin ajo yhä
tätä luonnosta.
**Hallintapaneelissa:** **Validointijoukot** (`/dashboard/validation`)
organisaation tietojoukolle sekä agenttityökalun **Validointi**-välilehti
ajoille. Katso [Validointijoukot](/fi/guides/validation-sets).
**API:ssa:** [`/v1/validation-sets`](/api-reference/validation-sets) sekä
agentin ja esimerkin toistopäätepisteet samalla viitesivulla.
---
## Kokeilut
**Kokeilu** tekee A/B-testin agentin määrityksille reaaliaikaisessa liikenteessä:
määritä variantit (eri kehotteet, moottorit tai asetukset), jaa liikenne niiden
välillä ja vertaile tuloksia varianttikohtaisesti. Käytä tätä sen sijaan, että
toteuttaisit ryhmälogiikan itse webhookissa.
**Hallintapaneelissa:** **Kokeilut** (`/dashboard/experiments`) sekä
agenttityökalun **A/B**-välilehti. Katso
[Kokeilut (A/B-testaus)](/fi/guides/experiments-ab-testing).
---
## Ongelmat
**Ongelma** on tiettyyn puheluun merkitty ongelma — joko ihmisarvioijan kirjaama
tai tekoälyarvioinnin havaitsema. Ongelmiin liittyy vakavuus, lähde ja tila, ja
Ongelmat-sivu toimii arviointijonona: suodata, tarkastele ongelmallista puhelua
ja seuraa korjauksia.
**Hallintapaneelissa:** **Ongelmat** (`/dashboard/issues`) sekä puhelukohtainen
merkintä Puheluhistoriassa. Katso [Ongelmien arviointi](/fi/guides/issues).
**API:ssa:** [`/v1/issue-reports`](/api-reference/issue-reports).
---
## Raportit
**Raportti** vastaa puheludataasi koskevaan luonnollisen kielen kysymykseen
("Mitkä olivat kolme yleisintä syytä, joiden vuoksi soittajat pyysivät ihmistä
viime viikolla?") tekoälyn kirjoittamalla analyysilla, joka rajataan valitsemiisi
agentteihin ja ajanjaksoon.
**Hallintapaneelissa:** **Raportit** (`/dashboard/reports`). Katso
[Raportit](/fi/guides/reports).
---
## Havainnoitavuus
**Havainnoitavuus** on mittarinäkymä: puhelumäärä, tulokset ja laatu ajan
myötä. Voit suodattaa niitä agentin ja aikaikkunan mukaan sekä viedä tiedot
jatkoanalyysia varten.
**Hallintapaneelissa:** **Havainnoitavuus** (`/dashboard/observability`).
Katso [Havainnoitavuus](/fi/guides/observability).
---
## Hälytykset
**Hälytyssääntö** seuraa mittaria (onnistumisaste, epäonnistumisaste,
keskimääräinen piste, puhelumäärä, testisviittien regressiot) aikaikkunan
aikana ja laukeaa, kun se ylittää määrittämäsi kynnyksen. Ilmoitukset lähetetään
sähköpostiin ja Slackiin, ja sääntö laukaisee `alert.triggered`-tapahtuman
[webhook-päätepisteisiisi](/fi/webhooks/endpoints).
**Hallintapaneelissa:** **Organisaatio → Hälytykset**. Katso
[Hälytykset](/fi/guides/alerts).
---
## Webhookit
ThunderPhone lähettää palvelimellesi **HTTP POST -webhookeja**, kun puhelun aikana tai sen jälkeen tapahtuu asioita. Käytössä on kaksi toimitusmallia:
- **Webhook-päätepisteet** (suositeltu): hallitse useita URL-osoitteita
osoitteessa [`/v1/developer/webhook-endpoints`](/fi/webhooks/endpoints), jossa
jokaisella päätepisteellä on omat salaisuutensa ja tapahtumatilauksensa.
- **Vanha yhden URL-osoitteen webhook**: yksi URL-osoite organisaatiota kohden. Hallitaan
osoitteessa [`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
tai kohdassa **Organisaatio → Yleiset**. Säilytetty taaksepäin yhteensopivuuden vuoksi.
Tapahtumat jakautuvat kahteen luokkaan:
- **Estävät tapahtumat** odottavat palvelimesi vastaavan konfiguraatiolla,
joka muokkaa käynnissä olevaa puhelua — nämä ovat
[saapuvan puhelun tapahtumat](/fi/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Puhelu odottaa enintään
13 sekuntia, mukaan lukien yksi uudelleenyritys, ja widget-istunto 10 sekuntia.
Varapuheagenttia ei ole: ilman käyttökelpoista konfiguraatiota puhelu
katkaistaan ja widget-istunto epäonnistuu.
- **Ei-estävät tapahtumat** ovat kertaluonteisia ilmoituksia, joita yritetään
uudelleen eksponentiaalisella viiveellä — katso
[toimitussemantiikka](/fi/webhooks/overview).
Jokaisessa pyynnössä on aikaleimattu HMAC-SHA256-allekirjoitus otsakkeessa
`X-ThunderPhone-Signature-V2` sekä vanha vain rungon kattava
`X-ThunderPhone-Signature`. Katso
[allekirjoituksen vahvistus](/fi/webhooks/overview).
---
## Funktiotyökalut
**Funktiotyökalu** on HTTP-päätepiste, jota agenttisi voi kutsua
keskustelun aikana. Annat ThunderPhonelle OpenAI-tyylisen funktioskeeman
sekä päätepisteen URL-osoitteen; agentti päättää, milloin sitä kutsutaan,
ja ThunderPhone tekee allekirjoitetun HTTP-pyynnön palvelimiltaan ja palauttaa
tuloksen agentille.
Agentteihin sisältyy myös **sisäänrakennettuja puheluominaisuuksia** — puhelun
siirtäminen, näppäimistösyötteen (DTMF) lähettäminen, puhelun lopettaminen ja
pidossa odottaminen — jotka otat käyttöön pelkillä kehotteen riveillä
työkalumääritysten sijaan.
**Hallintapaneelissa:** rakentajan **API-yhteydet**-osio (katso
[Yhteydet](#connections)).
**API:ssa:** [`/v1/integrations`](/api-reference/integrations) ja
[Function Tools -määritys](/fi/tools/overview).
---
## Tiimi ja roolit
Jokaisella organisaatiolla on jäsenluettelo, jossa on kaksi roolia: **Jäsenet**
rakentavat ja käyttävät agentteja; **Järjestelmänvalvojat** hallitsevat lisäksi
tiimiä ja laskutusta. Kutsu sähköpostitse — kutsut vanhenevat 7 päivän kuluttua
ja ne voidaan peruuttaa; jäsenrivin ⋯-valikosta voit vaihtaa rooleja tai poistaa
henkilön. Kertakirjautuminen voidaan määrittää koko organisaatiolle — katso
[SSO](/fi/guides/sso).
**Hallintapaneelissa:** **Organisaatio → Yleiset**. Katso
[Kutsu tiimisi](/fi/guides/invite-your-team).
**API:ssa:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
---
## Laskutus
ThunderPhone on **ennakkomaksullinen**. Jokaisella organisaatiolla on
USD-saldo; puhelut veloittavat sitä agentin minuuttihinnalla (moottoritaso sekä
lisämaksut — rakentaja näyttää kokonaishinnan reaaliajassa, kun muutat asetuksia,
ja [valitut lisäkielet](/fi/guides/supported-languages) lisäävät {/* rate:language */}3¢/min{/* /rate */}). Kun
saldo saavuttaa nollan, saapuvat puhelut hylätään ja lähtevät puhelut palauttavat
vastauksen `402 Payment Required`.
Lisää saldoa manuaalisesti tai ota käyttöön **automaattinen saldon lisäys**
saldorajalla, lisäyssummalla ja valinnaisella kuukausittaisella kulutusrajalla —
jotta puhelu ei koskaan katkea kesken lauseen.
**Hallintapaneelissa:** **Organisaatio → Laskutusasetukset** ja
**Laskutushistoria**. Katso
[Lisää varoja ja ota automaattinen saldon lisäys käyttöön](/fi/guides/billing-and-topups) sekä
[täydellinen hinnoitteluohje](/fi/guides/pricing).
**API:ssa:** [`/v1/billing`](/api-reference/billing).
---
## Sovelluksen copilot
Hallintapaneelissa on sisäänrakennettu **copilot** — kysy siltä "miten teen X"
ja se vastaa näiden ohjeiden perusteella, tarjoaa vaiheittaisia opastuksia,
jotka korostavat todellisia hallintalaitteita, ja voi toistaa minkä tahansa
opastetun kierroksen. Se on nopein tapa löytää tällä sivulla mainittu
hallintalaite. Katso [Kysy sovelluksen copilotta](/fi/guides/ask-the-copilot).
---
## Koostetaan kokonaisuus
Viisivaiheinen ohjattu toiminto: agentti → laskutus → numero → simulointi → tarkistus.
Sama ensimmäinen puhelu neljällä REST-kutsulla.
Rakenna agentti, lisää saldoa, hanki numero, simuloi ja tarkista puhelut.
OAuth-sovellukset, mukautetut API:t, MCP-palvelimet ja VoIP-palveluntarjoajat.
Raportit, havainnoitavuus, kokeilut, ongelmat ja hälytykset.
Kutsut ja roolit, API-avaimet, tietoturva ja SSO.
API-reseptit: saapuvat, lähtevät, dynaaminen määritys, työkalut, testaus.
Tee HMAC-tarkistus oikein kerran ja käytä sitä uudelleen kaikkialla.