Keskeiset käsitteet

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:

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.

API:ssa: /v1/orgs, /v1/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.
• Liitetyt ominaisuudet: yhdistetyt sovellukset, API-yhteydet, tietopankit, MCP-palvelimet ja upotetut funktiotyökalut.
• 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.

API:ssa: /v1/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.

API:ssa: /v1/voices, ääninäytteet ja mukautetut äänet.

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. $1/kuukausi sekä 1 ¢/minuutti 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 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.

API:ssa: /v1/phone-numbers, /v1/voip-connections, /v1/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.

API:ssa: /v1/calls — luettelo, litterointi, historia, ääni, arviointi, vienti; /v1/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.

API:ssa: /v1/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). 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.

API:ssa: /v1/publishable-key, /v1/mic-session ja Widget SDK -dokumentaatio.

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.

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.
• 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 — hallintapaneelin vastine rajapinnalle /v1/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.
• VoIP (/dashboard/voip-connections) — palveluntarjoajan tunnistetiedot omien puhelinnumeroiden käyttöön. Katso Yhdistä VoIP-palveluntarjoaja.

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.

API:ssa: /v1/integrations, /v1/mcp-servers ja /v1/voip-connections; katso myös Rakenna työkalun integraatio.

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.

Yksittäisiä ohjelmallisia puheluita varten: lähtevien puheluiden API.

Reaaliaikainen seuranta#

Reaaliaikainen näyttää kaikki organisaation käynnissä olevat puhelut ja antaa sinun avata minkä tahansa niistä, jotta voit kuunnella ja kuiskata 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.

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.

API:ssa: /v1/test-calls ja testisviitin ajaja — katso Testaa agentti päästä päähän.

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.

API:ssa: /v1/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).

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.

API:ssa: /v1/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.

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.

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.

Hallintapaneelissa: Organisaatio → Hälytykset. Katso Hälytykset.

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, jossa jokaisella päätepisteellä on omat salaisuutensa ja tapahtumatilauksensa.
• Vanha yhden URL-osoitteen webhook: yksi URL-osoite organisaatiota kohden. Hallitaan osoitteessa /v1/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 (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.

Jokaisessa pyynnössä on aikaleimattu HMAC-SHA256-allekirjoitus otsakkeessa X-ThunderPhone-Signature-V2 sekä vanha vain rungon kattava X-ThunderPhone-Signature. Katso allekirjoituksen vahvistus.

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).

API:ssa: /v1/integrations ja Function Tools -määritys.

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.

Hallintapaneelissa: Organisaatio → Yleiset. Katso Kutsu tiimisi.

API:ssa: /v1/members, /v1/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 lisäävät 3¢/min). 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 sekä täydellinen hinnoitteluohje.

API:ssa: /v1/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.

Koostetaan kokonaisuus#