> ## 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.
# Grundlæggende begreber
> Et overblik over alt på platformen — hvad hvert objekt gør, hvor det findes i dashboardet, og hvilket API der berører det.
ThunderPhone er en komplet platform til at bygge, køre og forbedre
AI-stemmeagenter. Denne side er kortet: hvert koncept, du møder, har
sit eget korte afsnit med dashboardfladen og API'et, der understøtter
det. Skim den én gang, og vend tilbage, når et begreb skal forklares.
Sidebjælken i dashboardet afspejler denne struktur:
[Agenter](#agents), [telefonnumre](#phone-numbers),
[webwidgets](#web-widgets), [opkald](#calls),
[vidensbaser](#knowledge-bases).
[Liveovervågning](#live-monitoring) og udgående
[kampagner](#campaigns).
[Apps, API'er, MCP-servere og VoIP-udbydere](#connections), som
dine agenter kan bruge.
[Simuleringer](#simulations), [eksperimenter](#experiments),
[problemer](#issues), [rapporter](#reports),
[observerbarhed](#observability).
[Team og roller](#team-and-roles), [API-nøgler](#organizations),
[advarsler](#alerts), [fakturering](#billing).
[Webhooks](#webhooks) og [funktionsværktøjer](#function-tools) til
din egen kode.
***
## Organisationer
En **organisation** er enheden for tenant-adskillelse. Alle andre
ressourcer — agenter, telefonnumre, opkald, nøgler — tilhører præcis én
organisation. Din konto kan tilhøre mange organisationer; hver har sin
egen saldo, sine egne nøgler og sin egen medlemsliste.
Den `sk_live_` API-nøgle, du opretter under **Organisation → Nøgler**,
er knyttet til én organisation. Denne tilknytning gør REST API'et så
fladt: Du angiver aldrig et organisations-id i URL-stier, fordi din
nøgle allerede identificerer organisationen.
**I dashboardet:** organisationsvælgeren (nederst i sidebjælken) og
indstillingerne for **Organisation** — faner for Generelt, Nøgler,
Advarsler, Faktureringsindstillinger og Faktureringshistorik.
**I API'et:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
***
## Agenter
En **agent** er AI-konfigurationen, der kører et opkald. Den samler:
* En **prompt**, der styrer, hvad agenten siger, og hvordan den
opfører sig — herunder opkaldshandlinger som viderestillinger,
tastetryk og afslutning af opkald, som er almindelige promptlinjer
frem for separat konfiguration.
* Et **motorniveau** (`spark`, `bolt`, `storm-*`): Spark er optimeret
til pris, Bolt til hastighed og Storm til intelligens i komplekse
prompter.
* En **stemme** samt et **primært sprog** og valgfri **yderligere
sprog** — agenten skifter automatisk, når en opkalder skifter sprog.
Se [Understøttede sprog](/da/guides/supported-languages).
* Tilknyttede funktioner: [tilsluttede apps](#connections),
[API-forbindelser](#connections), [vidensbaser](#knowledge-bases),
[MCP-servere](#connections) og indlejrede
[funktionsværktøjer](#function-tools).
* Adfærdsindstillinger: talerækkefølge, bekræftelsestilstand,
baggrundsspor, tidsgrænse for venteposition.
Redigeringer i builderen **gemmes automatisk som en kladde**; intet går
live, før du klikker på **Udgiv**. Hver udgivelse gemmes som et
øjebliksbillede i builderens fane **Historik**, så du kan gennemse og
gendanne enhver tidligere version.
**I dashboardet:** **Stemmeagenter** → agentbuilderen
(`/dashboard/agents`). Se
[Byg din første stemmeagent](/da/guides/build-an-agent).
**I API'et:** [`/v1/agents`](/api-reference/agents) — CRUD,
duplikering, overførsel, versionshistorik og promphjælpere.
***
## Telefonnumre
Et **telefonnummer** tilhører en organisation og dirigerer indgående opkald til en
agent (og kan håndtere udgående opkald). To kilder:
* **Demonstrationsnumre** — rigtige amerikanske numre klargjort fra ThunderPhones
pulje, klar på få sekunder. Kun indgående opkald, de svarer med en kort mundtlig
ansvarsfraskrivelse, og dashboardet begrænser en organisation til 10 af dem. Perfekt til
en første test, men ikke til produktion.
* **VoIP-numre** — medbringes fra din egen udbyder via en
[VoIP-forbindelse](#connections). Twilio og Telnyx forbindes direkte
(Telnyx har en guidet opsætning); SignalWire og Vonage kommer snart —
i dag når du dem via manuel SIP-konfiguration, som accepterer enhver
SIP-trunk. Når de er importeret og verificeret, understøtter VoIP-numre
indgående og udgående opkald.
Hver nummerrække lader dig angive en routingtilstand, vælge den
indgående agent og navngive nummeret.
**I dashboardet:** **Telefonnumre** (`/dashboard/phone-numbers`).
Se [Få et telefonnummer](/da/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).
***
## Opkald
Hvert indgående opkald, udgående opkald, simulering og widgetsession
bliver til en **opkaldslog**. Et opkald indeholder den fulde rollemarkerede
transskription, den strukturerede turhistorik (herunder værktøjskald), en
optagelse, den samlede fakturering samt valgfri AI-vurdering og problemrapporter.
Mens et opkald er **live**, kan du åbne det og **lytte med** — du deltager
lydløst, og ingen i opkaldet kan høre dig. Når du lytter med, kan du
**hviske**: skriv en instruktion, der sendes direkte til din agent
midt i opkaldet; opkalderen hører den aldrig, og agenten følger den med det samme.
**I dashboardet:** **Opkaldshistorik** (`/dashboard/call-history`) for
arkivet og detaljer for hvert opkald; **Live** for igangværende opkald. Se
[Gennemgå, lyt til og vejled dine opkald](/da/guides/review-calls).
**I API'et:** [`/v1/calls`](/api-reference/calls) — liste, transskription,
historik, lyd, vurdering, eksport;
[`/v1/issue-reports`](/api-reference/issue-reports).
***
## Webwidgets
**Webwidgetten** giver besøgende på dit website en mikrofonbaseret samtale
med en agent — intet telefonnummer er nødvendigt. Den godkender med en
**offentlig nøgle** (`pk_live_...`), som er oprindelseslåst til dine
tilladte domæner, så den er sikker at bruge i klientsidekode.
Nøgler kører i en af to tilstande: `agent` (statisk bundet til én agent)
eller `webhook` (din server vælger konfigurationen pr. besøgende — se
[Dynamisk konfiguration pr. opkald](/da/guides/dynamic-call-config)). Widgetsessioner
går gennem den samme opkaldsinfrastruktur som telefonopkald.
**I dashboardet:** **Webwidgets** (`/dashboard/web-widgets`) —
opret widgets, angiv tilstand og agent, administrer tilladte domæner, og
kopiér indlejringskodestykket. Se
[Opret en webwidget](/da/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-dokumentationen](/da/widget/overview).
***
## Vidensbaser
En **vidensbase** er en samling dokumenter, som din agent kan søge i
midt i et opkald for at underbygge sine svar — upload filer direkte eller importér fra
Google Drive, og tilknyt derefter vidensbasen til en agent i
byggeren. Agenten forespørger den med et indbygget søgeværktøj, når
samtalen kræver det.
**I dashboardet:** **Viden** (`/dashboard/knowledge`) for
dokumentbiblioteket; byggerens sektion **Viden** til at tilknytte en til
en agent. Se
[Giv din agent en vidensbase](/da/guides/knowledge-base).
***
## Forbindelser
Forbindelser er, hvordan agenter når ud til omverdenen. Fire typer, én
gruppe i sidepanelet:
* **Apps** (`/dashboard/app-connections`) — OAuth-forbindelser til
Slack, HubSpot, Salesforce, Google Kalender, Google Sheets og
Cal.com. Opret forbindelse én gang, og aktivér derefter værktøjer
for hver handling (send en Slack-besked, opret eller opdater en
HubSpot-kontakt, book et Cal.com-tidsrum…) for enhver agent. Se
[Forbind apps](/da/guides/connect-apps).
* **API'er** (`/dashboard/api-connections`) — gør ethvert HTTP-API til
en agenthandling. Indsæt en cURL-kommando, så udarbejder AI-guiden
værktøjsdefinitionen, eller opbyg den manuelt; knappen **Test anmodning**
foretager et sandboxkald, før du udgiver. Se
[API-forbindelser](/da/guides/api-connections) — dashboardets visning af
[`/v1/integrations`](/api-reference/integrations).
* **MCP** (`/dashboard/mcp-connections`) — tilføj en Model Context
Protocol-server via URL, og lad agenten bruge de værktøjer, den eksponerer.
Se [Tilføj en MCP-server](/da/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — udbyderoplysninger til
[at bruge dine egne telefonnumre](#phone-numbers). Se
[Forbind en VoIP-udbyder](/da/guides/voip-providers).
**I API'et:** [`/v1/integrations`](/api-reference/integrations) og
[`/v1/voip-connections`](/api-reference/voip-connections); se også
[Byg en værktøjsintegration](/da/guides/build-tool-integration).
***
## Kampagner
En **kampagne** foretager udgående opkald i stor skala: upload en CSV-fil med
kontakter, vælg agenten og afsendernummeret, og angiv opkaldsvinduet
(dage og timer med tidszone), samtidighed og genforsøgspolitik
(maksimalt antal forsøg og hvilke udfald — intet svar, telefonsvarer, mislykket — der
forsøges igen). Kampagnen arbejder sig gennem listen og registrerer hvert opkald
i Opkaldshistorik.
**I dashboardet:** **Kampagner** (`/dashboard/campaigns`). Se
[Kør en kampagne med udgående opkald](/da/guides/outbound-campaigns).
**Til enkeltstående programmatisk opkald:**
[API'et til udgående opkald](/da/guides/place-outbound-calls).
***
## Liveovervågning
**Live** viser alle igangværende opkald i hele organisationen og lader dig
åbne ethvert af dem for at [lytte med og hviske](#calls) i realtid. Det er
overvågningsfladen: se en ny prompt få sin første reelle
trafik, eller hold øje med en kørende kampagne.
**I dashboardet:** **Live** (`/dashboard/live`). Se
[Se og overvåg liveopkald](/da/guides/monitor-live-calls).
***
## Simulationer
En **simulation** er en AI-opkalder, der har en reel samtale med din
agent — samme telefoniforløb, reel transskription, reel evaluering — så du
kan teste, før (og efter) du udgiver. Ret den mod en agent eller et telefonnummer,
skriv selv opkalderens scenarie, eller **generér scenarier
med AI** ud fra agentens prompt (inklusive særtilfælde, hvis du beder om det),
og se opkaldet live.
Scenarier grupperes i **suiter**, der fastsætter en minimumsbeståelsesrate og kan
blokere udgivelser i CI; regressioner i forhold til den godkendte baseline
rapporteres pr. scenarie.
**I dashboardet:** **Simulationer** (`/dashboard/simulations`) samt
knappen **Simulation** i agentbyggeren. Se
[Simulér et opkald](/da/guides/simulate-a-call).
**I API'et:** [`/v1/test-calls`](/api-reference/test-calls) og
suitekøreren — se [Test en agent ende til ende](/da/guides/test-agents).
***
## Eksperimenter
Et **eksperiment** A/B-tester agentkonfigurationer på reel trafik:
definér varianter (forskellige prompter, motorer eller indstillinger), fordel
trafikken mellem dem, og sammenlign udfald pr. variant. Brug det i stedet
for at opbygge bucketlogik manuelt i en webhook.
**I dashboardet:** **Eksperimenter** (`/dashboard/experiments`) og
fanen **A/B** i agentbyggeren. Se
[Eksperimenter (A/B-test)](/da/guides/experiments-ab-testing).
***
## Problemer
Et **problem** er et markeret problem på et bestemt opkald — indberettet af en
menneskelig reviewer eller opdaget af AI-bedømmelse. Problemer har alvorlighedsgrad,
kilde og status, og siden Problemer er triagekøen: filtrer,
undersøg det problematiske opkald, og følg rettelser.
**I dashboardet:** **Problemer** (`/dashboard/issues`) samt markering
pr. opkald i Opkaldshistorik. Se [Problemtriage](/da/guides/issues).
**I API'et:** [`/v1/issue-reports`](/api-reference/issue-reports).
***
## Rapporter
En **rapport** besvarer et spørgsmål på naturligt sprog om dine opkaldsdata
("Hvad var de tre hyppigste årsager til, at opkaldere bad om et menneske i
sidste uge?") med en AI-skrevet analyse, afgrænset til de agenter og det
datointerval, du vælger.
**I dashboardet:** **Rapporter** (`/dashboard/reports`). Se
[Rapporter](/da/guides/reports).
***
## Observerbarhed
**Observerbarhed** er metrikoversigten: opkaldsvolumen, resultater og
kvalitet over tid, som kan filtreres efter agent og tidsvindue, med eksport
til efterfølgende analyse.
**I dashboardet:** **Observerbarhed** (`/dashboard/observability`).
Se [Observerbarhed](/da/guides/observability).
***
## Advarsler
En **advarselsregel** overvåger en metrik (succesrate, fejlrate,
gennemsnitlig score, opkaldsvolumen, regressioner i testpakker) over et tidsvindue og
udløses, når den krydser din tærskel. Notifikationer sendes til e-mail og
Slack og udløser en `alert.triggered`-hændelse til dine
[webhookendpoints](/da/webhooks/endpoints).
**I dashboardet:** **Organisation → Advarsler**. Se
[Advarsler](/da/guides/alerts).
***
## Webhooks
ThunderPhone sender **HTTP POST-webhooks** til din server, når der
sker ting under og efter et opkald. To leveringsmodeller:
* **Webhookendpoints** (anbefalet): administrer mange URL'er på
[`/v1/developer/webhook-endpoints`](/da/webhooks/endpoints) med
hemmeligheder pr. endpoint og hændelsesabonnementer pr. endpoint.
* **Ældre webhook med enkelt URL**: én URL pr. organisation. Administreres på
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
eller under **Organisation → Generelt**. Beholdt for bagudkompatibilitet.
Hændelser opdeles i to klasser:
* **Blokerende hændelser** forventer, at din server svarer med konfiguration,
der former det igangværende opkald — [indgående opkaldshændelser](/da/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Du har op til 10 sekunder
til at svare; ved timeout håndterer den statisk tildelte agent
opkaldet.
* **Ikke-blokerende hændelser** er fire-and-forget-notifikationer, der genforsøges
med eksponentiel backoff — se
[leveringssemantik](/da/webhooks/overview).
Hver anmodning indeholder en HMAC-SHA256-signatur i
`X-ThunderPhone-Signature`. Se
[Signaturverifikation](/da/webhooks/overview).
***
## Funktionsværktøjer
Et **funktionsværktøj** er et HTTP-endpoint, som din agent kan kalde
midt i en samtale. Du giver ThunderPhone et funktionsskema i OpenAI-stil
samt en endpoint-URL; agenten beslutter, hvornår den skal kalde det, og
ThunderPhone foretager den signerede HTTP-anmodning fra sine servere og giver
resultatet tilbage til agenten.
Agenter leveres også med **indbyggede opkaldsfunktioner** — overførsel af opkaldet,
afsendelse af tastaturindtastning (DTMF), afslutning af opkaldet, venten på hold — som
du aktiverer med almindelige promptlinjer i stedet for værktøjsdefinitioner.
**I dashboardet:** builderens sektion **API-forbindelser** (se
[Forbindelser](#connections)).
**I API'et:** [`/v1/integrations`](/api-reference/integrations) og
specifikationen [Funktionsværktøjer](/da/tools/overview).
***
## Team og roller
Hver organisation har en medlemsliste med to roller: **Medlemmer** bygger
og driver agenter; **Administratorer** administrerer også teamet og fakturering.
Inviter via e-mail — invitationer udløber efter 7 dage og kan tilbagekaldes;
menuen ⋯ på en medlemsrække ændrer roller eller fjerner en person. Single
sign-on kan konfigureres for hele organisationen — se [SSO](/da/guides/sso).
**I dashboardet:** **Organisation → Generelt**. Se
[Inviter dit team](/da/guides/invite-your-team).
**I API'et:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
***
## Fakturering
ThunderPhone er **forudbetalt**. Hver organisation har en saldo i USD; opkald
trækker fra den til agentens minutpris (motorniveau plus tillæg —
builderen viser den samlede pris live, når du ændrer indstillinger, og
[premiumsprog](/da/guides/supported-languages) tilføjer 2 ¢/min). Når
saldoen når nul, afvises indgående opkald, og udgående opkald returnerer
`402 Payment Required`.
Indbetal manuelt, eller aktivér **automatisk optankning** med en
saldotærskel, et optankningsbeløb og en valgfri månedlig forbrugsgrænse —
så et opkald aldrig afbrydes midt i en sætning.
**I dashboardet:** **Organisation → Faktureringsindstillinger** og
**Faktureringshistorik**. Se
[Indbetal penge, og aktivér automatisk optankning](/da/guides/billing-and-topups).
**I API'et:** [`/v1/billing`](/api-reference/billing).
***
## Copiloten i appen
Dashboardet leveres med en indbygget **copilot** — spørg den "hvordan gør jeg X",
så svarer den ud fra denne dokumentation, tilbyder trin-for-trin-vejledninger
med fremhævning af de faktiske kontrolelementer og kan genafspille alle de
guidede rundvisninger. Det er den hurtigste måde at finde et kontrolelement,
som denne side nævner. Se [Spørg copiloten i appen](/da/guides/ask-the-copilot).
***
## Det hele samlet
Guiden med fem trin: agent → fakturering → nummer → simulering → gennemgang.
Det samme første opkald i fire REST-kald.
Byg en agent, indsæt penge på den, få et nummer, simulér og gennemgå opkald.
OAuth-apps, brugerdefinerede API'er, MCP-servere og VoIP-udbydere.
Rapporter, observerbarhed, eksperimenter, problemer og advarsler.
Invitationer og roller, API-nøgler, sikkerhed og SSO.
API-opskrifterne: indgående, udgående, dynamisk konfiguration, værktøjer, test.
Få HMAC-kontrollen rigtig én gang, og genbrug den overalt.