---
title: "Kjernekonsepter"
description: "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:
[Agenter](#agents), [stemmer](#voices), [telefonnumre](#phone-numbers),
[nettwidgeter](#web-widgets), [samtaler](#calls),
[kundeportaler](#client-portals), [kunnskapsbaser](#knowledge-bases).
[Liveovervåking](#live-monitoring) og utgående
[kampanjer](#campaigns).
[Apper, API-er, MCP-servere og VoIP-leverandører](#connections) som
agentene dine kan bruke.
[Simuleringer](#simulations), [valideringssett](#validation-sets),
[eksperimenter](#experiments),
[problemer](#issues), [rapporter](#reports),
[observerbarhet](#observability).
[Team og roller](#team-and-roles), [API-nøkler](#organizations),
[varsler](#alerts), [fakturering](#billing).
[Webhooker](#webhooks) og [funksjonsverktøy](#function-tools) for
din egen kode.
---
## 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](/nb/guides/organization-settings).
**I API-et:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/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](/nb/guides/supported-languages).
- Tilknyttede funksjoner: [tilkoblede apper](#connections),
[API-tilkoblinger](#connections), [kunnskapsbaser](#knowledge-bases),
[MCP-servere](#connections) og innebygde
[funksjonsverktøy](#function-tools).
- 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](/nb/guides/build-an-agent).
**I API-et:** [`/v1/agents`](/api-reference/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](/nb/guides/voice-library).
**I API-et:** [`/v1/voices`](/api-reference/voices),
[stemmeeksempler](/api-reference/voice-samples) og
[egendefinerte stemmer](/api-reference/custom-voices).
---
## 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, {/* rate:phone */}$1/måned pluss et tillegg på 1¢/minutt{/* /rate */}.
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](#connections). 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](/nb/guides/get-a-phone-number).
**I API-et:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/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](/nb/guides/review-calls).
**I API-et:** [`/v1/calls`](/api-reference/calls) — liste, transkripsjon,
historikk, lyd, vurdering, eksport;
[`/v1/issue-reports`](/api-reference/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](/nb/guides/client-portals).
**I API-et:** [`/v1/client-portals`](/api-reference/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](/nb/guides/dynamic-call-config)). 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](/nb/guides/embed-a-web-widget-dashboard).
**I API-et:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) og
[Widget SDK-dokumentasjonen](/nb/widget/overview).
---
## 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](/nb/guides/knowledge-base).
---
## 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](/nb/guides/connect-apps).
- **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](/nb/guides/api-connections) — dashbordvisningen av
[`/v1/integrations`](/api-reference/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](/nb/guides/mcp-servers).
- **VoIP** (`/dashboard/voip-connections`) — leverandørlegitimasjon for
[å bruke egne telefonnumre](#phone-numbers). Se
[Koble til en VoIP-leverandør](/nb/guides/voip-providers).
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](/nb/guides/thunderphone-mcp-server).
**I API-et:** [`/v1/integrations`](/api-reference/integrations),
[`/v1/mcp-servers`](/api-reference/mcp-servers) og
[`/v1/voip-connections`](/api-reference/voip-connections); se også
[Bygg en verktøyintegrasjon](/nb/guides/build-tool-integration).
---
## 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](/nb/guides/outbound-campaigns).
**For enkeltstående programmatisk utførte anrop:**
[API-et for utgående anrop](/nb/guides/place-outbound-calls).
## 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](#calls) 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](/nb/guides/monitor-live-calls).
---
## 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](/nb/guides/simulate-a-call).
**I API-et:** [`/v1/test-calls`](/api-reference/test-calls) og
suitekjøreren — se [Test en agent ende til ende](/nb/guides/test-agents).
---
## 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](/nb/guides/validation-sets).
**I API-et:** [`/v1/validation-sets`](/api-reference/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)](/nb/guides/experiments-ab-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](/nb/guides/issues).
**I API-et:** [`/v1/issue-reports`](/api-reference/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](/nb/guides/reports).
---
## 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](/nb/guides/observability).
---
## 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](/nb/webhooks/endpoints) dine.
**I dashbordet:** **Organisasjon → Varsler**. Se
[Varsler](/nb/guides/alerts).
---
## 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`](/nb/webhooks/endpoints) med
hemmeligheter og hendelsesabonnementer per endepunkt.
- **Eldre webhook med én URL**: én URL per organisasjon. Administreres på
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-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](/nb/webhooks/call-incoming)
(`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](/nb/webhooks/overview).
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](/nb/webhooks/overview).
---
## 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](#connections)).
**I API-et:** [`/v1/integrations`](/api-reference/integrations) og
[spesifikasjonen for funksjonsverktøy](/nb/tools/overview).
---
## 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](/nb/guides/sso).
**I dashbordet:** **Organisasjon → Generelt**. Se
[Inviter teamet ditt](/nb/guides/invite-your-team).
**I API-et:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/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](/nb/guides/supported-languages) legger til {/* rate:language */}3¢/min{/* /rate */}). 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](/nb/guides/billing-and-topups), samt
[den komplette prisreferansen](/nb/guides/pricing).
**I API-et:** [`/v1/billing`](/api-reference/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](/nb/guides/ask-the-copilot).
---
## Slik henger det sammen
Veiviseren i fem trinn: agent → fakturering → nummer → simulering → gjennomgang.
Det samme første anropet i fire REST-kall.
Bygg en agent, fyll på saldo, få et nummer, simuler og gjennomgå anrop.
OAuth-apper, egendefinerte API-er, MCP-servere og VoIP-leverandører.
Rapporter, observerbarhet, eksperimenter, problemer og varsler.
Invitasjoner og roller, API-nøkler, sikkerhet og SSO.
API-oppskriftene: innkommende, utgående, dynamisk konfigurasjon, verktøy, testing.
Få HMAC-kontrollen riktig én gang, og gjenbruk den overalt.