Getting Started

Grundläggande begrepp

En översikt över allt i plattformen — vad varje objekt gör, var det finns i instrumentpanelen och vilket API som berör det.

ThunderPhone är en komplett plattform för att bygga, driva och förbättra AI-röstagenter. Den här sidan är kartan: alla begrepp du möter, ett kort avsnitt för vart och ett, med gränssnittet i instrumentpanelen och API:et som ligger bakom. Skumma igenom den en gång och återvänd sedan när ett begrepp behöver förklaras.

Sidofältet i instrumentpanelen speglar denna struktur:

Organisationer#

En organisation är enheten för kontoadministration. Varje annan resurs — agenter, telefonnummer, samtal, nycklar — tillhör exakt en organisation. Ditt konto kan tillhöra många organisationer; var och en har sitt eget saldo, sina egna nycklar och sin egen medlemslista.

API-nyckeln sk_live_ som du skapar under Organisation → Nycklar är kopplad till en organisation. Den kopplingen gör REST API:et så enkelt: du behöver aldrig ange ett organisations-id i URL-sökvägar, eftersom din nyckel redan identifierar det.

I instrumentpanelen: organisationsväljaren (längst ned i sidofältet) och inställningar för Organisation — flikar för Mitt konto, Allmänt, Nycklar, Aviseringar, Faktureringsinställningar och Faktureringshistorik. Se referensen för organisationsinställningar.

I API:et: /v1/orgs, /v1/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, knapptryckningar och att lägga på, vilka ä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 vid komplexa promptar.
• 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 inbäddade 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 publicering sparas som en ögonblicksbild på fliken Historik i byggaren, 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:et: /v1/agents — CRUD, duplicering, överföring, versionshistorik och prompthjälpare.

Röster#

Röstbiblioteket innehåller rösterna som en agent kan använda, deras spelbara prover, kompatibla språk, köns- och accentgrupper samt eventuella pristillägg för premiumröster eller premiumspråk. Med en betald provlyssning 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-prov. 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östprover och anpassade röster.

Telefonnummer#

Ett telefonnummer tillhör en organisation och dirigerar inkommande samtal till en agent (och kan hantera 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 för inkommande samtal, de svarar med en kort muntlig friskrivning 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. Twilio och Telnyx ansluts direkt (Telnyx har en guidad konfigurering); SignalWire och Vonage kommer snart — i dag når du dem via manuell SIP-konfiguration, som accepterar alla SIP-trunkar. När de har importerats och verifierats har VoIP-nummer stöd för inkommande och utgående samtal.

På varje nummerrad kan du ange ett dirigeringslä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 widgetsessions blir en samtalslogg. Ett samtal innehåller den fullständiga transkriberingen med rolltaggar, den strukturerade historiken över samtalsturer (inklusive verktygsanrop), en inspelning, faktureringstotalen samt valfri AI-bedömning och problemrapporter.

Medan ett samtal är live 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 detaljer per samtal; Live för pågående samtal. Se Granska, lyssna på och coacha dina samtal.

I API:t: /v1/calls — lista, transkribering, historik, ljud, bedömning, export; /v1/issue-reports.

Kundportaler#

En kundportal är en varumärkesanpassad, skrivskyddad vy över samtalshistorik för en extern kund. Organisationsadministratörer väljer agenterna vars samtal visas, lägger till godkända e-postadresser för visningsbehöriga, laddar upp en logotyp och accentfärg samt verifierar valfritt en anpassad domän. Portalanvändare 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örshanteringsgränssnittet.

Webbwidgetar#

Webbwidgeten ger dina webbplatsbesökare ett mikrofonsamtal med en röstagent — inget telefonnummer behövs. Den autentiseras med en publicerbar nyckel (pk_live_...) som är ursprungsbegränsad 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 röstagent) 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 kontrollpanelen: Webbwidgetar (/dashboard/web-widgets) — skapa widgetar, ange läge och röstagent, hantera tillåtna domäner och kopiera inbäddningskoden. Se Skapa en webbwidget.

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

Kunskapsbaser#

En kunskapsbas är en uppsättning dokument som din röstagent 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 röstagent i byggaren. Röstagenten frågar den med ett inbyggt sökverktyg när samtalet kräver det.

I kontrollpanelen: Kunskap (/dashboard/knowledge) för dokumentbiblioteket; avsnittet Kunskap i byggaren för att koppla en till en röstagent. Se Ge din röstagent en kunskapsbas.

Anslutningar#

Anslutningar är hur röstagenter når omvärlden. Fyra typer, en sidofältsgrupp:

• Appar (/dashboard/app-connections) — OAuth-anslutningar till Slack, HubSpot, Salesforce, Google Kalender, Google Kalkylark 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 röstagent. Se Anslut appar.
• API:er (/dashboard/api-connections) — förvandla valfritt HTTP-API till en röstagentåtgärd. Klistra in ett cURL-kommando så utformar AI-guiden verktygsdefinitionen, eller bygg den manuellt; knappen Testa begäran skickar ett sandlådeanrop innan du driftsätter. Se API-anslutningar — kontrollpanelens gränssnitt för /v1/integrations.
• MCP (/dashboard/mcp-connections) — lägg till en Model Context Protocol-server via URL och låt röstagenten använda verktygen den exponerar. Se Lägg till en MCP-server.
• VoIP (/dashboard/voip-connections) — leverantörsuppgifter för att använda dina egna telefonnummer. Se Anslut en VoIP-leverantör.

ThunderPhone exponerar även sin egen MCP-slutpunkt så att en extern MCP-klient kan lista röstagenter, 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 med kontakter, välj röstagent och avsändarnummer och ange samtalsfönster (dagar och timmar, med tidszonsstöd), samtidighet och återuppringningspolicy (maximalt antal försök och vilka utfall — inget svar, röstbrevlåda, misslyckat — som ska försöka igen). Kampanjen går igenom listan och registrerar varje samtal i Samtalshistorik.

I kontrollpanelen: Kampanjer (/dashboard/campaigns). Se Kör en kampanj för utgående samtal.

För enstaka programmatiska 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 för att lyssna med och viska i realtid. Det är ytan för övervakning: följ när en ny prompt får sin första riktiga trafik, eller håll koll på en pågående kampanj.

I dashboarden: Live (/dashboard/live). Se Övervaka och hantera livesamtal.

Simuleringar#

En simulering är en AI-uppringare som har ett riktigt samtal med din agent — samma telefoniväg, riktig transkribering, riktig bedömning — så att du kan testa innan (och efter) du driftsätter. 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 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 verkliga samtalsögonblick till upprepningsbara regressionstester med en tur. Varje exempel låser samtalskontext, relevant uppringarljud, det ursprungliga svaret och det förväntade beteendet. Uppspelningar körs mot det aktuella agentutkastet utan att ringa ett nytt samtal, och driftsättningsdialogen kan visa om den senaste körningen fortfarande matchar det utkastet.

I dashboarden: Valideringsuppsättningar (/dashboard/validation) för organisationens dataset och agentbyggarens flik Validering 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 prompter, motorer eller inställningar), fördela trafiken mellan dem och jämför resultat 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).

Problem#

Ett problem är ett markerat fel 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 kön för triagering: filtrera, granska det berörda samtalet och följ åtgärder.

I dashboarden: Problem (/dashboard/issues), samt markering per samtal i samtalshistoriken. Se Triagering av problem.

I API:t: /v1/issue-reports.

Rapporter#

En rapport besvarar en fråga på naturligt språk om dina samtalsdata ("Vilka var de tre främsta 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 bevakar ett mätvärde (framgångsfrekvens, felfrekvens, genomsnittlig poäng, 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 händelsen alert.triggered till dina webhookslutpunkter.

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 formar det pågående samtalet — händelserna för inkommande samtal (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 brand-och-glöm-notiser som försöks igen med exponentiell backoff — se leveranssemantik.

Varje begäran innehåller en HMAC-SHA256-signatur i X-ThunderPhone-Signature. Se signaturverifiering.

Funktionsverktyg#

Ett funktionsverktyg är en HTTP-slutpunkt som din agent kan anropa mitt i ett samtal. Du ger ThunderPhone ett funktionsschema i OpenAI-stil tillsammans med 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 enkla promptrader 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 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 agentens minutpris (motornivå plus tilläggsavgifter — byggaren visar det totala priset i realtid när du ändrar inställningar, och utvalda ytterligare språk lägger till 3 ¢/minut). 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 saldotröskel, 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 saldo 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 klick-för-klick-rundturer som lyfter fram de faktiska kontrollerna och kan spela upp någon 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.

Knyt ihop det#