Getting Started

Kjernekonsepter

En oversikt over alt i 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 kartet: alle begrepene du møter, én kort seksjon for hvert, med dashboardflaten og API-et som støtter det. Skumles den én gang, og kom tilbake når du trenger å få forklart et begrep.

Sidefeltet i dashboardet gjenspeiler denne strukturen:

Organisasjoner#

En organisasjon er enheten for kontoisolering. 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.

sk_live_-API-nøkkelen 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 en organisasjons-ID i URL-stier, fordi nøkkelen din allerede identifiserer den.

I dashboardet: organisasjonsvelgeren (nederst i sidefeltet) og Organisasjon-innstillinger — 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 prompt som styrer hva agenten sier og hvordan den oppfører seg — inkludert samtalehandlinger som overføringer, tastetrykk og å legge på, som er vanlige promptlinjer fremfor separat konfigurasjon.
• Et motornivå (spark, bolt, storm-*): Spark er optimalisert for kostnad, Bolt for hastighet og Storm for intelligens i komplekse prompter.
• 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 blir publisert før du klikker på Distribuer. Hver distribusjon lagres som et øyeblikksbilde i byggerens Historikk-fane, slik at du kan undersøke 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 prompthjelpere.

Stemmer#

Stemmebiblioteket inneholder stemmene en agent kan bruke, avspillbare eksempler, kompatible språk, grupperinger etter kjønn og aksent, samt eventuelle pristillegg for premiumstemmer og -språk. En betalt prøvefunksjon kan syntetisere din egen frase på 1–500 tegn før du velger.

Kvalifiserte organisasjoner kan også opprette egendefinerte stemmer fra et kort WAV- eller MP3-eksempel. 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 anrop til en agent (og kan brukes til utgående anrop). To kilder:

• Demonumre — ekte amerikanske numre som klargjøres fra ThunderPhone sin pool og er aktive i løpet av sekunder. Kun for innkommende anrop. De svarer med en kort muntlig ansvarsfraskrivelse, og dashbordet begrenser en organisasjon til 10 slike. Ideelle for en første test, men ikke for produksjon.
• VoIP-numre — hentet inn fra din egen leverandør gjennom en VoIP-tilkobling. Twilio og Telnyx kobles til direkte (Telnyx har et veiledet oppsett). SignalWire og Vonage kommer snart — foreløpig når du dem via manuell SIP-konfigurasjon, som godtar enhver SIP-trunk. Når VoIP-numre er importert og verifisert, støtter de innkommende og utgående anrop.

Hver nummerlinje lar deg angi en ruteringsmodus, velge agent for innkommende anrop og merke nummeret.

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

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

Anrop#

Hvert innkommende anrop, utgående anrop, simulering og widgetøkt blir en anropslogg. Et anrop inneholder hele utskriften med rolletagger, den strukturerte turhistorikken (inkludert verktøykall), et opptak, faktureringssummen og valgfri KI-vurdering og problemrapporter.

Mens et anrop er aktivt, kan du åpne det og lytte med — du deltar stille, og ingen i anropet hører deg. Når du lytter med, kan du hviske: skriv en instruksjon som går direkte til agenten din midt i anropet. Innringeren hører den aldri, og agenten følger den i sanntid.

I dashbordet: Anropshistorikk (/dashboard/call-history) for arkivet og detaljer for hvert anrop; Direkte for pågående anrop. Se Se gjennom, lytt til og veiled anropene dine.

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

Kundeportaler#

En kundeportal er en profilert, skrivebeskyttet visning av anropshistorikk for en ekstern kunde. Organisasjonsadministratorer velger stemmeagentene hvis anrop skal vises, legger til e-postadresser for godkjente brukere med lesetilgang, laster opp en logo og aksentfarge, og kan eventuelt verifisere et egendefinert domene. Portalbrukere kan se anropsdetaljer, utskrifter 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#

Nettwidgeten gir besøkende på nettstedet ditt en mikrofonbasert samtale med en agent — uten behov for telefonnummer. Den autentiserer med en publiserbar nøkkel (pk_live_...) som er opprinnelseslåst til de tillatte domenene dine, så den er trygg å bruke i klientkode.

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

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

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

Kunnskapsbaser#

En kunnskapsbase er en samling dokumenter agenten 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 agent i byggeren. Agenten 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 agent. Se Gi agenten din en kunnskapsbase.

Tilkoblinger#

Tilkoblinger er hvordan agenter når verden utenfor. Fire typer, én gruppe i sidepanelet:

• 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 for hver operasjon (send en Slack-melding, oppdater eller opprett en HubSpot-kontakt, bestill en Cal.com-tid…) for enhver agent. Se Koble til apper.
• API-er (/dashboard/api-connections) — gjør et hvilket som helst HTTP-API om til en agenthandling. Lim inn en cURL-kommando, så utarbeider AI-veiviseren verktøydefinisjonen, eller bygg den manuelt; en Test forespørsel-knapp utfører et sandkassekall før du lanserer. Se API-tilkoblinger — dashbordversjonen av /v1/integrations.
• MCP (/dashboard/mcp-connections) — legg til en Model Context Protocol-server via URL og la agenten bruke verktøyene den eksponerer. Se Legg til en MCP-server.
• VoIP (/dashboard/voip-connections) — leverandørlegitimasjon for å bruke dine egne telefonnumre. Se Koble til en VoIP-leverandør.

ThunderPhone eksponerer også sitt eget MCP-endepunkt, slik at en ekstern MCP-klient kan liste agenter, inspisere samtaler og transkripsjoner og foreta samtaler. 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 samtaler i stor skala: last opp en CSV med kontakter, velg agenten og nummeret det ringes fra, og angi ringevinduet (dager og timer, med tidssone), samtidighet og policy for nye forsøk (maksimalt antall forsøk og hvilke utfall — ikke svar, mobilsvar, mislykket — som skal prøves på nytt). Kampanjen arbeider seg gjennom listen og registrerer hver samtale i Samtalehistorikk.

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

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

Direkte overvå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. Det er overvåkingsflaten: følg med når en ny prompt får sin første faktiske trafikk, eller hold øye med en aktiv kampanje.

I dashbordet: Direkte (/dashboard/live). Se Se og overvåk direktesamtaler.

Simuleringer#

En simulering er en AI-innringer som har en ekte samtale med agenten din — samme telefonioppsett, 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 AI fra agentens prompt (inkludert kanttilfeller hvis du ber om det), og følg samtalen direkte.

Scenarioer grupperes i suiter som fastsetter en minste beståttprosent og kan styre lanseringer i CI; regresjoner mot den godkjente grunnlinjen 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 øyeblikk fra ekte samtaler om til repeterbare regresjonssjekker med én tur. Hvert eksempel fryser samtalekontekst, relevant lyd fra innringeren, det opprinnelige svaret og forventet atferd. Avspillinger kjører mot det gjeldende agentutkastet uten å foreta en ny samtale, og distribusjonsdialogen 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å faktisk trafikk: definer varianter (ulike prompter, motorer eller innstillinger), fordel trafikken mellom dem, og sammenlign resultater per variant. Bruk det i stedet for å lage egen bucket-logikk 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 — registrert av en menneskelig kontrollør eller oppdaget av AI-vurdering. Problemer har alvorlighetsgrad, kilde og status, og Problemsiden er triagekøen: filtrer, undersøk den berørte samtalen og følg opp rettinger.

I dashbordet: Problemer (/dashboard/issues), samt flagging per samtale i Anropshistorikk. Se Triage 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 et menneske forrige uke?") med en AI-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 varselregel overvåker en måleverdi (suksessrate, feilrate, gjennomsnittlig poengsum, samtalevolum, regresjoner i suiter) over et tidsvindu og utløses når den passerer terskelen din. Varsler sendes til e-post og Slack, og utløser en alert.triggered-hendelse til dine webhook-endepunkter.

I dashbordet: Organisasjon → Varsler. Se Varsler.

Webhooks#

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 styrer den pågående samtalen — hendelsene for innkommende samtaler (telephony.incoming / web.incoming). Du har opptil 10 sekunder på å svare; ved tidsavbrudd håndterer den statisk tildelte stemmeagenten samtalen.
• Ikke-blokkerende hendelser er varsler uten venting på svar og prøves på nytt med eksponentiell ventetid — se leveringssemantikk.

Hver forespørsel har en HMAC-SHA256-signatur i 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 serverne sine og sender 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 promptlinjer i stedet for verktøydefinisjoner.

I dashbordet: byggerens seksjon API-tilkoblinger (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 faktureringen. Inviter via e-post — invitasjoner utløper etter 7 dager og kan tilbakekalles; ⋯-menyen på en medlemsrad endrer roller eller fjerner noen. Enkeltpå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 USD-saldo; samtaler belastes med stemmeagentens minuttpris (motornivå pluss tillegg — byggeren viser totalprisen direkte når 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 Legg til midler og slå på automatisk påfylling, samt den komplette prisreferansen.

I API-et: /v1/billing.

Copiloten i appen#

Dashbordet leveres med en innebygd copilot — spør den «hvordan gjør jeg X», så svarer den basert på denne dokumentasjonen, tilbyr klikk-for-klikk-veiledninger som fremhever de faktiske kontrollene, og kan spille av hvilken som helst av de veiledede turene på nytt. Det er den raskeste måten å finne en kontroll som denne siden nevner. Se Spør copiloten i appen.

Sett det hele sammen#