Kjernekonsepter

En oversikt over alt på plattformen — hva hvert objekt gjør, hvor det finnes i dashbordet, og hvilket API som berører det.

ThunderPhone er en komplett plattform for å bygge, kjøre og forbedre AI-stemmeagenter. Denne siden er oversikten: hvert konsept du møter, én kort seksjon om gangen, med dashboard-visningen og API-et som ligger bak. Skumles den én gang, og kom tilbake når du trenger å få forklart et begrep.

Sidepanelet i dashboardet gjenspeiler denne strukturen:

Organisasjoner#

En organisasjon er enheten for leietakerisolasjon. Alle andre ressurser — agenter, telefonnumre, samtaler, nøkler — tilhører nøyaktig én organisasjon. Kontoen din kan tilhøre mange organisasjoner; hver har sin egen saldo, sine egne nøkler og sin egen medlemsliste.

API-nøkkelen sk_live_ som du oppretter under Organisasjon → Nøkler, er knyttet til én organisasjon. Denne tilknytningen er det som gjør REST API-et så flatt: Du legger aldri inn en organisasjons-ID i URL-stier, fordi nøkkelen din allerede identifiserer den.

I dashboardet: organisasjonsvelgeren (nederst i sidepanelet) og innstillingene for Organisasjon — faner for Min konto, Generelt, Nøkler, Varsler, Faktureringsinnstillinger og Faktureringshistorikk. Se referansen for organisasjonsinnstillinger.

I API-et: /v1/orgs, /v1/developer/api-keys.

Agenter#

En agent er AI-konfigurasjonen som kjører en samtale. Den samler:

• En ledetekst som styrer hva agenten sier og hvordan den oppfører seg — inkludert samtalehandlinger som overføringer, tastetrykk og avslutting av samtaler, som er vanlige ledetekstlinjer i stedet for separat konfigurasjon.
• Et motornivå (spark, bolt, storm-*): Spark er optimalisert for kostnad, Bolt for hastighet, Storm for intelligens i komplekse ledetekster.
• En stemme samt et primærspråk og valgfrie ekstra språk — agenten bytter automatisk når en innringer bytter språk. Se Støttede språk.
• Tilknyttede funksjoner: tilkoblede apper, API-tilkoblinger, kunnskapsbaser, MCP-servere og innebygde funksjonsverktøy.
• Atferdsinnstillinger: talerekkefølge, bekreftelsesmodus, bakgrunnsspor, ventetidsgrense.

Endringer i byggeren lagres automatisk som et utkast; ingenting publiseres før du klikker Distribuer. Hver distribusjon lagres som et øyeblikksbilde i byggerens fane Historikk, slik at du kan inspisere og gjenopprette enhver tidligere versjon.

I dashboardet: Stemmeagenter → agentbyggeren (/dashboard/agents). Se Bygg din første stemmeagent.

I API-et: /v1/agents — CRUD, duplisering, overføring, versjonshistorikk og hjelpefunksjoner for ledetekster.

Stemmer#

Stemmebiblioteket inneholder stemmene en stemmeagent kan bruke, avspillbare eksempler, kompatible språk, grupperinger etter kjønn og aksent, og eventuelle tillegg for premiumstemmer og -språk. Med den betalte prøvefunksjonen kan du syntetisere din egen frase på 1–500 tegn før du velger.

Kvalifiserte organisasjoner kan også opprette egendefinerte stemmer fra en kort WAV- eller MP3-prøve. Egendefinerte stemmer har en kvote og en asynkron opprettelsesstatus. Når de er klare, vises de i samme agentvelger som bibliotekstemmene.

I dashbordet: Stemmer (/dashboard/voices). Se Stemmebibliotek og egendefinerte stemmer.

I API-et: /v1/voices, stemmeeksempler og egendefinerte stemmer.

Telefonnummer#

Et telefonnummer tilhører en organisasjon og ruter innkommende samtaler til en stemmeagent (og kan brukes til utgående samtaler). To kilder:

• ThunderPhone-numre — ekte amerikanske numre klargjort fra ThunderPhones pool, aktive på sekunder, $1/måned pluss et tillegg på 1¢/minutt. De starter som kun inngående. En organisasjonsadministrator kan be om utgående oppringing fra siden Telefonnumre; ThunderPhone vurderer hver forespørsel manuelt, og godkjente numre kan ringe og kjøre kampanjer. En organisasjon kan som standard ha 25.
• VoIP-numre — hentet fra din egen leverandør gjennom en VoIP-tilkobling. Twilio og Telnyx kobles direkte til med en API-nøkkel (Telnyx har også et veiledet oppsett for ny konto); SignalWire, Vonage, Plivo og alle andre SIP-trunker kobles til gjennom SIP-oppsett, en manuell SIP-konfigurasjon. Når de er importert og verifisert, støtter VoIP- numre inngående og utgående samtaler.

Hver nummerrad lar deg angi en rutemodus, velge agent for innkommende samtaler og merke nummeret.

I dashbordet: Telefonnumre (/dashboard/phone-numbers). Se Skaff et telefonnummer.

I API-et: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.

Samtaler#

Hver innkommende samtale, utgående samtale, simulering og widgetøkt blir en samtalelogg. En samtale inneholder hele den rollemerkede transkripsjonen, den strukturerte historikken over samtaleomganger (inkludert verktøykall), et opptak, faktureringstotalen og valgfrie AI-vurderinger og problemrapporter.

Mens en samtale er direkte, kan du åpne den og lytte med — du blir med uten å høres, og ingen i samtalen hører deg. Når du lytter med, kan du hviske: skriv en instruksjon som går direkte til stemmeagenten din midt i samtalen. Innringeren hører den aldri, og stemmeagenten følger den umiddelbart.

I dashbordet: Samtalehistorikk (/dashboard/call-history) for arkivet og detaljer per samtale; Direkte for pågående samtaler. Se Gjennomgå, lytt til og veiled samtalene dine.

I API-et: /v1/calls — liste, transkripsjon, historikk, lyd, vurdering, eksport; /v1/issue-reports.

Kundeportaler#

En kundeportal er en profilert, skrivebeskyttet visning av samtalehistorikk for en ekstern kunde. Organisasjonsadministratorer velger stemmeagentene hvis samtaler skal vises, legger til godkjente e-postadresser for seere, laster opp en logo og aksentfarge, og kan eventuelt verifisere et egendefinert domene. Portalbrukere kan se samtaledetaljer, transkripsjoner og tilgjengelige opptak uten å få tilgang til dashbordet.

I dashbordet: Kundeportaler (/dashboard/client-portals). Se Kundeportaler.

I API-et: /v1/client-portals for administrasjonsgrensesnittet.

Nettwidgeter#

Webwidgeten gir de besøkende på nettstedet ditt en mikrofonsamtale med en stemmeagent — uten behov for telefonnummer. Den autentiserer med en publiserbar nøkkel (pk_live_...) som nettlesere bare kan bruke fra de tillatte domenene dine, så den er trygg å bruke i klientkode. Domenelisten er ikke autentisering, og øktinnstillingene en side kan sende, er deaktivert til du tillater dem på nøkkelen.

Nøkler kjører i én av to moduser: agent (statisk knyttet til én stemmeagent) eller webhook (serveren din velger konfigurasjonen per besøkende — se Dynamisk konfigurasjon per anrop). Widgetøkter går gjennom den samme anropsinfrastrukturen som telefonsamtaler.

I dashbordet: Nettwidgeter (/dashboard/web-widgets) — opprett widgeter, angi modus og stemmeagent, administrer tillatte domener og kopier innbyggingssnutten. Se Opprett en nettwidget.

I API-et: /v1/publishable-key, /v1/mic-session og Widget SDK-dokumentasjonen.

Kunnskapsbaser#

En kunnskapsbase er en samling dokumenter som stemmeagenten din kan søke i under en samtale for å forankre svarene sine — last opp filer, lim inn tekst eller importer nettsider via URL, og koble deretter kunnskapsbasen til en stemmeagent i byggeren. Stemmeagenten spør den med et innebygd søkeverktøy når samtalen krever det.

I dashbordet: Kunnskap (/dashboard/knowledge) for dokumentbiblioteket; byggerens Kunnskap-seksjon for å koble en til en stemmeagent. Se Gi stemmeagenten din en kunnskapsbase.

Tilkoblinger#

Tilkoblinger er hvordan stemmeagenter når omverdenen. Fire typer, én sidefeltgruppe:

• Apper (/dashboard/app-connections) — OAuth-tilkoblinger til Slack, HubSpot, Salesforce, Google Calendar, Google Sheets og Cal.com. Koble til én gang, og slå deretter på verktøy per operasjon (send en Slack-melding, oppdater eller opprett en HubSpot-kontakt, bestill et Cal.com-tidspunkt…) for hvilken som helst stemmeagent. Se Koble til apper.
• API-er (/dashboard/api-connections) — gjør et hvilket som helst HTTP-API om til en handling for stemmeagenten. Lim inn en cURL-kommando, så utarbeider AI-veiviseren verktøydefinisjonen, eller bygg den manuelt; knappen Test forespørsel utfører et sandkasseanrop før du lanserer. Se API-tilkoblinger — dashbordvisningen av /v1/integrations.
• MCP (/dashboard/mcp-connections) — legg til en Model Context Protocol-server via URL, og la stemmeagenten bruke verktøyene den eksponerer. Se Legg til en MCP-server.
• VoIP (/dashboard/voip-connections) — leverandørlegitimasjon for å bruke egne telefonnumre. Se Koble til en VoIP-leverandør.

ThunderPhone eksponerer også sitt eget MCP-endepunkt, slik at en ekstern MCP-klient kan liste opp stemmeagenter, undersøke anrop og transkripsjoner og foreta anrop. Se Bruk ThunderPhone som en MCP-server.

I API-et: /v1/integrations, /v1/mcp-servers og /v1/voip-connections; se også Bygg en verktøyintegrasjon.

Kampanjer#

En kampanje foretar utgående anrop i stor skala: last opp en CSV-fil med kontakter, velg stemmeagenten og nummeret det ringes fra, og angi anropsvinduet (dager og timer, med tidssone), samtidighet og policy for nye forsøk (maksimalt antall forsøk og hvilke resultater — intet svar, talepost, mislykket — som forsøkes på nytt). Kampanjen arbeider seg gjennom listen og registrerer hvert anrop i Anropshistorikk.

I dashbordet: Kampanjer (/dashboard/campaigns). Se Kjør en kampanje for utgående anrop.

For enkeltstående programmatisk utførte anrop: API-et for utgående anrop.

Direkteovervåking#

Direkte viser alle pågående samtaler i organisasjonen og lar deg åpne hvilken som helst av dem for å lytte med og hviske i sanntid. Dette er flaten for oppfølging: Se hvordan en ny prompt håndterer sin første reelle trafikk, eller hold øye med en pågående kampanje.

I dashbordet: Direkte (/dashboard/live). Se Se på og følg opp direktesamtaler.

Simuleringer#

En simulering er en KI-innringer som har en reell samtale med stemmeagenten din — samme telefoniflyt, ekte transkripsjon, ekte vurdering — slik at du kan teste før (og etter) du lanserer. Pek den mot en agent eller et telefonnummer, skriv innringerscenarioet selv eller generer scenarioer med KI fra agentens prompt (inkludert grenseverdier, hvis du ber om det), og følg samtalen direkte.

Scenarioer grupperes i suiter som fastsetter en minimumsandel bestått og kan blokkere utgivelser i CI. Regresjoner mot den godkjente referansen rapporteres per scenario.

I dashbordet: Simuleringer (/dashboard/simulations), samt knappen Simulering i agentbyggeren. Se Simuler en samtale.

I API-et: /v1/test-calls og suitekjøreren — se Test en agent ende til ende.

Valideringssett#

Et valideringssett gjør reelle øyeblikk fra samtaler om til repeterbare regresjonssjekker med én tur. Hvert eksempel låser samtalekontekst, relevant lyd fra innringeren, det opprinnelige svaret og forventet atferd. Avspillinger kjøres mot agentens nåværende utkast uten å foreta en ny samtale, og utrulleringsdialogen kan vise om den nyeste kjøringen fortsatt samsvarer med utkastet.

I dashbordet: Valideringssett (/dashboard/validation) for organisasjonens datasett og fanen Validering i agentbyggeren for kjøringer. Se Valideringssett.

I API-et: /v1/validation-sets og endepunktene for avspilling av agent/eksempel på samme referanseside.

Eksperimenter#

Et eksperiment A/B-tester agentkonfigurasjoner på direktetrafikk: definer varianter (ulike prompter, motorer eller innstillinger), fordel trafikken mellom dem, og sammenlign resultater per variant. Bruk dette i stedet for å bygge fordelingslogikk selv i en webhook.

I dashbordet: Eksperimenter (/dashboard/experiments) og fanen A/B i agentbyggeren. Se Eksperimenter (A/B-testing).

Problemer#

Et problem er et flagget problem i en bestemt samtale — meldt inn av en menneskelig kontrollør eller oppdaget av KI-vurdering. Problemer har alvorlighetsgrad, kilde og status, og siden Problemer er prioriteringskøen: filtrer, undersøk den problematiske samtalen og følg opp rettinger.

I dashbordet: Problemer (/dashboard/issues), samt flagging per samtale i Anropshistorikk. Se Prioritering av problemer.

I API-et: /v1/issue-reports.

Rapporter#

En rapport besvarer et spørsmål på naturlig språk om samtaledataene dine ("Hva var de tre vanligste grunnene til at innringere ba om å snakke med et menneske forrige uke?") med en KI-skrevet analyse, avgrenset til agentene og datointervallet du velger.

I dashbordet: Rapporter (/dashboard/reports). Se Rapporter.

Observerbarhet#

Observerbarhet er flaten for måledata: samtalevolum, resultater og kvalitet over tid, filtrerbart etter agent og tidsvindu, med eksport for videre analyse.

I dashbordet: Observerbarhet (/dashboard/observability). Se Observerbarhet.

Varsler#

En varslingsregel overvåker en måleverdi (suksessrate, feilrate, gjennomsnittlig poengsum, samtalevolum, regresjoner i suiter) over et tidsvindu og utløses når den krysser terskelen din. Varsler sendes på e-post og Slack, og utløser en alert.triggered-hendelse til webhook-endepunktene dine.

I dashbordet: Organisasjon → Varsler. Se Varsler.

Webhooker#

ThunderPhone sender HTTP POST-webhooker til serveren din når ting skjer under og etter en samtale. To leveringsmodeller:

• Webhook-endepunkter (anbefalt): administrer mange URL-er på /v1/developer/webhook-endpoints med hemmeligheter og hendelsesabonnementer per endepunkt.
• Eldre webhook med én URL: én URL per organisasjon. Administreres på /v1/webhook eller under Organisasjon → Generelt. Beholdes for bakoverkompatibilitet.

Hendelser deles inn i to klasser:

• Blokkerende hendelser forventer at serveren din svarer med konfigurasjon som former samtalen mens den pågår — hendelser for innkommende samtaler (telephony.incoming / web.incoming). En telefonsamtale venter i opptil 13 sekunder, inkludert ett nytt forsøk, og en widgetøkt i 10 sekunder. Det finnes ingen reserveagent: uten en brukbar konfigurasjon blir telefonsamtalen avsluttet, og widgetøkten mislykkes.
• Ikke-blokkerende hendelser er send-og-glem-varsler som prøves på nytt med eksponentiell tilbakeholdning — se leveringssemantikk.

Hver forespørsel inneholder en tidsstemplet HMAC-SHA256-signatur i X-ThunderPhone-Signature-V2, i tillegg til den eldre signaturen som kun gjelder brødteksten, X-ThunderPhone-Signature. Se signaturverifisering.

Funksjonsverktøy#

Et funksjonsverktøy er et HTTP-endepunkt som agenten din kan kalle midt i en samtale. Du gir ThunderPhone et funksjonsskjema i OpenAI-stil samt en endepunkt-URL; agenten avgjør når den skal kalle det, og ThunderPhone utfører den signerte HTTP-forespørselen fra sine servere og gir resultatet tilbake til agenten.

Agenter leveres også med innebygde samtalefunksjoner — overføre samtalen, sende tastaturinndata (DTMF), avslutte samtalen, vente på vent — som du aktiverer med enkle linjer i prompten i stedet for verktøydefinisjoner.

I dashbordet: seksjonen API-tilkoblinger i byggeren (se Tilkoblinger).

I API-et: /v1/integrations og spesifikasjonen for funksjonsverktøy.

Team og roller#

Hver organisasjon har en medlemsliste med to roller: Medlemmer bygger og drifter agenter; Administratorer administrerer også teamet og fakturering. Inviter via e-post — invitasjoner utløper etter 7 dager og kan tilbakekalles; ⋯-menyen på en medlemsrad endrer roller eller fjerner noen. Enkel pålogging kan konfigureres for hele organisasjonen — se SSO.

I dashbordet: Organisasjon → Generelt. Se Inviter teamet ditt.

I API-et: /v1/members, /v1/invites.

Fakturering#

ThunderPhone er forhåndsbetalt. Hver organisasjon har en saldo i USD; samtaler belaster den med agentens pris per minutt (motornivå pluss tillegg — byggeren viser totalprisen direkte mens du endrer innstillinger, og utvalgte tilleggsspråk legger til 3¢/min). Når saldoen når null, avvises innkommende samtaler, og utgående samtaler returnerer 402 Payment Required.

Fyll på manuelt, eller aktiver automatisk påfylling med en saldogrense, et påfyllingsbeløp og en valgfri månedlig forbruksgrense — slik at en samtale aldri avbrytes midt i en setning.

I dashbordet: Organisasjon → Faktureringsinnstillinger og Faktureringshistorikk. Se Sett inn midler og slå på automatisk påfylling, samt den komplette prisreferansen.

I API-et: /v1/billing.

Kopiloten i appen#

Dashbordet har en innebygd kopilot — spør den «hvordan gjør jeg X», så svarer den ut fra denne dokumentasjonen, tilbyr trinnvise veiledninger som fremhever de faktiske kontrollene, og kan spille av hvilken som helst av de veiledede omvisningene på nytt. Det er den raskeste måten å finne en kontroll som denne siden omtaler. Se Spør kopiloten i appen.

Slik henger det sammen#