--- title: "Grundläggande koncept" description: "En karta över allt i plattformen — vad varje objekt gör, var det finns i instrumentpanelen och vilket API som hanterar 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 instrumentpanelen och API:et som stödjer det. Ögna igenom den en gång och kom sedan tillbaka när ett begrepp behöver förklaras. Sidofältet i instrumentpanelen speglar den här strukturen: [Agenter](#agents), [röster](#voices), [telefonnummer](#phone-numbers), [webbwidgetar](#web-widgets), [samtal](#calls), [kundportaler](#client-portals), [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), [valideringsuppsättningar](#validation-sets), [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 enheten för multitenans. Varje annan resurs — agenter, telefonnummer, samtal, nycklar — tillhör exakt en organisation. Ditt konto kan vara medlem i många organisationer; var och en har eget saldo, egna nycklar och en egen medlemslista. API-nyckeln `sk_live_` som du skapar under **Organisation → Nycklar** är kopplad till en organisation. Den kopplingen är det som gör REST API:t så platt: du lägger aldrig ett organisations-id i URL-sökvägar, eftersom din nyckel redan identifierar organisationen. **I instrumentpanelen:** organisationsväxlaren (längst ned i sidofältet) och inställningarna för **Organisation** — flikar för Mitt konto, Allmänt, Nycklar, Aviseringar, Faktureringsinställningar och Faktureringshistorik. Se [referensen för organisationsinställningar](/sv/guides/organization-settings). **I API:t:** [`/v1/orgs`](/api-reference/organizations), [`/v1/developer/api-keys`](/api-reference/developer-api-keys). --- ## Agenter En **agent** är AI-konfigurationen som kör ett samtal. Den innehåller: - En **prompt** som styr vad agenten säger och hur den beter sig — inklusive samtalsåtgärder som överföringar, knapptryckningar 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). - Kopplade funktioner: [anslutna appar](#connections), [API-anslutningar](#connections), [kunskapsbaser](#knowledge-bases), [MCP-servrar](#connections) och infogade [funktionsverktyg](#function-tools). - Beteendeinställningar: talordning, bekräftelseläge, bakgrundsspår, tidsgräns för vänteläge. Ändringar i byggaren **sparas automatiskt som ett utkast**; inget publiceras förrän du klickar på **Distribuera**. Varje distribution sparas som en ögonblicksbild på byggarens flik **Historik**, så att du kan granska och återställa tidigare versioner. **I instrumentpanelen:** **Röstagenter** → agentbyggaren (`/dashboard/agents`). Se [Bygg din första röstagent](/sv/guides/build-an-agent). **I API:t:** [`/v1/agents`](/api-reference/agents) — CRUD, duplicering, överföring, versionshistorik och prompthjälpare. --- ## Röster **Röstbiblioteket** innehåller de röster som en agent kan använda, deras uppspelningsbara exempel, kompatibla språk, grupperingar efter kön och accent samt eventuella pristillägg för premiumröster och -språk. Med en betald provfunktion kan du syntetisera en egen fras på 1–500 tecken innan du väljer. Berättigade organisationer kan också skapa **anpassade röster** från ett kort WAV- eller MP3-exempel. Anpassade röster har en kvot och en asynkron skapandestatus; när de är klara visas de i samma agentväljare som biblioteksröster. **I instrumentpanelen:** **Röster** (`/dashboard/voices`). Se [Röstbibliotek och anpassade röster](/sv/guides/voice-library). **I API:t:** [`/v1/voices`](/api-reference/voices), [röstexempel](/api-reference/voice-samples) och [anpassade röster](/api-reference/custom-voices). --- ## 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: - **ThunderPhone-nummer** — riktiga amerikanska nummer som tillhandahålls från ThunderPhones pool och är aktiva på några sekunder, {/* rate:phone */}$1/månad plus en avgift på 1 cent/minut{/* /rate */}. De börjar som endast inkommande. En organisationsadministratör kan begära utgående samtal från sidan Telefonnumren; ThunderPhone granskar varje begäran manuellt, och godkända nummer kan ringa samtal och köra kampanjer. En organisation kan som standard ha 25 nummer. - **VoIP-nummer** — tas med från din egen leverantör via en [VoIP-anslutning](#connections). Twilio och Telnyx ansluts direkt med en API-nyckel (Telnyx har även en guidad konfigurering för nya konton); SignalWire, Vonage, Plivo och andra SIP-trunkar ansluts via SIP- konfigurering, en manuell SIP-konfiguration. När de har importerats och verifierats stöder VoIP-nummer 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:t:** [`/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 den fullständiga transkriberingen med rolltaggar, den strukturerade turhistoriken (inklusive verktygsanrop), en inspelning, faktureringstotalen samt valfria AI-utvärderingar och problemrapporter. Medan ett samtal är **live** kan du öppna det och **medlyssna** — du ansluter tyst och ingen i samtalet hör dig. När du lyssnar 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 i realtid. **I instrumentpanelen:** **Samtalshistorik** (`/dashboard/call-history`) för arkivet och samtalsdetaljer; **Live** för pågående samtal. Se [Granska, lyssna på och vägled dina samtal](/sv/guides/review-calls). **I API:t:** [`/v1/calls`](/api-reference/calls) — lista, transkribering, historik, ljud, utvärdering, export; [`/v1/issue-reports`](/api-reference/issue-reports). --- ## Kundportaler En **kundportal** är en varumärkesanpassad, skrivskyddad vy av samtalshistoriken för en extern kund. Organisationsadministratörer väljer de agenter vars samtal visas, lägger till godkända visningsmejladresser, laddar upp en logotyp och en accentfärg samt kan valfritt verifiera en anpassad domän. Portalvisare kan granska samtalsdetaljer, transkriberingar och tillgängliga inspelningar utan att få åtkomst till instrumentpanelen. **I instrumentpanelen:** **Kundportaler** (`/dashboard/client-portals`). Se [Kundportaler](/sv/guides/client-portals). **I API:t:** [`/v1/client-portals`](/api-reference/client-portals) för administratörsgränssnittet. ## Webbwidgetar **Webbwidgeten** ger dina webbplatsbesökare ett mikrofonsamtal med en röstagent — inget telefonnummer behövs. Den autentiserar med en **publicerbar nyckel** (`pk_live_...`) som webbläsare endast kan använda från dina tillåtna domäner, så den är säker att använda i klientkod. Domänlistan är inte autentisering, och de sessionsinställningar som en sida kan skicka är avstängda tills du tillåter dem för nyckeln. 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)). Widgets- sessioner går via samma samtalsinfrastruktur som telefonsamtal. **I instrumentpanelen:** **Webbwidgetar** (`/dashboard/web-widgets`) — skapa widgetar, ställ in läge och agent, hantera tillåtna domäner och kopiera inbäddningskoden. Se [Skapa en webbwidget](/sv/guides/embed-a-web-widget-dashboard). **I API:t:** [`/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 under ett samtal för att förankra sina svar — ladda upp filer, klistra in text eller importera webbsidor via URL 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 (publicera 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`) — omvandla 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** gör ett sandlådeanrop innan du lanserar. Se [API-anslutningar](/sv/guides/api-connections) — instrumentpanelsgränssnittet 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 egna telefonnummer](#phone-numbers). Se [Anslut en VoIP-leverantör](/sv/guides/voip-providers). ThunderPhone exponerar även en egen MCP-slutpunkt så att en extern MCP-klient kan lista agenter, granska samtal och transkriptioner samt ringa samtal. Se [Använd ThunderPhone som en MCP-server](/sv/guides/thunderphone-mcp-server). **I API:t:** [`/v1/integrations`](/api-reference/integrations), [`/v1/mcp-servers`](/api-reference/mcp-servers) och [`/v1/voip-connections`](/api-reference/voip-connections); se även [Bygg en verktygsintegration](/sv/guides/build-tool-integration). --- ## Kampanjer En **kampanj** ringer utgående samtal i stor skala: ladda upp en CSV-fil med kontakter, välj agent och uppringningsnummer 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öka igen). Kampanjen arbetar sig igenom listan och registrerar varje samtal i Samtalshistorik. **I instrumentpanelen:** **Kampanjer** (`/dashboard/campaigns`). Se [Kör en kampanj för utgående samtal](/sv/guides/outbound-campaigns). **För enstaka programstyrda samtal:** [API:t för utgående samtal](/sv/guides/place-outbound-calls). ## Liveövervakning **Live** visar varje pågående samtal i organisationen och låter dig öppna vilket som helst av dem för att [lyssna med och viska](#calls) i realtid. Det är ytan för övervakning: se en ny prompt få sin första riktiga trafik eller håll ett öga på en pågående kampanj. **I dashboarden:** **Live** (`/dashboard/live`). Se [Övervaka live-samtal](/sv/guides/monitor-live-calls). --- ## Simuleringar En **simulering** är en AI-uppringare som har ett riktigt samtal med din agent — samma telefoniväg, riktig transkription, riktig bedömning — så att du kan testa före (och efter) du lanserar. Rikta den mot en agent eller ett telefonnummer, skriv uppringarscenariot själv eller **generera scenarier med AI** från agentens prompt (inklusive specialfall om du ber om det) och följ samtalet live. Scenarier grupperas i **sviter** som anger 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:t:** [`/v1/test-calls`](/api-reference/test-calls) och svitköraren — se [Testa en agent från början till slut](/sv/guides/test-agents). --- ## Valideringsuppsättningar En **valideringsuppsättning** omvandlar ögonblick från riktiga samtal till upprepbara regressionskontroller med en tur. Varje exempel fryser samtalskontexten, relevant uppringarljud, det ursprungliga svaret och det förväntade beteendet. Uppspelningar körs mot agentens aktuella utkast utan att ringa ett nytt samtal, och driftsättningsdialogen kan visa om den senaste körningen fortfarande matchar utkastet. **I dashboarden:** **Valideringsuppsättningar** (`/dashboard/validation`) för organisationens datamängd och fliken **Validering** i agentbyggaren för körningar. Se [Valideringsuppsättningar](/sv/guides/validation-sets). **I API:t:** [`/v1/validation-sets`](/api-reference/validation-sets) och slutpunkterna för uppspelning av agent/exempel på samma referenssida. --- ## Experiment Ett **experiment** A/B-testar agentkonfigurationer på live-trafik: definiera varianter (olika promptar, motorer eller inställningar), dela trafiken mellan dem och jämför resultat per variant. Använd det i stället för att bygga egen bucket-logik 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 genom AI-bedömning. Problem har allvarlighetsgrad, källa och status, och sidan Problem är triagekön: filtrera, granska det berörda samtalet och följ upp åtgärder. **I dashboarden:** **Problem** (`/dashboard/issues`), samt flaggning per samtal i Samtalshistorik. Se [Problemtriage](/sv/guides/issues). **I API:t:** [`/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 dashboarden:** **Rapporter** (`/dashboard/reports`). Se [Rapporter](/sv/guides/reports). --- ## Observerbarhet **Observerbarhet** är ytan för mätvärden: samtalsvolym, utfall och kvalitet över tid, filtrerbart efter agent och tidsfönster, med export för vidare analys. **I dashboarden:** **Observerbarhet** (`/dashboard/observability`). Se [Observerbarhet](/sv/guides/observability). --- ## Aviseringar En **aviseringsregel** övervakar ett mätvärde (framgångsgrad, felfrekvens, genomsnittligt resultat, samtalsvolym, svitregressioner) under ett tidsfönster och utlöses när det passerar ditt tröskelvärde. Aviseringar skickas via e-post och Slack och utlöser en `alert.triggered`-händelse till dina [webhook-slutpunkter](/sv/webhooks/endpoints). **I dashboarden:** **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 — alltså [inkommande samtalshändelser](/sv/webhooks/call-incoming) (`telephony.incoming` / `web.incoming`). Ett telefonsamtal väntar upp till 13 sekunder, inklusive ett återförsök, och en widgets-session väntar 10 sekunder. Det finns ingen reservagent: utan en användbar konfiguration avslutas telefon- samtalet och widgets-sessionen misslyckas. - **Icke-blockerande händelser** är fire-and-forget-notiser som återförsöks med exponentiell backoff — se [leveranssemantik](/sv/webhooks/overview). Varje begäran innehåller en tidsstämplad HMAC-SHA256-signatur i `X-ThunderPhone-Signature-V2`, samt den äldre signaturen som endast omfattar brödtexten `X-ThunderPhone-Signature`. Se [signaturverifiering](/sv/webhooks/overview). --- ## Funktionsverktyg Ett **funktionsverktyg** är en HTTP-slutpunkt som din agent kan anropa mitt i en konversation. Du ger ThunderPhone ett funktionsschema i OpenAI-stil tillsammans med en slutpunkts-URL; agenten avgör när den ska anropas, och ThunderPhone skickar den signerade HTTP-begäran från sina servrar och skickar resultatet tillbaka till agenten. Agenter har också **inbyggda samtalsfunktioner** — att vidarekoppla samtalet, skicka knappsatsinmatning (DTMF), avsluta samtalet och vänta i kö — som du aktiverar med vanliga promptyrader i stället för verktygsdefinitioner. **I dashboarden:** byggarens avsnitt **API-anslutningar** (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 faktureringen. Bjud in via e-post — inbjudningar upphör att gälla 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 dashboarden:** **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 [utvalda ytterligare språk](/sv/guides/supported-languages) lägger till {/* rate:language */}3 ¢/min{/* /rate */}). 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 avbryts mitt i en mening. **I dashboarden:** **Organisation → Faktureringsinställningar** och **Faktureringshistorik**. Se [Lägg till pengar och aktivera automatisk påfyllning](/sv/guides/billing-and-topups), samt den [fullständiga prisreferensen](/sv/guides/pricing). **I API:et:** [`/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 stegvisa rundturer som lyfter fram de faktiska kontrollerna och kan spela upp vilken som helst av de guidade rundturerna igen. Det är det snabbaste sättet att hitta en kontroll som nämns på den här sidan. Se [Fråga copiloten i appen](/sv/guides/ask-the-copilot). --- ## Sätt ihop allt Guiden i fem steg: agent → fakturering → nummer → simulering → granskning. Samma första samtal i fyra REST-anrop. Skapa en agent, 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.