Grundläggande koncept

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:

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.

I API:t: /v1/orgs, /v1/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.
• Kopplade funktioner: anslutna appar, API-anslutningar, kunskapsbaser, MCP-servrar och infogade funktionsverktyg.
• 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.

I API:t: /v1/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.

I API:t: /v1/voices, röstexempel och anpassade röster.

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, $1/månad plus en avgift på 1 cent/minut. 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. 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.

I API:t: /v1/phone-numbers, /v1/voip-connections, /v1/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.

I API:t: /v1/calls — lista, transkribering, historik, ljud, utvärdering, export; /v1/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.

I API:t: /v1/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). 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.

I API:t: /v1/publishable-key, /v1/mic-session och Widget SDK-dokumentationen.

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.

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.
• 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 — instrumentpanelsgränssnittet för /v1/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.
• VoIP (/dashboard/voip-connections) — leverantörsuppgifter för att använda egna telefonnummer. Se Anslut en VoIP-leverantör.

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.

I API:t: /v1/integrations, /v1/mcp-servers och /v1/voip-connections; se även Bygg en verktygsintegration.

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.

För enstaka programstyrda samtal: API:t för utgående samtal.

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 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.

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.

I API:t: /v1/test-calls och svitköraren — se Testa en agent från början till slut.

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.

I API:t: /v1/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).

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.

I API:t: /v1/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.

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.

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.

I dashboarden: Organisation → Aviseringar. Se Aviseringar.

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 med hemligheter per slutpunkt och händelseprenumerationer per slutpunkt.
• Äldre webhook med en URL: en URL per organisation. Hanteras på /v1/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 (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.

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.

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).

I API:et: /v1/integrations och specifikationen för funktionsverktyg.

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.

I dashboarden: Organisation → Allmänt. Se Bjud in ditt team.

I API:et: /v1/members, /v1/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 lägger till 3 ¢/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 avbryts mitt i en mening.

I dashboarden: Organisation → Faktureringsinställningar och Faktureringshistorik. Se Lägg till pengar och aktivera automatisk påfyllning, samt den fullständiga prisreferensen.

I API:et: /v1/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.

Sätt ihop allt#