> ## 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äggande begrepp
> En karta över allt i plattformen – vad varje objekt gör, var det finns i instrumentpanelen och vilket API som använder det.
ThunderPhone är en komplett plattform för att bygga, köra och förbättra
AI-röstagenter. Den här sidan är kartan: varje koncept du möter, ett
kort avsnitt för varje, med gränssnittet i dashboarden och API:et som
stöder det. Skumma igenom den en gång och kom tillbaka när du behöver
reda ut en term.
Sidofältet i dashboarden speglar den här strukturen:
[Agenter](#agents), [telefonnummer](#phone-numbers),
[webbwidgetar](#web-widgets), [samtal](#calls),
[kunskapsbaser](#knowledge-bases).
[Liveövervakning](#live-monitoring) och utgående
[kampanjer](#campaigns).
[Appar, API:er, MCP-servrar och VoIP-leverantörer](#connections) som dina
agenter kan använda.
[Simuleringar](#simulations), [experiment](#experiments),
[problem](#issues), [rapporter](#reports),
[observerbarhet](#observability).
[Team och roller](#team-and-roles), [API-nycklar](#organizations),
[aviseringar](#alerts), [fakturering](#billing).
[Webhooks](#webhooks) och [funktionsverktyg](#function-tools) för
din egen kod.
***
## Organisationer
En **organisation** är en tenant-enhet. Varje annan resurs —
agenter, telefonnummer, samtal, nycklar — tillhör exakt en organisation. Ditt
konto kan tillhöra flera organisationer; var och en har eget saldo, egna
nycklar och en egen medlemslista.
API-nyckeln `sk_live_` som du skapar under **Organisation → Nycklar** är
bunden till en organisation. Den bindningen är det som gör REST API:et så
platt: du behöver aldrig ange ett organisations-id i URL-sökvägar, eftersom
din nyckel redan identifierar organisationen.
**I dashboarden:** organisationsväxlaren (längst ned i sidofältet) och
inställningarna för **Organisation** — flikar för Allmänt, Nycklar, Aviseringar, Faktureringsinställningar
och Faktureringshistorik.
**I API:et:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
***
## Agenter
En **agent** är AI-konfigurationen som hanterar ett samtal. Den omfattar:
* En **prompt** som styr vad agenten säger och hur den beter sig —
inklusive samtalsåtgärder som vidarekopplingar, knappsatsinmatningar och
avslut av samtal, som är vanliga rader i prompten i stället för separat konfiguration.
* En **motornivå** (`spark`, `bolt`, `storm-*`): Spark är optimerad
för kostnad, Bolt för hastighet och Storm för intelligens i komplexa prompter.
* En **röst** samt ett **primärt språk** och valfria **ytterligare
språk** — agenten växlar automatiskt när en uppringare byter
språk. Se [Språk som stöds](/sv/guides/supported-languages).
* Anslutna funktioner: [anslutna appar](#connections),
[API-anslutningar](#connections), [kunskapsbaser](#knowledge-bases),
[MCP-servrar](#connections) och integrerade
[funktionsverktyg](#function-tools).
* Beteendeinställningar: talordning, bekräftelseläge, bakgrundsspår,
tidsgräns för vänteläge.
Ändringar i byggaren **autosparas i ett utkast**; inget tas i drift förrän
du klickar på **Distribuera**. Varje driftsättning sparas som en ögonblicksbild på byggarens
flik **Historik**, så att du kan granska och återställa en tidigare version.
**I dashboarden:** **Röstagenter** → agentbyggaren
(`/dashboard/agents`). Se
[Bygg din första röstagent](/sv/guides/build-an-agent).
**I API:et:** [`/v1/agents`](/api-reference/agents) — CRUD,
duplicering, överföring, versionshistorik och prompthjälpmedel.
***
## Telefonnummer
Ett **telefonnummer** tillhör en organisation och dirigerar inkommande samtal till en
agent (och kan användas för utgående samtal). Två källor:
* **Demonummer** — riktiga amerikanska nummer som tillhandahålls från ThunderPhones
pool och är aktiva på några sekunder. Endast inkommande samtal, de svarar med en kort
talad ansvarsfriskrivning och instrumentpanelen begränsar en organisation till 10 av dem.
Perfekt för ett första test, men inte för produktion.
* **VoIP-nummer** — tas med från din egen leverantör via en
[VoIP-anslutning](#connections). Twilio och Telnyx ansluts direkt
(Telnyx har en guidad konfiguration); SignalWire och Vonage kommer snart —
i dag når du dem via manuell SIP-konfiguration, som accepterar valfri
SIP-trunk. När de har importerats och verifierats stöder VoIP-nummer både
inkommande och utgående samtal.
På varje nummerrad kan du ange ett routningsläge, välja agent för inkommande samtal
och märka numret.
**I instrumentpanelen:** **Telefonnummer** (`/dashboard/phone-numbers`).
Se [Skaffa ett telefonnummer](/sv/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).
***
## Samtal
Varje inkommande samtal, utgående samtal, simulering och widgetsession
blir en **samtalslogg**. Ett samtal innehåller hela den rollmärkta transkriptionen,
den strukturerade turhistoriken (inklusive verktygsanrop), en inspelning,
faktureringssumman samt valfri AI-betygsättning och felrapporter.
När ett samtal är **aktivt** kan du öppna det och **lyssna med** — du ansluter
tyst och ingen i samtalet hör dig. När du lyssnar med kan du
**viska**: skriv en instruktion som skickas direkt till din agent
mitt under samtalet; uppringaren hör den aldrig och agenten följer den direkt.
**I instrumentpanelen:** **Samtalshistorik** (`/dashboard/call-history`) för
arkivet och information per samtal; **Live** för pågående samtal. Se
[Granska, lyssna på och coacha dina samtal](/sv/guides/review-calls).
**I API:et:** [`/v1/calls`](/api-reference/calls) — lista, transkription,
historik, ljud, betygsättning, export;
[`/v1/issue-reports`](/api-reference/issue-reports).
***
## Webbwidgetar
**Webbwidgeten** ger besökare på din webbplats ett mikrofonbaserat samtal
med en agent — inget telefonnummer behövs. Den autentiserar med en
**publicerbar nyckel** (`pk_live_...`) som är ursprungslåst till dina
tillåtna domäner, så den är säker att använda i klientkod.
Nycklar körs i ett av två lägen: `agent` (statiskt kopplad till en agent)
eller `webhook` (din server väljer konfiguration per besökare — se
[Dynamisk konfiguration per samtal](/sv/guides/dynamic-call-config)). Widget-
sessioner går via samma samtalsinfrastruktur som telefonsamtal.
**I instrumentpanelen:** **Webbwidgetar** (`/dashboard/web-widgets`) —
skapa widgetar, ange läge och agent, hantera tillåtna domäner och
kopiera inbäddningskodsnutten. Se
[Skapa en webbwidget](/sv/guides/embed-a-web-widget-dashboard).
**I API:et:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) och
[Widget SDK-dokumentationen](/sv/widget/overview).
***
## Kunskapsbaser
En **kunskapsbas** är en uppsättning dokument som din agent kan söka i
mitt under ett samtal för att förankra sina svar — ladda upp filer direkt eller importera från
Google Drive och koppla sedan kunskapsbasen till en agent i
byggaren. Agenten frågar den med ett inbyggt sökverktyg när
samtalet kräver det.
**I instrumentpanelen:** **Kunskap** (`/dashboard/knowledge`) för
dokumentbiblioteket; byggarens avsnitt **Kunskap** för att koppla en till
en agent. Se
[Ge din agent en kunskapsbas](/sv/guides/knowledge-base).
***
## Anslutningar
Anslutningar är hur agenter når omvärlden. Fyra typer, en
sidofältsgrupp:
* **Appar** (`/dashboard/app-connections`) — OAuth-anslutningar till
Slack, HubSpot, Salesforce, Google Calendar, Google Sheets och
Cal.com. Anslut en gång och aktivera sedan verktyg per åtgärd (skicka ett
Slack-meddelande, uppdatera eller skapa en HubSpot-kontakt, boka en Cal.com-tid…) för
valfri agent. Se [Anslut appar](/sv/guides/connect-apps).
* **API:er** (`/dashboard/api-connections`) — gör valfritt HTTP-API till en
agentåtgärd. Klistra in ett cURL-kommando så skapar AI-guiden ett utkast till
verktygsdefinitionen, eller bygg den manuellt; knappen **Testa begäran** skickar ett
sandlådeanrop innan du lanserar. Se
[API-anslutningar](/sv/guides/api-connections) — dashboardvyn för
[`/v1/integrations`](/api-reference/integrations).
* **MCP** (`/dashboard/mcp-connections`) — lägg till en Model Context
Protocol-server via URL och låt agenten använda verktygen som den exponerar.
Se [Lägg till en MCP-server](/sv/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — leverantörsuppgifter för att
[använda dina egna telefonnummer](#phone-numbers). Se
[Anslut en VoIP-leverantör](/sv/guides/voip-providers).
**I API:et:** [`/v1/integrations`](/api-reference/integrations) och
[`/v1/voip-connections`](/api-reference/voip-connections); se även
[Bygg en verktygsintegration](/sv/guides/build-tool-integration).
***
## Kampanjer
En **kampanj** genomför utgående samtal i stor skala: ladda upp en CSV-fil med
kontakter, välj agent och utgående nummer och ange samtalsfönster
(dagar och timmar, med hänsyn till tidszon), samtidighet och återuppringningspolicy
(maximalt antal försök och vilka utfall — inget svar, röstbrevlåda, misslyckat — som
ska försökas igen). Kampanjen arbetar sig igenom listan och registrerar varje samtal
i Samtalshistorik.
**I dashboarden:** **Kampanjer** (`/dashboard/campaigns`). Se
[Kör en kampanj för utgående samtal](/sv/guides/outbound-campaigns).
**För enstaka programmatiska samtal:**
[API:et för utgående samtal](/sv/guides/place-outbound-calls).
***
## Liveövervakning
**Live** visar alla pågående samtal i organisationen och låter dig
öppna valfritt samtal för att [lyssna med och viska](#calls) i realtid. Det är
övervakningsytan: se en ny prompt ta emot sin första riktiga trafik eller
håll koll på en pågående kampanj.
**I dashboarden:** **Live** (`/dashboard/live`). Se
[Övervaka och följ livesamtal](/sv/guides/monitor-live-calls).
***
## Simuleringar
En **simulering** är en AI-uppringare som har ett verkligt samtal med din
agent — samma telefoniväg, verklig transkription, verklig bedömning — så att du
kan testa före (och efter) lansering. Rikta den mot en agent eller ett telefonnummer,
skriv uppringarscenariot själv eller **generera scenarier med AI** från agentens
prompt (inklusive kantfall om du ber om det) och följ samtalet live.
Scenarier grupperas i **sviter** som låser en lägsta godkänd frekvens och kan
styra releaser i CI; regressioner jämfört med den godkända baslinjen rapporteras
per scenario.
**I dashboarden:** **Simuleringar** (`/dashboard/simulations`), samt
knappen **Simulering** i agentbyggaren. Se
[Simulera ett samtal](/sv/guides/simulate-a-call).
**I API:et:** [`/v1/test-calls`](/api-reference/test-calls) och
svitköraren — se [Testa en agent från början till slut](/sv/guides/test-agents).
***
## Experiment
Ett **experiment** A/B-testar agentkonfigurationer på live-trafik:
definiera varianter (olika prompter, motorer eller inställningar), fördela
trafiken mellan dem och jämför utfall per variant. Använd det i stället för att
bygga egen bucketlogik i en webhook.
**I dashboarden:** **Experiment** (`/dashboard/experiments`) och
fliken **A/B** i agentbyggaren. Se
[Experiment (A/B-testning)](/sv/guides/experiments-ab-testing).
## Problem
Ett **problem** är ett flaggat problem i ett specifikt samtal — rapporterat av en
mänsklig granskare eller upptäckt av AI-bedömning. Problem har allvarlighetsgrad,
källa och status, och sidan Problem är triagekön: filtrera,
granska samtalet där problemet uppstod och följ upp åtgärder.
**I instrumentpanelen:** **Problem** (`/dashboard/issues`), samt flaggning per samtal
i Samtalshistorik. Se [Problemtriage](/sv/guides/issues).
**I API:et:** [`/v1/issue-reports`](/api-reference/issue-reports).
***
## Rapporter
En **rapport** besvarar en fråga på naturligt språk om dina samtalsdata
("Vilka var de tre vanligaste anledningarna till att uppringare bad om en människa
förra veckan?") med en AI-skriven analys, avgränsad till de agenter och det datumintervall
du väljer.
**I instrumentpanelen:** **Rapporter** (`/dashboard/reports`). Se
[Rapporter](/sv/guides/reports).
***
## Övervakning
**Övervakning** är vyn för mätvärden: samtalsvolym, utfall och
kvalitet över tid, filtrerbart efter agent och tidsfönster, med export
för vidare analys.
**I instrumentpanelen:** **Övervakning** (`/dashboard/observability`).
Se [Övervakning](/sv/guides/observability).
***
## Aviseringar
En **aviseringsregel** övervakar ett mätvärde (framgångsgrad, felfrekvens,
genomsnittligt poäng, samtalsvolym, svitregressioner) under ett tidsfönster och
utlöses när det passerar ditt tröskelvärde. Aviseringar skickas till e-post och
Slack och utlöser en `alert.triggered`-händelse till dina
[webhook-slutpunkter](/sv/webhooks/endpoints).
**I instrumentpanelen:** **Organisation → Aviseringar**. Se
[Aviseringar](/sv/guides/alerts).
***
## Webhooks
ThunderPhone skickar **HTTP POST-webhooks** till din server när saker
händer under och efter ett samtal. Två leveransmodeller:
* **Webhook-slutpunkter** (rekommenderas): hantera många URL:er på
[`/v1/developer/webhook-endpoints`](/sv/webhooks/endpoints) med
hemligheter per slutpunkt och händelseprenumerationer per slutpunkt.
* **Äldre webhook med en URL**: en URL per organisation. Hanteras på
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
eller under **Organisation → Allmänt**. Behålls för bakåtkompatibilitet.
Händelser delas in i två klasser:
* **Blockerande händelser** förväntar sig att din server svarar med konfiguration
som styr det pågående samtalet — [inkommande samtalshändelser](/sv/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Du har upp till 10 sekunder
på dig att svara; vid tidsgräns hanterar den statiskt tilldelade agenten
samtalet.
* **Icke-blockerande händelser** är skicka-och-glöm-aviseringar, som försöks igen
med exponentiell backoff — se
[leveranssemantik](/sv/webhooks/overview).
Varje begäran innehåller en HMAC-SHA256-signatur i
`X-ThunderPhone-Signature`. Se
[Signaturverifiering](/sv/webhooks/overview).
***
## Funktionsverktyg
Ett **funktionsverktyg** är en HTTP-slutpunkt som din agent kan anropa
mitt i ett samtal. Du ger ThunderPhone ett funktionsschema i OpenAI-stil
plus en slutpunkts-URL; agenten avgör när den ska anropas, och
ThunderPhone gör den signerade HTTP-begäran från sina servrar och skickar
resultatet tillbaka till agenten.
Agenter har också **inbyggda samtalsfunktioner** — överföra samtalet,
skicka knappsatsinmatning (DTMF), avsluta samtalet, vänta i kö — som
du aktiverar med vanliga promptrader i stället för verktygsdefinitioner.
**I instrumentpanelen:** avsnittet **API-anslutningar** i byggaren (se
[Anslutningar](#connections)).
**I API:et:** [`/v1/integrations`](/api-reference/integrations) och
specifikationen för [Funktionsverktyg](/sv/tools/overview).
***
## Team och roller
Varje organisation har en medlemslista med två roller: **Medlemmar** bygger
och driver agenter; **Administratörer** hanterar även teamet och fakturering.
Bjud in via e-post — inbjudningar upphör efter 7 dagar och kan återkallas;
menyn ⋯ på en medlemsrad ändrar roller eller tar bort någon. Enkel inloggning
kan konfigureras för hela organisationen — se [SSO](/sv/guides/sso).
**I instrumentpanelen:** **Organisation → Allmänt**. Se
[Bjud in ditt team](/sv/guides/invite-your-team).
**I API:et:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
***
## Fakturering
ThunderPhone är **förbetalt**. Varje organisation har ett saldo i USD; samtal debiterar det enligt röstagentens minutpris (motornivå plus tilläggsavgifter —
byggaren visar totalpriset i realtid när du ändrar inställningar, och
[premiumspråk](/sv/guides/supported-languages) lägger till 2 ¢/min). När
saldot når noll avvisas inkommande samtal och utgående samtal returnerar
`402 Payment Required`.
Fyll på manuellt, eller aktivera **automatisk påfyllning** med en
saldogräns, ett påfyllningsbelopp och en valfri månatlig utgiftsgräns —
så att ett samtal aldrig bryts mitt i en mening.
**I dashboarden:** **Organisation → Faktureringsinställningar** och
**Faktureringshistorik**. Se
[Fyll på saldo och aktivera automatisk påfyllning](/sv/guides/billing-and-topups).
**I API:t:** [`/v1/billing`](/api-reference/billing).
***
## Copiloten i appen
Dashboarden har en inbyggd **copilot** — fråga den "hur gör jag X"
så svarar den utifrån den här dokumentationen, erbjuder klick-för-klick-rundturer
som lyfter fram de faktiska reglagen och kan spela upp valfria av de
guidade rundturerna igen. Det är det snabbaste sättet att hitta ett reglage
som den här sidan nämner. Se [Fråga copiloten i appen](/sv/guides/ask-the-copilot).
***
## Så hänger allt ihop
Femstegsguiden: röstagent → fakturering → nummer → simulering → granskning.
Samma första samtal med fyra REST-anrop.
Skapa en röstagent, fyll på saldo, skaffa ett nummer, simulera och granska samtal.
OAuth-appar, anpassade API:er, MCP-servrar och VoIP-leverantörer.
Rapporter, observerbarhet, experiment, problem och aviseringar.
Inbjudningar och roller, API-nycklar, säkerhet och SSO.
API-recepten: inkommande, utgående, dynamisk konfiguration, verktyg, testning.
Gör HMAC-kontrollen rätt en gång och återanvänd den överallt.