Getting Started

Ydinkäsitteet

Kartta kaikesta alustalla — mitä kukin objekti tekee, missä se sijaitsee hallintapaneelissa ja mitä APIa se koskettaa.

ThunderPhone on kattava alusta AI-puheagenttien rakentamiseen, käyttämiseen ja kehittämiseen. Tämä sivu on kartta: jokainen kohtaamasi käsite omassa lyhyessä osiossaan sekä hallintapaneelin näkymä ja sitä tukeva API. Selaa sivu kerran läpi ja palaa siihen aina, kun jokin termi kaipaa selvennystä.

Hallintapaneelin sivupalkki noudattaa tätä rakennetta:

Organisaatiot#

Organisaatio on käyttöoikeuseristyksen yksikkö. Jokainen muu resurssi — agentit, puhelinnumerot, puhelut, 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än sidoksen ansiosta REST API on niin suoraviivainen: organisaatiotunnusta ei koskaan lisätä URL-poluille, koska avaimesi tunnistaa sen jo.

Hallintapaneelissa: organisaation valitsin (sivupalkin alaosassa) 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 käyttävä AI-määritys. Se sisältää:

• Kehotteen, joka määrittää, mitä agentti sanoo ja miten se toimii — mukaan lukien puhelutoiminnot, kuten siirrot, näppäinpainallukset ja puhelun lopetukset, jotka ovat erillisten määritysten sijaan tavallisia kehotteen rivejä.
• 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, tietämyskannat, MCP-palvelimet ja upotetut funktiotyökalut.
• Toiminta-asetukset: puhumisjärjestys, kuittaustila, taustaraita, pidon aikakatkaisu.

Rakentajassa tehdyt muokkaukset tallennetaan automaattisesti luonnokseen; mikään ei siirry tuotantoon ennen kuin napsautat Julkaise. Jokaisesta julkaisusta tallennetaan tilannekuva rakentajan Historia-välilehteen, joten voit tarkastella ja palauttaa minkä tahansa aiemman version.

Hallintapaneelissa: Puheagentit → agenttirakentaja (/dashboard/agents). Katso Rakenna ensimmäinen puheagenttisi.

API:ssa: /v1/agents — CRUD, kopiointi, siirto, versiohistoria ja kehotteen apurit.

Äänet#

Äänikirjasto sisältää äänet, joita agentti voi käyttää, niiden kuunneltavat näytteet, yhteensopivat kielet, sukupuoli- ja aksenttiryhmittelyt sekä mahdolliset premium-äänen tai -kielen lisämaksut. Maksullisella näytteellä voit syntetisoida oman 1–500 merkin mittaisen lauseesi 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ähtevät puhelut). Kaksi lähdettä:

• Demonumerot — oikeita yhdysvaltalaisia numeroita, jotka otetaan käyttöön ThunderPhonen varannosta ja ovat valmiita sekunneissa. Vain saapuville puheluille, niihin vastataan lyhyellä puhutulla vastuuvapauslausekkeella, ja hallintapaneeli rajoittaa organisaation niiden määrän 10:een. Sopii ensimmäiseen testiin, ei tuotantoon.
• VoIP-numerot — tuodaan omalta palveluntarjoajaltasi VoIP-yhteyden kautta. Twilio ja Telnyx yhdistyvät suoraan (Telnyxissä on ohjattu käyttöönotto); SignalWire ja Vonage ovat tulossa pian — tällä hetkellä voit käyttää niitä manuaalisella SIP-määrityksellä, joka hyväksyy minkä tahansa SIP-rungon. Kun VoIP-numerot on tuotu ja vahvistettu, ne tukevat saapuvia ja lähteviä puheluita.

Jokaisella numerorivillä voit määrittää reititystilan, valita saapuvien puheluiden agentin ja lisätä numerolle tunnisteen.

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 muodostuu puheluloki. Puhelu sisältää koko roolimerkinnöillä varustetun 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. Kuunnellessasi voit kuiskata: kirjoita ohje, joka menee suoraan agentillesi puhelun aikana; soittaja ei koskaan kuule sitä, ja agentti noudattaa sitä reaaliajassa.

Hallintapaneelissa: Puheluhistoria (/dashboard/call-history) arkistoa ja puhelukohtaisia tietoja varten; Käynnissä keskeneräisiä puheluita varten. 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 -tilassa oleva puheluhistorian näkymä ulkoiselle asiakkaalle. Organisaation ylläpitäjät valitsevat agentit, joiden puhelut näkyvät, lisäävät hyväksyttyjen katselijoiden sähköpostiosoitteet, lataavat logon ja korostusvärin sekä voivat halutessaan vahvistaa mukautetun verkkotunnuksen. Portaalin katselijat voivat tarkastella puheluiden tietoja, litterointeja ja saatavilla olevia tallenteita ilman hallintapaneelin käyttöoikeutta.

Hallintapaneelissa: Asiakasportaalit (/dashboard/client-portals). Katso Asiakasportaalit.

API:ssa: /v1/client-portals ylläpidon hallintatoimintoja varten.

Verkkowidgetit#

Verkkowidget tarjoaa sivustosi kävijöille mikrofonipohjaisen keskustelun agentin kanssa — puhelinnumeroa ei tarvita. Se tunnistautuu julkaistavalla avaimella (pk_live_...), joka on alkuperän perusteella sidottu sallittuihin verkkotunnuksiisi, joten sitä on turvallista käyttää asiakaspuolen koodissa.

Avaimet toimivat yhdessä kahdesta tilasta: 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: Verkkowidgetit (/dashboard/web-widgets) — luo widgettejä, määritä tila ja agentti, hallitse sallittuja verkkotunnuksia ja kopioi upotuskoodi. Katso Luo verkkowidget.

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

Tietopohjat#

Tietopohja on joukko dokumentteja, joista agenttisi voi hakea tietoa puhelun aikana vastauksiensa tueksi — lataa tiedostoja, liitä tekstiä tai tuo verkkosivuja URL-osoitteella ja liitä sitten tietopohja agenttiin rakentajassa. Agentti hakee siitä tietoa sisäänrakennetulla hakutyökalulla aina, kun keskustelu sitä edellyttää.

Hallintapaneelissa: Tietämys (/dashboard/knowledge) dokumenttikirjastolle; rakentajan Tietämys-osio tietopohjan liittämiseen agenttiin. Katso Anna agentillesi tietopohja.

Yhteydet#

Yhteyksien avulla agentit tavoittavat ulkomaailman. Neljä tyyppiä yhdessä sivupalkkiryhmässä:

• Sovellukset (/dashboard/app-connections) — OAuth-yhteydet Slackiin, HubSpotiin, Salesforceen, Google Calendar -palveluun, Google Sheetsiin ja Cal.comiin. Yhdistä kerran ja ota sitten käyttöön toimintokohtaiset työkalut (lähetä Slack-viesti, luo tai päivitä HubSpot-yhteystieto, varaa Cal.com-aika…) mille tahansa agentille. Katso Yhdistä sovelluksia.
• API:t (/dashboard/api-connections) — muuta mikä tahansa HTTP API agentin toiminnoksi. Liitä cURL-komento, niin AI-avustaja luonnostelee työkalun määritelmän, tai rakenna se manuaalisesti; Testipyyntö-painike tekee testiympäristöpuhelun ennen käyttöönottoa. Katso API-yhteydet — hallintapaneelin näkymä kohteelle /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ökalintegraatio.

Kampanjat#

Kampanja soittaa lähteviä puheluita mittakaavassa: lataa CSV-tiedosto yhteystiedoista, valitse agentti ja soittonumero sekä määritä soittoikkuna (päivät ja tunnit, aikavyöhykkeen huomioiva), samanaikaisuus ja uudelleenyrityskäytäntö (enimmäisyritysmäärä ja mitkä lopputulokset — ei vastausta, vastaaja, epäonnistunut — yritetään uudelleen). Kampanja käy luettelon läpi ja tallentaa jokaisen puhelun Puheluhistoriaan.

Hallintapaneelissa: Kampanjat (/dashboard/campaigns). Katso Suorita lähtevien puheluiden kampanja.

Yksittäisiä ohjelmallisia puheluita varten: käytä lähtevien puheluiden APIa.

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 vastaanottaa ensimmäisen todellisen liikenteensä, tai pidä silmällä käynnissä olevaa kampanjaa.

Hallintapaneelissa: Reaaliaikainen (/dashboard/live). Katso Katso ja valvo reaaliaikaisia puheluita.

Simuloinnit#

Simulointi on AI-soittaja, joka käy todellisen keskustelun agenttisi kanssa — sama puhelinliikenteen reitti, todellinen transkriptio, todellinen arviointi — jotta voit testata ennen julkaisua (ja sen jälkeen). Kohdista se agenttiin tai puhelinnumeroon, kirjoita soittajan skenaario itse tai luo skenaarioita tekoälyn avulla agentin kehotteesta (mukaan lukien reunatapaukset, jos pyydät niitä), ja seuraa puhelua reaaliajassa.

Skenaariot ryhmitellään sarjoiksi, jotka määrittävät vähimmäisläpäisyasteen ja voivat estää julkaisuja CI:ssä; hyväksyttyyn vertailutasoon nähden havaitut regressiot raportoidaan skenaariokohtaisesti.

Hallintapaneelissa: Simuloinnit (/dashboard/simulations) sekä Simulointi-painike agenttirakentajassa. Katso Simuloi puhelu.

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

Validointijoukot#

Validointijoukko muuttaa todelliset puheluhetket toistettaviksi, yhden vuoron regressiotarkistuksiksi. Jokainen esimerkki tallentaa keskustelukontekstin, asiaankuuluvan soittajan äänen, alkuperäisen vastauksen ja odotetun toiminnan. Uudelleentoistot suoritetaan nykyistä agenttiluonnosta vasten ilman uuden puhelun soittamista, ja julkaisun valintaikkuna voi näyttää, vastaako viimeisin suoritus edelleen kyseistä luonnosta.

Hallintapaneelissa: Validointijoukot (/dashboard/validation) organisaation aineistolle ja agenttirakentajan Validointi-välilehti suorituksille. Katso Validointijoukot.

API:ssa: /v1/validation-sets sekä agentin/esimerkin uudelleentoiston päätepisteet samalla viitesivulla.

Kokeilut#

Kokeilu A/B-testaa agenttiasetuksia todellisella liikenteellä: määritä variantit (erilaiset kehotteet, moottorit tai asetukset), jaa liikenne niiden välillä ja vertaa tuloksia varianteittain. Käytä tätä sen sijaan, että toteuttaisit lokerointilogiikan itse webhookissa.

Hallintapaneelissa: Kokeilut (/dashboard/experiments) ja A/B-välilehti agenttirakentajassa. Katso Kokeilut (A/B-testaus).

Ongelmat#

Ongelma on tiettyyn puheluun merkitty ongelma — ihmistarkastajan kirjaama tai tekoälyarvioinnin havaitsema. Ongelmiin liittyy vakavuus, lähde ja tila, ja Ongelmat-sivu on triage-jono: suodata, tarkista ongelmallinen puhelu ja seuraa korjauksia.

Hallintapaneelissa: Ongelmat (/dashboard/issues) sekä puhelukohtainen merkintä Puheluhistoriassa. Katso Ongelmien triage.

API:ssa: /v1/issue-reports.

Raportit#

Raportti vastaa puheludataasi koskevaan luonnollisella kielellä esitettyyn kysymykseen ("Mitkä olivat kolme yleisintä syytä, joiden vuoksi soittajat pyysivät ihmistä viime viikolla?") tekoälyn kirjoittamalla analyysillä, joka rajataan valitsemiisi agentteihin ja ajanjaksoon.

Hallintapaneelissa: Raportit (/dashboard/reports). Katso Raportit.

Havainnoitavuus#

Havainnoitavuus on metriikkanäkymä: puhelumäärä, tulokset ja laatu ajan mittaan. Voit suodattaa niitä agentin ja aikaikkunan mukaan sekä viedä tiedot jatkoanalyysia varten.

Hallintapaneelissa: Havainnoitavuus (/dashboard/observability). Katso Havainnoitavuus.

Hälytykset#

Hälytyssääntö seuraa metriikkaa (onnistumisaste, epäonnistumisaste, keskimääräinen pistemäärä, puhelumäärä, sarjaregressiot) aikaikkunan ajan ja laukeaa, kun se ylittää asettamasi kynnyksen. Ilmoitukset lähetetään sähköpostiin ja Slackiin, ja se laukaisee alert.triggered-tapahtuman webhook-päätepisteillesi.

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

Webhookit#

ThunderPhone lähettää palvelimellesi HTTP POST -webhookeja, kun puhelun aikana ja sen jälkeen tapahtuu asioita. Kaksi toimitusmallia:

• Webhook-päätepisteet (suositeltu): hallitse useita URL-osoitteita osoitteessa /v1/developer/webhook-endpoints, joissa on päätepistekohtaiset salaisuudet ja tapahtumatilaukset.
• Vanha yhden URL-osoitteen webhook: yksi URL-osoite organisaatiota kohden. Hallitaan osoitteessa /v1/webhook tai kohdassa Organisaatio → Yleiset. Säilytetään taaksepäin yhteensopivuuden vuoksi.

Tapahtumat jakautuvat kahteen luokkaan:

• Estävät tapahtumat odottavat palvelimesi vastaavan määrityksellä, joka muokkaa käynnissä olevaa puhelua — nämä ovat saapuvan puhelun tapahtumat (telephony.incoming / web.incoming). Sinulla on vastaamiseen enintään 10 sekuntia; aikakatkaisun tapahtuessa staattisesti määritetty agentti hoitaa puhelun.
• Ei-estävät tapahtumat ovat lähetä-ja-unohda-ilmoituksia, joita yritetään uudelleen eksponentiaalisella viiveellä — katso toimitussemantiikka.

Jokaisessa pyynnössä on HMAC-SHA256-allekirjoitus otsakkeessa X-ThunderPhone-Signature. Katso allekirjoituksen vahvistaminen.

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 välittää tuloksen takaisin agentille.

Agentit sisältävät 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 tavallisilla kehotteen riveillä työkalumääritysten sijaan.

Hallintapaneelissa: rakentajan API-yhteydet-osio (katso Yhteydet).

API:ssa: /v1/integrations ja funktiotyökalujen 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 voi 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 toimii ennakkomaksulla. Jokaisella organisaatiolla on USD-saldo; puheluista veloitetaan agentin minuuttihinnan mukaan (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 402 Payment Required.

Lisää saldoa manuaalisesti tai ota käyttöön automaattinen saldon lisäys, jossa on saldoraja, lisäyssumma ja valinnainen kuukausittainen kulutusraja — 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ä kattava hinnoitteluviite.

API:ssa: /v1/billing.

Sovelluksen sisäinen apuri#

Hallintapaneelissa on sisäänrakennettu apuri — kysy siltä "miten teen X:n", niin se vastaa näiden ohjeiden perusteella, tarjoaa vaiheittaisia opastuksia, jotka korostavat todellisia hallintatoimintoja, ja voi toistaa minkä tahansa ohjatun kierroksen. Se on nopein tapa löytää tällä sivulla mainittu toiminto. Katso Kysy sovelluksen sisäiseltä apurilta.

Ota kaikki käyttöön#