> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 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 kartet: hvert konsept du møter, ett
kort avsnitt om gangen, med dashboardflaten og API-et som ligger bak
det. Skumles den én gang, og kom tilbake når et begrep trenger en
forklaring.
Sidefeltet i dashboardet gjenspeiler denne strukturen:
[Agenter](#agents), [telefonnumre](#phone-numbers),
[webwidgeter](#web-widgets), [samtaler](#calls),
[kunnskapsbaser](#knowledge-bases).
[Direkteovervå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), [eksperimenter](#experiments),
[problemer](#issues), [rapporter](#reports),
[observerbarhet](#observability).
[Team og roller](#team-and-roles), [API-nøkler](#organizations),
[varsler](#alerts), [fakturering](#billing).
[Webhooks](#webhooks) og [funksjonsverktøy](#function-tools) for
din egen kode.
***
## Organisasjoner
En **organisasjon** er enheten for tenant-isolering. 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 koblingen er det som gjør REST API-et så
enkelt: Du legger aldri inn en organisasjons-ID i URL-stier, fordi nøkkelen
din allerede identifiserer den.
**I dashboardet:** organisasjonsvelgeren (nederst i sidefeltet) og
innstillinger for **Organisasjon** — faner for Generelt, Nøkler, Varsler,
Faktureringsinnstillinger og Faktureringshistorikk.
**I API-et:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
***
## Agenter
En **agent** er AI-konfigurasjonen som håndterer 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 i stedet for separat konfigurasjon.
* Et **motornivå** (`spark`, `bolt`, `storm-*`): Spark er optimalisert
for kostnad, Bolt for hastighet og Storm for intelligens ved komplekse
prompter.
* En **stemme** samt et **primærspråk** og valgfrie **ekstra språk** —
agenten bytter automatisk når en innringer skifter 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 i et utkast**; ingenting blir aktivt
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 prompthjelpere.
***
## Telefonnumre
Et **telefonnummer** tilhører en organisasjon og ruter innkommende samtaler til en
stemmeagent (og kan brukes til utgående samtaler). To kilder:
* **Demonumre** — ekte amerikanske numre klargjort fra ThunderPhone sin
pool, klare på sekunder. Kun innkommende samtaler, de svarer med en kort
muntlig ansvarsfraskrivelse, og dashbordet begrenser en organisasjon til 10
av dem. Perfekt for en første test, men ikke for produksjon.
* **VoIP-numre** — hentet inn fra din egen leverandør gjennom en
[VoIP-tilkobling](#connections). Twilio og Telnyx kobles til direkte
(Telnyx har et veiledet oppsett); SignalWire og Vonage kommer snart —
i dag kobler du til disse via manuell SIP-konfigurasjon, som godtar enhver
SIP-trunk. Når de er importert og verifisert, støtter VoIP-numre både
innkommende og utgående samtaler.
Hver nummerrad lar deg angi en rutemodus, velge stemmeagent 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 til en **samtalelogg**. En samtale inneholder hele transkripsjonen med
rollemerking, den strukturerte turhistorikken (inkludert verktøykall), et
opptak, faktureringstotalen samt valgfri KI-vurdering og problemrapporter.
Mens en samtale **pågår**, kan du åpne den og **lytte med** — du kobler deg
til uten lyd, og ingen i samtalen hører deg. Når du lytter med, kan du
**hviske**: skriv en instruksjon som går direkte til stemmeagenten midt i
samtalen. Innringeren hører den aldri, og stemmeagenten følger den direkte.
**I dashbordet:** **Samtalehistorikk** (`/dashboard/call-history`) for
arkivet og detaljer per samtale; **Direkte** for pågående samtaler. Se
[Se gjennom, 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).
***
## Nettwidgeter
**Nettwidgeten** gir besøkende på nettstedet ditt en mikrofonbasert samtale
med en stemmeagent — uten behov for telefonnummer. Den autentiserer med en
**publiserbar nøkkel** (`pk_live_...`) som er låst til opprinnelsen for de
tillatte domenene dine, så den er trygg å bruke i kode på klientsiden.
Nøkler kjører i én av to moduser: `agent` (statisk bundet til én stemmeagent)
eller `webhook` (serveren din velger konfigurasjonen per besøkende — se
[Dynamisk konfigurasjon per samtale](/nb/guides/dynamic-call-config)). Widgetøkter
går gjennom den samme samtaleinfrastrukturen som telefonsamtaler.
**I dashbordet:** **Nettwidgeter** (`/dashboard/web-widgets`) —
opprett widgeter, angi modus og stemmeagent, administrer tillatte domener og
kopier innebyggingsutdraget. 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 kan søke i
midt i samtalen for å forankre svarene sine — last opp filer direkte eller
importer fra Google Drive, 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 agenter 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 verktøy for hver operasjon
(send en Slack-melding, oppdater eller opprett en HubSpot-kontakt, bestill et
Cal.com-tidspunkt …) på for enhver agent. Se [Koble til apper](/nb/guides/connect-apps).
* **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; knappen **Test forespørsel**
utfører et sandkassekall før du lanserer. Se
[API-tilkoblinger](/nb/guides/api-connections) — dashbordgrensesnittet til
[`/v1/integrations`](/api-reference/integrations).
* **MCP** (`/dashboard/mcp-connections`) — legg til en Model Context
Protocol-server via URL, og la agenten bruke verktøyene den tilbyr.
Se [Legg til en MCP-server](/nb/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — leverandørlegitimasjon for
[å bruke dine egne telefonnumre](#phone-numbers). Se
[Koble til en VoIP-leverandør](/nb/guides/voip-providers).
**I API-et:** [`/v1/integrations`](/api-reference/integrations) 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 samtaler i stor skala: last opp en CSV-fil med
kontakter, velg agenten og avsendernummeret, og angi ringevinduet
(dager og timer, med tidssone), samtidighet og retningslinjer for nye forsøk
(maksimalt antall forsøk og hvilke utfall — ikke svar, telefonsvarer, mislykket — som
skal prøves på nytt). Kampanjen går gjennom listen og registrerer hver samtale
i Samtalehistorikk.
**I dashbordet:** **Kampanjer** (`/dashboard/campaigns`). Se
[Kjør en kampanje for utgående samtaler](/nb/guides/outbound-campaigns).
**For enkeltstående programmatisk utførte samtaler:**
[API-et for utgående samtaler](/nb/guides/place-outbound-calls).
***
## Sanntidsovervåking
**Live** viser alle pågående samtaler i hele organisasjonen, og lar deg
åpne hvilken som helst av dem for å [lytte med og hviske](#calls) i sanntid. Det er
overvåkingsflaten: følg med når en ny prompt får sin første reelle
trafikk, eller hold øye med en aktiv kampanje.
**I dashbordet:** **Live** (`/dashboard/live`). Se
[Se og overvåk samtaler i sanntid](/nb/guides/monitor-live-calls).
***
## Simuleringer
En **simulering** er en AI-oppringer som har en ekte samtale med
agenten din — samme telefoniflyt, ekte transkripsjon, ekte vurdering — slik at du
kan teste før (og etter) du lanserer. Rett den mot en agent eller et telefonnummer,
skriv oppringerscenarioet selv, eller **generer scenarioer
med AI** fra agentens prompt (inkludert randtilfeller hvis du ber om det),
og følg samtalen direkte.
Scenarioer grupperes i **suiter** som fastsetter en minimumsrate for bestått 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](/nb/guides/simulate-a-call).
**I API-et:** [`/v1/test-calls`](/api-reference/test-calls) og
suitekjøreren — se [Test en agent fra ende til ende](/nb/guides/test-agents).
***
## Eksperimenter
Et **eksperiment** A/B-tester agentkonfigurasjoner på direktetrafikk:
definer varianter (ulike prompter, motorer eller innstillinger), fordel
trafikken mellom dem, og sammenlign utfall per variant. Bruk det i stedet
for å bygge bøttelogikk manuelt 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 — rapportert av en
menneskelig kontrollør eller oppdaget av KI-evaluering. Problemer har alvorlighetsgrad,
kilde og status, og Problems-siden er triagekøen: filtrer,
undersøk samtalen det gjelder, og følg opp rettinger.
**I dashbordet:** **Problemer** (`/dashboard/issues`), samt flagging per samtale
i samtalehistorikken. Se [triagering 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 et menneske forrige
uke?") med en KI-skrevet analyse, avgrenset til stemmeagentene og datointervallet
du velger.
**I dashbordet:** **Rapporter** (`/dashboard/reports`). Se
[Rapporter](/nb/guides/reports).
***
## Observerbarhet
**Observerbarhet** er flaten for målinger: samtalevolum, utfall og
kvalitet over tid, filtrerbart etter stemmeagent og tidsvindu, med eksport
for videre analyse.
**I dashbordet:** **Observerbarhet** (`/dashboard/observability`).
Se [Observerbarhet](/nb/guides/observability).
***
## Varsler
En **varslingsregel** overvåker en måling (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).
***
## Webhooks
ThunderPhone sender **HTTP POST-webhooks** 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 per endepunkt 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**. Beholdt for bakoverkompatibilitet.
Hendelser deles inn i to klasser:
* **Blokkerende hendelser** forventer at serveren din svarer med konfigurasjon
som former den pågående samtalen — hendelsene for
[innkommende samtaler](/nb/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Du har opptil 10 sekunder
på å svare; ved tidsavbrudd håndterer den statisk tilordnede stemmeagenten
samtalen.
* **Ikke-blokkerende hendelser** er varsler som sendes uten å vente på svar, og prøves på nytt
med eksponentiell backoff — se
[leveringssemantikk](/nb/webhooks/overview).
Hver forespørsel har en HMAC-SHA256-signatur i
`X-ThunderPhone-Signature`. Se
[signaturverifisering](/nb/webhooks/overview).
***
## Funksjonsverktøy
Et **funksjonsverktøy** er et HTTP-endepunkt som stemmeagenten din kan kalle
midt i en samtale. Du gir ThunderPhone et funksjonsskjema i OpenAI-stil
samt en endepunkt-URL; stemmeagenten bestemmer når den skal kalle det, og
ThunderPhone gjør den signerte HTTP-forespørselen fra sine servere og gir
resultatet tilbake til stemmeagenten.
Stemmeagenter leveres også med **innebygde samtalefunksjoner** — å overføre samtalen,
sende tastaturinngang (DTMF), avslutte samtalen, vente på vent — som
du aktiverer med vanlige promptlinjer i stedet for verktøydefinisjoner.
**I dashbordet:** byggerens seksjon for **API-tilkoblinger** (se
[Tilkoblinger](#connections)).
**I API-et:** [`/v1/integrations`](/api-reference/integrations) og
[spesifikasjonen for Function Tools](/nb/tools/overview).
***
## Team og roller
Hver organisasjon har en medlemsliste med to roller: **Medlemmer** bygger
og drifter stemmeagenter; **Administratorer** administrerer også teamet og fakturering.
Inviter via e-post — invitasjoner utløper etter 7 dager og kan trekkes tilbake;
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 minuttpris (motornivå pluss tillegg —
byggeren viser totalprisen fortløpende når du endrer innstillinger, og
[premiumsprog](/nb/guides/supported-languages) legger til 2¢/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
[Fyll på saldo og slå på automatisk påfylling](/nb/guides/billing-and-topups).
**I API-et:** [`/v1/billing`](/api-reference/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 trinnvise veiledninger
som fremhever de faktiske kontrollene, og kan spille av alle de veiledede
omvisningene på nytt. Det er den raskeste måten å finne en kontroll som denne
siden nevner. Se [Spør copiloten i appen](/nb/guides/ask-the-copilot).
***
## Sett det hele sammen
Veiviseren i fem trinn: agent → fakturering → nummer → simulering → gjennomgang.
Det samme første anropet med fire REST-kall.
Bygg en agent, fyll på saldo, få et nummer, simuler og gjennomgå samtaler.
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.